1
# Copyright (C) 2008 Canonical Ltd
3
# This program is free software; you can redistribute it and/or modify
4
# it under the terms of the GNU General Public License as published by
5
# the Free Software Foundation; either version 2 of the License, or
6
# (at your option) any later version.
8
# This program is distributed in the hope that it will be useful,
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
# GNU General Public License for more details.
13
# You should have received a copy of the GNU General Public License
14
# along with this program. If not, see <http://www.gnu.org/licenses/>.
16
"""Miscellaneous useful stuff."""
18
from __future__ import absolute_import
27
def escape_commit_message(message):
28
"""Replace xml-incompatible control characters."""
29
# This really ought to be provided by breezy.
30
# Code copied from breezy.commit.
32
# Python strings can include characters that can't be
33
# represented in well-formed XML; escape characters that
34
# aren't listed in the XML specification
35
# (http://www.w3.org/TR/REC-xml/#NT-Char).
38
u'[^\x09\x0A\x0D\u0020-\uD7FF\uE000-\uFFFD]+',
39
lambda match: match.group(0).encode('unicode_escape'),
44
def best_format_for_objects_in_a_repository(repo):
45
"""Find the high-level format for branches and trees given a repository.
47
When creating branches and working trees within a repository, Bazaar
48
defaults to using the default format which may not be the best choice.
49
This routine does a reverse lookup of the high-level format registry
50
to find the high-level format that a shared repository was most likely
53
:return: the BzrDirFormat or None if no matches were found.
55
# Based on code from breezy/info.py ...
56
repo_format = repo._format
58
non_aliases = set(controldir.format_registry.keys())
59
non_aliases.difference_update(controldir.format_registry.aliases())
60
for key in non_aliases:
61
format = controldir.format_registry.make_controldir(key)
62
# LocalGitBzrDirFormat has no repository_format
63
if hasattr(format, "repository_format"):
64
if format.repository_format == repo_format:
65
candidates.append((key, format))
67
# Assume the first one. Is there any reason not to do that?
68
name, format = candidates[0]
74
def open_destination_directory(location, format=None, verbose=True):
75
"""Open a destination directory and return the BzrDir.
77
If destination has a control directory, it will be returned.
78
Otherwise, the destination should be empty or non-existent and
79
a shared repository will be created there.
81
:param location: the destination directory
82
:param format: the format to use or None for the default
83
:param verbose: display the format used if a repository is created.
84
:return: BzrDir for the destination
87
from ... import controldir, errors, trace, transport
89
control, relpath = controldir.ControlDir.open_containing(location)
90
# XXX: Check the relpath is None here?
92
except errors.NotBranchError:
95
# If the directory exists, check it is empty. Otherwise create it.
96
if os.path.exists(location):
97
contents = os.listdir(location)
99
errors.BzrCommandError("Destination must have a .bzr directory, "
100
" not yet exist or be empty - files found in %s" % (location,))
104
except IOError as ex:
105
raise errors.BzrCommandError(
106
"Unable to create %s: %s" % (location, ex))
108
# Create a repository for the nominated format.
109
trace.note("Creating destination repository ...")
111
format = controldir.format_registry.make_controldir('default')
112
to_transport = transport.get_transport(location)
113
to_transport.ensure_base()
114
control = format.initialize_on_transport(to_transport)
115
repo = control.create_repository(shared=True)
117
from ...info import show_bzrdir_info
118
show_bzrdir_info(repo.controldir, verbose=0)
122
def kind_to_mode(kind, executable):
124
if executable is True:
125
return stat.S_IFREG | 0o755
126
elif executable is False:
127
return stat.S_IFREG | 0o644
129
raise AssertionError("Executable %r invalid" % executable)
130
elif kind == "symlink":
132
elif kind == "directory":
134
elif kind == "tree-reference":
137
raise AssertionError("Unknown file kind '%s'" % kind)
140
def mode_to_kind(mode):
141
# Note: Output from git-fast-export slightly different to spec
142
if mode in (0o644, 0o100644):
144
elif mode in (0o755, 0o100755):
146
elif mode == 0o040000:
147
return 'directory', False
148
elif mode == 0o120000:
149
return 'symlink', False
150
elif mode == 0o160000:
151
return 'tree-reference', False
153
raise AssertionError("invalid mode %o" % mode)
156
def binary_stream(stream):
157
"""Ensure a stream is binary on Windows.
164
fileno = getattr(stream, 'fileno', None)
167
if no >= 0: # -1 means we're working as subprocess
169
msvcrt.setmode(no, os.O_BINARY)
175
def single_plural(n, single, plural):
176
"""Return a single or plural form of a noun based on number."""