__init__.py
196 lines
| 8.2 KiB
| text/x-python
|
PythonLexer
|
r4513 | # convert.py Foreign SCM converter | ||
|
r4512 | # | ||
|
r4635 | # Copyright 2005-2007 Matt Mackall <mpm@selenic.com> | ||
|
r4512 | # | ||
|
r4513 | # This software may be used and distributed according to the terms | ||
# of the GNU General Public License, incorporated herein by reference. | ||||
|
r6666 | '''converting foreign VCS repositories to Mercurial''' | ||
|
r4512 | |||
|
r5621 | import convcmd | ||
from mercurial import commands | ||||
|
r4512 | |||
|
r5621 | # Commands definition was moved elsewhere to ease demandload job. | ||
|
r4512 | |||
|
r5281 | def convert(ui, src, dest=None, revmapfile=None, **opts): | ||
|
r4958 | """Convert a foreign SCM repository to a Mercurial one. | ||
|
r4513 | |||
Accepted source formats: | ||||
|
r5484 | - Mercurial | ||
|
r4513 | - CVS | ||
|
r5359 | - Darcs | ||
- git | ||||
- Subversion | ||||
|
r6306 | - Monotone | ||
|
r6035 | - GNU Arch | ||
|
r4513 | |||
Accepted destination formats: | ||||
- Mercurial | ||||
|
r5513 | - Subversion (history on branches is not preserved) | ||
|
r4513 | |||
|
r4760 | If no revision is given, all revisions will be converted. Otherwise, | ||
convert will only import up to the named revision (given in a format | ||||
understood by the source). | ||||
|
r4883 | If no destination directory name is specified, it defaults to the | ||
|
r4958 | basename of the source with '-hg' appended. If the destination | ||
repository doesn't exist, it will be created. | ||||
|
r4513 | |||
|
r6238 | If <REVMAP> isn't given, it will be put in a default location | ||
(<dest>/.hg/shamap by default). The <REVMAP> is a simple text | ||||
|
r4883 | file that maps each source commit ID to the destination ID for | ||
that revision, like so: | ||||
|
r4513 | <source ID> <destination ID> | ||
|
r4958 | If the file doesn't exist, it's automatically created. It's updated | ||
|
r4513 | on each commit copied, so convert-repo can be interrupted and can | ||
be run repeatedly to copy new commits. | ||||
|
r4589 | |||
The [username mapping] file is a simple text file that maps each source | ||||
commit author to a destination commit author. It is handy for source SCMs | ||||
that use unix logins to identify authors (eg: CVS). One line per author | ||||
mapping and the line format is: | ||||
srcauthor=whatever string you want | ||||
|
r5256 | |||
The filemap is a file that allows filtering and remapping of files | ||||
and directories. Comment lines start with '#'. Each line can | ||||
contain one of the following directives: | ||||
include path/to/file | ||||
exclude path/to/file | ||||
rename from/file to/file | ||||
|
r5760 | |||
|
r5256 | The 'include' directive causes a file, or all files under a | ||
|
r5484 | directory, to be included in the destination repository, and the | ||
|
r5488 | exclusion of all other files and dirs not explicitely included. | ||
|
r5484 | The 'exclude' directive causes files or directories to be omitted. | ||
The 'rename' directive renames a file or directory. To rename from a | ||||
subdirectory into the root of the repository, use '.' as the path to | ||||
rename to. | ||||
|
r5556 | |||
|
r6143 | The splicemap is a file that allows insertion of synthetic | ||
history, letting you specify the parents of a revision. This is | ||||
useful if you want to e.g. give a Subversion merge two parents, or | ||||
graft two disconnected series of history together. Each entry | ||||
contains a key, followed by a space, followed by one or two | ||||
values, separated by spaces. The key is the revision ID in the | ||||
source revision control system whose parents should be modified | ||||
(same format as a key in .hg/shamap). The values are the revision | ||||
IDs (in either the source or destination revision control system) | ||||
that should be used as the new parents for that node. | ||||
|
r6169 | Mercurial Source | ||
----------------- | ||||
--config convert.hg.saverev=True (boolean) | ||||
allow target to preserve source revision ID | ||||
|
r6885 | --config convert.hg.startrev=0 (hg revision identifier) | ||
convert start revision and its descendants | ||||
|
r6169 | |||
|
r6798 | CVS Source | ||
---------- | ||||
CVS source will use a sandbox (i.e. a checked-out copy) from CVS | ||||
to indicate the starting point of what will be converted. Direct | ||||
access to the repository files is not needed, unless of course | ||||
the repository is :local:. The conversion uses the top level | ||||
directory in the sandbox to find the CVS repository, and then uses | ||||
CVS rlog commands to find files to convert. This means that unless | ||||
a filemap is given, all files under the starting directory will be | ||||
converted, and that any directory reorganisation in the CVS | ||||
sandbox is ignored. | ||||
Because CVS does not have changesets, it is necessary to collect | ||||
individual commits to CVS and merge them into changesets. CVS source | ||||
can use the external 'cvsps' program (this is a legacy option and may | ||||
be removed in future) or use its internal changeset merging code. | ||||
External cvsps is default, and options may be passed to it by setting | ||||
--config convert.cvsps='cvsps -A -u --cvs-direct -q' | ||||
The options shown are the defaults. | ||||
Internal cvsps is selected by setting | ||||
--config convert.cvsps=builtin | ||||
and has a few more configurable options: | ||||
--config convert.cvsps.fuzz=60 (integer) | ||||
Specify the maximum time (in seconds) that is allowed between | ||||
commits with identical user and log message in a single | ||||
changeset. When very large files were checked in as part | ||||
of a changeset then the default may not be long enough. | ||||
--config convert.cvsps.mergeto='{{mergetobranch ([-\w]+)}}' | ||||
Specify a regular expression to which commit log messages are | ||||
matched. If a match occurs, then the conversion process will | ||||
insert a dummy revision merging the branch on which this log | ||||
message occurs to the branch indicated in the regex. | ||||
--config convert.cvsps.mergefrom='{{mergefrombranch ([-\w]+)}}' | ||||
Specify a regular expression to which commit log messages are | ||||
matched. If a match occurs, then the conversion process will | ||||
add the most recent revision on the branch indicated in the | ||||
regex as the second parent of the changeset. | ||||
The hgext/convert/cvsps wrapper script allows the builtin changeset | ||||
merging code to be run without doing a conversion. Its parameters and | ||||
output are similar to that of cvsps 2.1. | ||||
|
r6169 | Subversion Source | ||
----------------- | ||||
Subversion source detects classical trunk/branches/tags layouts. | ||||
By default, the supplied "svn://repo/path/" source URL is | ||||
converted as a single branch. If "svn://repo/path/trunk" exists | ||||
it replaces the default branch. If "svn://repo/path/branches" | ||||
exists, its subdirectories are listed as possible branches. If | ||||
"svn://repo/path/tags" exists, it is looked for tags referencing | ||||
converted branches. Default "trunk", "branches" and "tags" values | ||||
can be overriden with following options. Set them to paths | ||||
|
r6172 | relative to the source URL, or leave them blank to disable | ||
autodetection. | ||||
|
r6169 | |||
--config convert.svn.branches=branches (directory name) | ||||
specify the directory containing branches | ||||
--config convert.svn.tags=tags (directory name) | ||||
specify the directory containing tags | ||||
--config convert.svn.trunk=trunk (directory name) | ||||
specify the name of the trunk branch | ||||
|
r6173 | Source history can be retrieved starting at a specific revision, | ||
instead of being integrally converted. Only single branch | ||||
conversions are supported. | ||||
--config convert.svn.startrev=0 (svn revision number) | ||||
specify start Subversion revision. | ||||
|
r6169 | Mercurial Destination | ||
--------------------- | ||||
|
r5556 | |||
--config convert.hg.clonebranches=False (boolean) | ||||
|
r6169 | dispatch source branches in separate clones. | ||
|
r5556 | --config convert.hg.tagsbranch=default (branch name) | ||
|
r6169 | tag revisions branch name | ||
|
r5556 | --config convert.hg.usebranchnames=True (boolean) | ||
|
r6169 | preserve branch names | ||
|
r5556 | |||
|
r4958 | """ | ||
|
r5621 | return convcmd.convert(ui, src, dest, revmapfile, **opts) | ||
|
r4512 | |||
|
r5621 | def debugsvnlog(ui, **opts): | ||
return convcmd.debugsvnlog(ui, **opts) | ||||
|
r4512 | |||
|
r5621 | commands.norepo += " convert debugsvnlog" | ||
|
r5127 | |||
|
r4513 | cmdtable = { | ||
|
r4532 | "convert": | ||
|
r5281 | (convert, | ||
|
r4589 | [('A', 'authors', '', 'username mapping filename'), | ||
|
r5441 | ('d', 'dest-type', '', 'destination repository type'), | ||
|
r5016 | ('', 'filemap', '', 'remap file names using contents of file'), | ||
|
r4760 | ('r', 'rev', '', 'import up to target revision REV'), | ||
|
r5441 | ('s', 'source-type', '', 'source repository type'), | ||
|
r6143 | ('', 'splicemap', '', 'splice synthesized history into place'), | ||
|
r4589 | ('', 'datesort', None, 'try to sort changesets by date')], | ||
|
r6238 | 'hg convert [OPTION]... SOURCE [DEST [REVMAP]]'), | ||
|
r5138 | "debugsvnlog": | ||
|
r5127 | (debugsvnlog, | ||
[], | ||||
|
r5138 | 'hg debugsvnlog'), | ||
|
r4513 | } | ||