← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/generate_ids.py

  • Committer: Patch Queue Manager
  • Date: 2016-04-21 04:10:52 UTC
  • mfrom: (6616.1.1 fix-en-user-guide)
  • Revision ID: pqm@pqm.ubuntu.com-20160421041052-clcye7ns1qcl2n7w
(richard-wilbur) Ensure build of English use guide always uses English text
 even when user's locale specifies a different language. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

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