__init__.py
274 lines
| 11.7 KiB
| text/x-python
|
PythonLexer
|
r4513 | # convert.py Foreign SCM converter | ||
|
r4512 | # | ||
|
r4635 | # Copyright 2005-2007 Matt Mackall <mpm@selenic.com> | ||
|
r4512 | # | ||
|
r8225 | # This software may be used and distributed according to the terms of the | ||
# GNU General Public License version 2, incorporated herein by reference. | ||||
|
r8228 | |||
|
r6666 | '''converting foreign VCS repositories to Mercurial''' | ||
|
r4512 | |||
|
r5621 | import convcmd | ||
|
r7502 | import cvsps | ||
|
r7873 | import subversion | ||
|
r5621 | from mercurial import commands | ||
|
r6999 | from mercurial.i18n import _ | ||
|
r4512 | |||
|
r5621 | # Commands definition was moved elsewhere to ease demandload job. | ||
|
r4512 | |||
|
r5281 | def convert(ui, src, dest=None, revmapfile=None, **opts): | ||
|
r7598 | """convert a foreign SCM repository to a Mercurial one. | ||
|
r4513 | |||
|
r6976 | Accepted source formats [identifiers]: | ||
- Mercurial [hg] | ||||
- CVS [cvs] | ||||
- Darcs [darcs] | ||||
- git [git] | ||||
- Subversion [svn] | ||||
- Monotone [mtn] | ||||
- GNU Arch [gnuarch] | ||||
|
r7053 | - Bazaar [bzr] | ||
|
r7823 | - Perforce [p4] | ||
|
r4513 | |||
|
r6976 | Accepted destination formats [identifiers]: | ||
- Mercurial [hg] | ||||
- Subversion [svn] (history on branches is not preserved) | ||||
|
r4513 | |||
|
r7989 | 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). | ||||
|
r4760 | |||
|
r4883 | If no destination directory name is specified, it defaults to the | ||
|
r7983 | basename of the source with '-hg' appended. If the destination | ||
|
r4958 | repository doesn't exist, it will be created. | ||
|
r4513 | |||
|
r6238 | If <REVMAP> isn't given, it will be put in a default location | ||
|
r7989 | (<dest>/.hg/shamap by default). The <REVMAP> is a simple text file | ||
that maps each source commit ID to the destination ID for that | ||||
revision, like so: | ||||
|
r4513 | <source ID> <destination ID> | ||
|
r7989 | If the file doesn't exist, it's automatically created. It's | ||
updated on each commit copied, so convert-repo can be interrupted | ||||
and can be run repeatedly to copy new commits. | ||||
|
r4589 | |||
|
r7989 | 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: | ||||
|
r4589 | srcauthor=whatever string you want | ||
|
r5256 | |||
The filemap is a file that allows filtering and remapping of files | ||||
|
r7983 | and directories. Comment lines start with '#'. Each line can | ||
|
r5256 | 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 | ||
|
r8668 | exclusion of all other files and directories not explicitly included. | ||
|
r5484 | The 'exclude' directive causes files or directories to be omitted. | ||
|
r7989 | 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 | ||
|
r7983 | history, letting you specify the parents of a revision. This is | ||
|
r6143 | useful if you want to e.g. give a Subversion merge two parents, or | ||
|
r7983 | graft two disconnected series of history together. Each entry | ||
|
r6143 | contains a key, followed by a space, followed by one or two | ||
|
r7989 | comma-separated values. 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. | ||||
|
r6143 | |||
|
r8377 | The branchmap is a file that allows you to rename a branch when it is | ||
being brought in from whatever external repository. When used in | ||||
conjunction with a splicemap, it allows for a powerful combination | ||||
to help fix even the most badly mismanaged repositories and turn them | ||||
into nicely structured Mercurial repositories. The branchmap contains | ||||
lines of the form "original_branch_name new_branch_name". | ||||
"original_branch_name" is the name of the branch in the source | ||||
repository, and "new_branch_name" is the name of the branch is the | ||||
destination repository. This can be used to (for instance) move code | ||||
in one repository from "default" to a named branch. | ||||
|
r6169 | Mercurial Source | ||
----------------- | ||||
|
r8010 | --config convert.hg.ignoreerrors=False (boolean) | ||
|
r7231 | ignore integrity errors when reading. Use it to fix Mercurial | ||
repositories with missing revlogs, by converting from and to | ||||
Mercurial. | ||||
|
r8010 | --config convert.hg.saverev=False (boolean) | ||
|
r7989 | store original revision ID in changeset (forces target IDs to | ||
change) | ||||
|
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 | ||||
|
r7989 | 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 | ||||
|
r8668 | converted, and that any directory reorganization in the CVS | ||
|
r6798 | sandbox is ignored. | ||
Because CVS does not have changesets, it is necessary to collect | ||||
|
r7101 | individual commits to CVS and merge them into changesets. CVS | ||
source uses its internal changeset merging code by default but can | ||||
be configured to call the external 'cvsps' program by setting: | ||||
|
r7170 | --config convert.cvsps='cvsps -A -u --cvs-direct -q' | ||
|
r8598 | This option is deprecated and will be removed in Mercurial 1.4. | ||
|
r7101 | |||
|
r6798 | The options shown are the defaults. | ||
Internal cvsps is selected by setting | ||||
--config convert.cvsps=builtin | ||||
and has a few more configurable options: | ||||
|
r8169 | --config convert.cvsps.cache=True (boolean) | ||
|
r8222 | Set to False to disable remote log caching, for testing and | ||
|
r8169 | debugging purposes. | ||
|
r8010 | --config convert.cvsps.fuzz=60 (integer) | ||
|
r7989 | 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. | ||||
|
r8541 | --config convert.cvsps.mergeto='{{mergetobranch ([-\\w]+)}}' | ||
|
r7989 | 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. | ||||
|
r8541 | --config convert.cvsps.mergefrom='{{mergefrombranch ([-\\w]+)}}' | ||
|
r7989 | 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. | ||||
|
r6923 | |||
|
r7989 | 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. | ||||
|
r6798 | |||
|
r6169 | Subversion Source | ||
----------------- | ||||
Subversion source detects classical trunk/branches/tags layouts. | ||||
By default, the supplied "svn://repo/path/" source URL is | ||||
|
r7989 | 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 | ||||
|
r6169 | "svn://repo/path/tags" exists, it is looked for tags referencing | ||
converted branches. Default "trunk", "branches" and "tags" values | ||||
|
r8668 | can be overridden with following options. Set them to paths | ||
relative to the source URL, or leave them blank to disable auto | ||||
detection. | ||||
|
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. | ||||
|
r7823 | Perforce Source | ||
--------------- | ||||
|
r7989 | The Perforce (P4) importer can be given a p4 depot path or a | ||
client specification as source. It will convert all files in the | ||||
source to a flat Mercurial repository, ignoring labels, branches | ||||
and integrations. Note that when a depot path is given you then | ||||
usually should specify a target directory, because otherwise the | ||||
target may be named ...-hg. | ||||
|
r7823 | |||
|
r7989 | It is possible to limit the amount of source history to be | ||
converted by specifying an initial Perforce revision. | ||||
|
r7823 | |||
|
r8010 | --config convert.p4.startrev=0 (perforce changelist number) | ||
|
r7823 | specify initial Perforce 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): | ||
|
r7873 | return subversion.debugsvnlog(ui, **opts) | ||
|
r4512 | |||
|
r7502 | def debugcvsps(ui, *args, **opts): | ||
|
r7598 | '''create changeset information from CVS | ||
|
r7502 | |||
|
r7989 | This command is intended as a debugging tool for the CVS to | ||
Mercurial converter, and can be used as a direct replacement for | ||||
cvsps. | ||||
|
r7502 | |||
|
r7989 | Hg debugcvsps reads the CVS rlog for current directory (or any | ||
named directory) in the CVS repository, and converts the log to a | ||||
series of changesets based on matching commit log entries and | ||||
dates.''' | ||||
|
r7502 | return cvsps.debugcvsps(ui, *args, **opts) | ||
commands.norepo += " convert debugsvnlog debugcvsps" | ||||
|
r5127 | |||
|
r4513 | cmdtable = { | ||
|
r4532 | "convert": | ||
|
r5281 | (convert, | ||
|
r6999 | [('A', 'authors', '', _('username mapping filename')), | ||
('d', 'dest-type', '', _('destination repository type')), | ||||
('', 'filemap', '', _('remap file names using contents of file')), | ||||
('r', 'rev', '', _('import up to target revision REV')), | ||||
('s', 'source-type', '', _('source repository type')), | ||||
('', 'splicemap', '', _('splice synthesized history into place')), | ||||
|
r8377 | ('', 'branchmap', '', _('change branch names while converting')), | ||
|
r6999 | ('', 'datesort', None, _('try to sort changesets by date'))], | ||
_('hg convert [OPTION]... SOURCE [DEST [REVMAP]]')), | ||||
|
r5138 | "debugsvnlog": | ||
|
r5127 | (debugsvnlog, | ||
[], | ||||
|
r5138 | 'hg debugsvnlog'), | ||
|
r7502 | "debugcvsps": | ||
(debugcvsps, | ||||
[ | ||||
# Main options shared with cvsps-2.1 | ||||
|
r7598 | ('b', 'branches', [], _('only return changes on specified branches')), | ||
('p', 'prefix', '', _('prefix to remove from file names')), | ||||
('r', 'revisions', [], _('only return changes after or between specified tags')), | ||||
('u', 'update-cache', None, _("update cvs log cache")), | ||||
('x', 'new-cache', None, _("create new cvs log cache")), | ||||
('z', 'fuzz', 60, _('set commit time fuzz in seconds')), | ||||
('', 'root', '', _('specify cvsroot')), | ||||
|
r7502 | # Options specific to builtin cvsps | ||
|
r7598 | ('', 'parents', '', _('show parent changesets')), | ||
('', 'ancestors', '', _('show current changeset in ancestor branches')), | ||||
|
r7502 | # Options that are ignored for compatibility with cvsps-2.1 | ||
|
r7735 | ('A', 'cvs-direct', None, _('ignored for compatibility')), | ||
|
r7502 | ], | ||
|
r7735 | _('hg debugcvsps [OPTION]... [PATH]...')), | ||
|
r4513 | } | ||