1 # Copyright (C) 2008-2011 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/>.
19 The fastimport plugin provides stream-based importing and exporting of
20 data into and out of Bazaar. As well as enabling interchange between
21 multiple VCS tools, fastimport/export can be useful for complex branch
22 operations, e.g. partitioning off part of a code base in order to Open
25 The normal import recipe is::
27 front-end > project.fi
28 bzr fast-import project.fi project.bzr
30 In either case, if you wish to save disk space, project.fi can be
31 compressed to gzip format after it is generated like this::
35 bzr fast-import project.fi.gz project.bzr
37 The list of known front-ends and their status is documented on
38 http://bazaar-vcs.org/BzrFastImport/FrontEnds.
40 Once a fast-import dump file is created, it can be imported into a
41 Bazaar repository using the fast-import command. If required, you can
42 manipulate the stream first using the fast-import-filter command.
43 This is useful for creating a repository with just part of a project
44 or for removing large old binaries (say) from history that are no longer
45 valuable to retain. For further details on importing, manipulating and
46 reporting on fast-import streams, see the online help for the commands::
49 bzr help fast-import-filter
50 bzr help fast-import-info
51 bzr help fast-import-query
53 Finally, you may wish to generate a fast-import dump file from a Bazaar
54 repository. The fast-export command is provided for that purpose.
56 To report bugs or publish enhancements, visit the bzr-fastimport project
57 page on Launchpad, https://launchpad.net/bzr-fastimport.
60 from __future__
import absolute_import
62 from bzrlib
.plugins
.fastimport
.info
import (
63 bzr_plugin_version
as version_info
,
66 from bzrlib
.commands
import plugin_cmds
69 def load_fastimport():
70 """Load the fastimport module or raise an appropriate exception."""
73 except ImportError, e
:
74 from bzrlib
.errors
import DependencyNotPresent
75 raise DependencyNotPresent("fastimport",
76 "bzr-fastimport requires the fastimport python module")
80 from bzrlib
.plugins
.fastimport
import tests
81 return tests
.test_suite()
91 plugin_cmds
.register_lazy("cmd_%s" % name
, [], "bzrlib.plugins.fastimport.cmds")