1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
# Copyright (C) 2008-2011 Canonical Ltd
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
r"""FastImport Plugin
=================
The fastimport plugin provides stream-based importing and exporting of
data into and out of Bazaar. As well as enabling interchange between
multiple VCS tools, fastimport/export can be useful for complex branch
operations, e.g. partitioning off part of a code base in order to Open
Source it.
The normal import recipe is::
bzr fast-export-from-xxx SOURCE project.fi
bzr fast-import project.fi project.bzr
If fast-export-from-xxx doesn't exist yet for the tool you're importing
from, the alternative recipe is::
front-end > project.fi
bzr fast-import project.fi project.bzr
In either case, if you wish to save disk space, project.fi can be
compressed to gzip format after it is generated like this::
(generate project.fi)
gzip project.fi
bzr fast-import project.fi.gz project.bzr
The list of known front-ends and their status is documented on
http://bazaar-vcs.org/BzrFastImport/FrontEnds. The fast-export-from-xxx
commands provide simplified access to these so that the majority of users
can generate a fast-import dump file without needing to study up on all
the options - and the best combination of them to use - for the front-end
relevant to them. In some cases, a fast-export-from-xxx wrapper will require
that certain dependencies are installed so it checks for these before
starting. A wrapper may also provide a limited set of options. See the
online help for the individual commands for details::
bzr help fast-export-from-cvs
bzr help fast-export-from-darcs
bzr help fast-export-from-hg
bzr help fast-export-from-git
bzr help fast-export-from-mtn
bzr help fast-export-from-p4
bzr help fast-export-from-svn
Once a fast-import dump file is created, it can be imported into a
Bazaar repository using the fast-import command. If required, you can
manipulate the stream first using the fast-import-filter command.
This is useful for creating a repository with just part of a project
or for removing large old binaries (say) from history that are no longer
valuable to retain. For further details on importing, manipulating and
reporting on fast-import streams, see the online help for the commands::
bzr help fast-import
bzr help fast-import-filter
bzr help fast-import-info
bzr help fast-import-query
Finally, you may wish to generate a fast-import dump file from a Bazaar
repository. The fast-export command is provided for that purpose.
To report bugs or publish enhancements, visit the bzr-fastimport project
page on Launchpad, https://launchpad.net/bzr-fastimport.
"""
from __future__ import absolute_import
from bzrlib.plugins.fastimport.info import (
bzr_plugin_version as version_info,
)
from bzrlib.commands import plugin_cmds
def load_fastimport():
"""Load the fastimport module or raise an appropriate exception."""
try:
import fastimport
except ImportError, e:
from bzrlib.errors import DependencyNotPresent
raise DependencyNotPresent("fastimport",
"bzr-fastimport requires the fastimport python module")
def test_suite():
from bzrlib.plugins.fastimport import tests
return tests.test_suite()
for name in [
"fast_import",
"fast_import_filter",
"fast_import_info",
"fast_import_query",
"fast_export",
"fast_export_from_cvs",
"fast_export_from_darcs",
"fast_export_from_hg",
"fast_export_from_git",
"fast_export_from_mtn",
"fast_export_from_p4",
"fast_export_from_svn"
]:
plugin_cmds.register_lazy("cmd_%s" % name, [], "bzrlib.plugins.fastimport.cmds")
|