/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar
0.64.311 by John Arbash Meinel
Quick typo fix from Martin Ueding
1
# Copyright (C) 2008-2011 Canonical Ltd
0.64.1 by Ian Clatworthy
1st cut: gfi parser + --info processing method
2
#
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.
7
#
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.
12
#
13
# You should have received a copy of the GNU General Public License
0.64.334 by Jelmer Vernooij
Remove old FSF address. Thanks Dan Callaghan.
14
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
0.64.1 by Ian Clatworthy
1st cut: gfi parser + --info processing method
15
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
16
r"""FastImport Plugin
17
=================
18
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
19
The fastimport plugin provides stream-based importing and exporting of
20
data into and out of Bazaar. As well as enabling interchange between
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
21
multiple VCS tools, fastimport/export can be useful for complex branch
0.77.1 by Ian Clatworthy
initial cut at fast-import-filter
22
operations, e.g. partitioning off part of a code base in order to Open
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
23
Source it.
24
25
The normal import recipe is::
26
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
27
  bzr fast-export-from-xxx SOURCE project.fi
0.95.2 by Ian Clatworthy
update help
28
  bzr fast-import project.fi project.bzr
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
29
30
If fast-export-from-xxx doesn't exist yet for the tool you're importing
31
from, the alternative recipe is::
32
33
  front-end > project.fi
0.64.211 by Ian Clatworthy
implicitly uncompress if a fast-import source ends in .gz
34
  bzr fast-import project.fi project.bzr
35
36
In either case, if you wish to save disk space, project.fi can be
37
compressed to gzip format after it is generated like this::
38
39
  (generate project.fi)
40
  gzip project.fi
41
  bzr fast-import project.fi.gz project.bzr
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
42
43
The list of known front-ends and their status is documented on
44
http://bazaar-vcs.org/BzrFastImport/FrontEnds. The fast-export-from-xxx
45
commands provide simplified access to these so that the majority of users
46
can generate a fast-import dump file without needing to study up on all
47
the options - and the best combination of them to use - for the front-end
48
relevant to them. In some cases, a fast-export-from-xxx wrapper will require
49
that certain dependencies are installed so it checks for these before
50
starting. A wrapper may also provide a limited set of options. See the
51
online help for the individual commands for details::
52
0.64.205 by Ian Clatworthy
added fast-export-to-cvs
53
  bzr help fast-export-from-cvs
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
54
  bzr help fast-export-from-darcs
55
  bzr help fast-export-from-hg
56
  bzr help fast-export-from-git
0.64.270 by Ian Clatworthy
Fix Monotone prefix and command name: mnt -> mtn
57
  bzr help fast-export-from-mtn
0.94.1 by Matt McClure
Adds a fast-export-from-p4 command.
58
  bzr help fast-export-from-p4
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
59
  bzr help fast-export-from-svn
60
61
Once a fast-import dump file is created, it can be imported into a
62
Bazaar repository using the fast-import command. If required, you can
63
manipulate the stream first using the fast-import-filter command.
64
This is useful for creating a repository with just part of a project
65
or for removing large old binaries (say) from history that are no longer
66
valuable to retain. For further details on importing, manipulating and
67
reporting on fast-import streams, see the online help for the commands::
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
68
69
  bzr help fast-import
0.77.1 by Ian Clatworthy
initial cut at fast-import-filter
70
  bzr help fast-import-filter
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
71
  bzr help fast-import-info
0.64.111 by Ian Clatworthy
rename fast-import-filter to fast-import-query
72
  bzr help fast-import-query
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
73
0.93.12 by Ian Clatworthy
NEWS item and doco tweaks
74
Finally, you may wish to generate a fast-import dump file from a Bazaar
75
repository. The fast-export command is provided for that purpose.
76
0.64.81 by Ian Clatworthy
'bzr help fastimport' now provides useful help
77
To report bugs or publish enhancements, visit the bzr-fastimport project
78
page on Launchpad, https://launchpad.net/bzr-fastimport.
79
"""
0.64.1 by Ian Clatworthy
1st cut: gfi parser + --info processing method
80
0.64.306 by Jelmer Vernooij
Add info file with single version tuple.
81
from info import (
82
    bzr_plugin_version as version_info,
83
    )
0.64.126 by Ian Clatworthy
ensure version appears in bzr plugins output (Alexander Belchenko)
84
0.64.286 by Jelmer Vernooij
Move command implementations into a separate cmds module.
85
from bzrlib.commands import plugin_cmds
0.64.1 by Ian Clatworthy
1st cut: gfi parser + --info processing method
86
87
0.123.13 by Jelmer Vernooij
Check for availability of fastimport before running tests.
88
def load_fastimport():
89
    """Load the fastimport module or raise an appropriate exception."""
90
    try:
91
        import fastimport
92
    except ImportError, e:
93
        from bzrlib.errors import DependencyNotPresent
0.64.300 by Jelmer Vernooij
Clarify installation requirements for python-fastimport.
94
        raise DependencyNotPresent("fastimport",
0.130.1 by Martin Ueding
fixed typo in 'fasimport'
95
            "bzr-fastimport requires the fastimport python module")
0.123.13 by Jelmer Vernooij
Check for availability of fastimport before running tests.
96
97
0.64.1 by Ian Clatworthy
1st cut: gfi parser + --info processing method
98
def test_suite():
99
    import tests
100
    return tests.test_suite()
101
102
0.64.286 by Jelmer Vernooij
Move command implementations into a separate cmds module.
103
for name in [
104
        "fast_import",
105
        "fast_import_filter",
106
        "fast_import_info",
107
        "fast_import_query",
108
        "fast_export",
109
        "fast_export_from_cvs",
110
        "fast_export_from_darcs",
111
        "fast_export_from_hg",
112
        "fast_export_from_git",
113
        "fast_export_from_mtn",
114
        "fast_export_from_p4",
115
        "fast_export_from_svn"
116
        ]:
117
    plugin_cmds.register_lazy("cmd_%s" % name, [], "bzrlib.plugins.fastimport.cmds")