← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/generate_ids.py

  • Committer: Robert Collins
  • Date: 2007-04-19 02:27:44 UTC
  • mto: This revision was merged to the branch mainline in revision 2426.
  • Revision ID: robertc@robertcollins.net-20070419022744-pfdqz42kp1wizh43
``make docs`` now creates a man page at ``man1/bzr.1`` fixing bug 107388.
(Robert Collins)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/generate_ids.py
1
 
# Copyright (C) 2006, 2007, 2009, 2010 Canonical Ltd
 
1
# Copyright (C) 2006 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""Common code for generating file or revision ids."""
18
18
 
32
32
    lazy_regex,
33
33
    )
34
34
 
35
 
# the regex removes any weird characters; we don't escape them
 
35
# the regex removes any weird characters; we don't escape them 
36
36
# but rather just pull them out
37
37
_file_id_chars_re = lazy_regex.lazy_compile(r'[^\w.]')
38
38
_rev_id_chars_re = lazy_regex.lazy_compile(r'[^-\w.+@]')
42
42
 
43
43
def _next_id_suffix():
44
44
    """Create a new file id suffix that is reasonably unique.
45
 
 
 
45
    
46
46
    On the first call we combine the current time with 64 bits of randomness to
47
47
    give a highly probably globally unique number. Then each call in the same
48
48
    process adds 1 to a serial number we append to that unique value.
49
49
    """
50
 
    # XXX TODO: change bzrlib.add.smart_add_tree to call workingtree.add() rather
 
50
    # XXX TODO: change bzrlib.add.smart_add to call workingtree.add() rather 
51
51
    # than having to move the id randomness out of the inner loop like this.
52
52
    # XXX TODO: for the global randomness this uses we should add the thread-id
53
53
    # before the serial #.
93
93
def gen_revision_id(username, timestamp=None):
94
94
    """Return new revision-id.
95
95
 
96
 
    :param username: The username of the committer, in the format returned by
97
 
        config.username().  This is typically a real name, followed by an
98
 
        email address. If found, we will use just the email address portion.
99
 
        Otherwise we flatten the real name, and use that.
 
96
    :param username: This is the value returned by config.username(), which is
 
97
        typically a real name, followed by an email address. If found, we will
 
98
        use just the email address portion. Otherwise we flatten the real name,
 
99
        and use that.
100
100
    :return: A new revision id.
101
101
    """
102
102
    try: