← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/generate_ids.py

  • Committer: Ian Clatworthy
  • Date: 2007-08-13 14:33:10 UTC
  • mto: (2733.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 2734.
  • Revision ID: ian.clatworthy@internode.on.net-20070813143310-twhj4la0qnupvze8
Added Quick Start Summary

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/generate_ids.py
1
 
# Copyright (C) 2006, 2007, 2009, 2010, 2011 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
 
19
19
from bzrlib.lazy_import import lazy_import
20
20
lazy_import(globals(), """
21
21
import time
 
22
import unicodedata
22
23
 
23
24
from bzrlib import (
24
25
    config,
31
32
    lazy_regex,
32
33
    )
33
34
 
34
 
# the regex removes any weird characters; we don't escape them
 
35
# the regex removes any weird characters; we don't escape them 
35
36
# but rather just pull them out
36
37
_file_id_chars_re = lazy_regex.lazy_compile(r'[^\w.]')
37
38
_rev_id_chars_re = lazy_regex.lazy_compile(r'[^-\w.+@]')
41
42
 
42
43
def _next_id_suffix():
43
44
    """Create a new file id suffix that is reasonably unique.
44
 
 
 
45
    
45
46
    On the first call we combine the current time with 64 bits of randomness to
46
47
    give a highly probably globally unique number. Then each call in the same
47
48
    process adds 1 to a serial number we append to that unique value.
48
49
    """
49
 
    # XXX TODO: change bzrlib.add.smart_add_tree to call workingtree.add() rather
 
50
    # XXX TODO: change bzrlib.add.smart_add_tree to call workingtree.add() rather 
50
51
    # than having to move the id randomness out of the inner loop like this.
51
52
    # XXX TODO: for the global randomness this uses we should add the thread-id
52
53
    # before the serial #.
92
93
def gen_revision_id(username, timestamp=None):
93
94
    """Return new revision-id.
94
95
 
95
 
    :param username: The username of the committer, in the format returned by
96
 
        config.username().  This is typically a real name, followed by an
97
 
        email address. If found, we will use just the email address portion.
98
 
        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.
99
100
    :return: A new revision id.
100
101
    """
101
102
    try: