test-convert.t
496 lines
| 18.6 KiB
| text/troff
|
Tads3Lexer
/ tests / test-convert.t
|
r12510 | $ cat >> $HGRCPATH <<EOF | ||
> [extensions] | ||||
> convert= | ||||
> [convert] | ||||
> hg.saverev=False | ||||
> EOF | ||||
$ hg help convert | ||||
hg convert [OPTION]... SOURCE [DEST [REVMAP]] | ||||
convert a foreign SCM repository to a Mercurial one. | ||||
Accepted source formats [identifiers]: | ||||
- Mercurial [hg] | ||||
- CVS [cvs] | ||||
- Darcs [darcs] | ||||
- git [git] | ||||
- Subversion [svn] | ||||
- Monotone [mtn] | ||||
- GNU Arch [gnuarch] | ||||
- Bazaar [bzr] | ||||
- Perforce [p4] | ||||
Accepted destination formats [identifiers]: | ||||
- Mercurial [hg] | ||||
- Subversion [svn] (history on branches is not preserved) | ||||
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). | ||||
If no destination directory name is specified, it defaults to the basename | ||||
of the source with "-hg" appended. If the destination repository doesn't | ||||
exist, it will be created. | ||||
By default, all sources except Mercurial will use --branchsort. Mercurial | ||||
uses --sourcesort to preserve original revision numbers order. Sort modes | ||||
have the following effects: | ||||
--branchsort convert from parent to child revision when possible, which | ||||
|
r13011 | means branches are usually converted one after the other. | ||
It generates more compact repositories. | ||||
|
r12510 | --datesort sort revisions by date. Converted repositories have good- | ||
looking changelogs but are often an order of magnitude | ||||
larger than the same ones generated by --branchsort. | ||||
--sourcesort try to preserve source revisions order, only supported by | ||||
Mercurial sources. | ||||
|
r18819 | --closesort try to move closed revisions as close as possible to parent | ||
branches, only supported by Mercurial sources. | ||||
|
r12510 | |||
|
r12924 | If "REVMAP" isn't given, it will be put in a default location | ||
("<dest>/.hg/shamap" by default). The "REVMAP" is a simple text file that | ||||
|
r12510 | maps each source commit ID to the destination ID for that revision, like | ||
so: | ||||
<source ID> <destination ID> | ||||
If the file doesn't exist, it's automatically created. It's updated on | ||||
each commit copied, so "hg convert" can be interrupted and can be run | ||||
repeatedly to copy new commits. | ||||
The authormap 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 | ||||
|
r17424 | logins to identify authors (e.g.: CVS). One line per author mapping and | ||
the line format is: | ||||
|
r12510 | |||
source author = destination author | ||||
Empty lines and lines starting with a "#" are ignored. | ||||
The filemap is a file that allows filtering and remapping of files and | ||||
directories. Each line can contain one of the following directives: | ||||
include path/to/file-or-dir | ||||
exclude path/to/file-or-dir | ||||
rename path/to/source path/to/destination | ||||
Comment lines start with "#". A specified path matches if it equals the | ||||
full relative name of a file or one of its parent directories. The | ||||
"include" or "exclude" directive with the longest matching path applies, | ||||
so line order does not matter. | ||||
The "include" directive causes a file, or all files under a directory, to | ||||
|
r20784 | be included in the destination repository. The default if there are no | ||
"include" statements is to include everything. If there are any "include" | ||||
statements, nothing else is included. The "exclude" directive causes files | ||||
or directories to be omitted. The "rename" directive renames a file or | ||||
directory if it is converted. To rename from a subdirectory into the root | ||||
of the repository, use "." as the path to rename to. | ||||
|
r12510 | |||
|
r22300 | "--full" will make sure the converted changesets contain exactly the right | ||
files with the right content. It will make a full conversion of all files, | ||||
not just the ones that have changed. Files that already are correct will | ||||
not be changed. This can be used to apply filemap changes when converting | ||||
incrementally. This is currently only supported for Mercurial and | ||||
Subversion. | ||||
|
r12510 | 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 comma-separated values: | ||||
key parent1, parent2 | ||||
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. For | ||||
example, if you have merged "release-1.0" into "trunk", then you should | ||||
specify the revision on "trunk" as the first parent and the one on the | ||||
"release-1.0" branch as the second. | ||||
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 | ||||
where "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. No whitespace is allowed in the branch names. This | ||||
can be used to (for instance) move code in one repository from "default" | ||||
to a named branch. | ||||
Mercurial Source | ||||
|
r17267 | ################ | ||
|
r12510 | |||
|
r12922 | The Mercurial source recognizes the following configuration options, which | ||
you can set on the command line with "--config": | ||||
|
r12510 | |||
|
r12922 | convert.hg.ignoreerrors | ||
|
r15861 | ignore integrity errors when reading. Use it to fix | ||
Mercurial repositories with missing revlogs, by converting | ||||
from and to Mercurial. Default is False. | ||||
|
r12922 | convert.hg.saverev | ||
|
r15861 | store original revision ID in changeset (forces target IDs | ||
to change). It takes a boolean argument and defaults to | ||||
False. | ||||
|
r19891 | convert.hg.revs | ||
revset specifying the source revisions to convert. | ||||
|
r12510 | |||
CVS Source | ||||
|
r17267 | ########## | ||
|
r12510 | |||
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 | ||||
|
r12924 | ":local:". The conversion uses the top level directory in the sandbox to | ||
|
r12510 | 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 | ||||
reorganization in the CVS sandbox is ignored. | ||||
|
r12922 | The following options can be used with "--config": | ||
|
r12510 | |||
|
r12922 | convert.cvsps.cache | ||
|
r15861 | Set to False to disable remote log caching, for testing and | ||
debugging purposes. Default is True. | ||||
|
r12922 | convert.cvsps.fuzz | ||
|
r15861 | 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. | ||||
The default is 60. | ||||
|
r12922 | convert.cvsps.mergeto | ||
|
r15861 | 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. Default is "{{mergetobranch ([-\w]+)}}" | ||||
|
r12922 | convert.cvsps.mergefrom | ||
|
r15861 | 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. Default is | ||||
"{{mergefrombranch ([-\w]+)}}" | ||||
|
r17974 | convert.localtimezone | ||
use local time (as determined by the TZ environment | ||||
variable) for changeset date/times. The default is False | ||||
(use UTC). | ||||
|
r18321 | hooks.cvslog Specify a Python function to be called at the end of | ||
|
r15861 | gathering the CVS log. The function is passed a list with | ||
the log entries, and can modify the entries in-place, or add | ||||
or delete them. | ||||
|
r18321 | hooks.cvschangesets | ||
|
r15861 | Specify a Python function to be called after the changesets | ||
|
r17251 | are calculated from the CVS log. The function is passed a | ||
list with the changeset entries, and can modify the | ||||
|
r15861 | changesets in-place, or add or delete them. | ||
|
r12510 | |||
An additional "debugcvsps" Mercurial command 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. Please see the command help for | ||||
more details. | ||||
Subversion Source | ||||
|
r17267 | ################# | ||
|
r12510 | |||
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 overridden with following options. Set | ||||
them to paths relative to the source URL, or leave them blank to disable | ||||
auto detection. | ||||
|
r12922 | The following options can be set with "--config": | ||
|
r12510 | |||
|
r12922 | convert.svn.branches | ||
|
r15861 | specify the directory containing branches. The default is | ||
"branches". | ||||
|
r12922 | convert.svn.tags | ||
|
r15861 | specify the directory containing tags. The default is | ||
"tags". | ||||
|
r12922 | convert.svn.trunk | ||
|
r15861 | specify the name of the trunk branch. The default is | ||
"trunk". | ||||
|
r17974 | convert.localtimezone | ||
use local time (as determined by the TZ environment | ||||
variable) for changeset date/times. The default is False | ||||
(use UTC). | ||||
|
r12510 | |||
Source history can be retrieved starting at a specific revision, instead | ||||
of being integrally converted. Only single branch conversions are | ||||
supported. | ||||
|
r12922 | convert.svn.startrev | ||
|
r15861 | specify start Subversion revision number. The default is 0. | ||
|
r12510 | |||
|
r22466 | Git Source | ||
########## | ||||
The Git importer converts commits from all reachable branches (refs in | ||||
refs/heads) and remotes (refs in refs/remotes) to Mercurial. Branches are | ||||
converted to bookmarks with the same name, with the leading 'refs/heads' | ||||
stripped. Git submodules are converted to Git subrepos in Mercurial. | ||||
|
r22470 | The following options can be set with "--config": | ||
convert.git.similarity | ||||
specify how similar files modified in a commit must be to be | ||||
imported as renames or copies, as a percentage between "0" | ||||
(disabled) and "100" (files must be identical). For example, | ||||
"90" means that a delete/add pair will be imported as a | ||||
rename if more than 90% of the file hasn't changed. The | ||||
|
r22512 | default is "50". | ||
|
r22471 | convert.git.findcopiesharder | ||
while detecting copies, look at all files in the working | ||||
copy instead of just changed ones. This is very expensive | ||||
for large projects, and is only effective when | ||||
"convert.git.similarity" is greater than 0. The default is | ||||
False. | ||||
|
r22470 | |||
|
r12510 | Perforce Source | ||
|
r17267 | ############### | ||
|
r12510 | |||
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 | ||||
|
r12924 | directory, because otherwise the target may be named "...-hg". | ||
|
r12510 | |||
It is possible to limit the amount of source history to be converted by | ||||
|
r12922 | specifying an initial Perforce revision: | ||
|
r12510 | |||
|
r12922 | convert.p4.startrev | ||
|
r15861 | specify initial Perforce revision (a Perforce changelist | ||
number). | ||||
|
r12510 | |||
Mercurial Destination | ||||
|
r17267 | ##################### | ||
|
r12510 | |||
|
r25558 | The Mercurial destination will recognize Mercurial subrepositories in the | ||
destination directory, and update the .hgsubstate file automatically if | ||||
the destination subrepositories contain the <dest>/<sub>/.hg/shamap file. | ||||
Converting a repository with subrepositories requires converting a single | ||||
repository at a time, from the bottom up. | ||||
|
r12922 | The following options are supported: | ||
|
r12510 | |||
|
r12922 | convert.hg.clonebranches | ||
|
r15861 | dispatch source branches in separate clones. The default is | ||
False. | ||||
|
r12922 | convert.hg.tagsbranch | ||
|
r15861 | branch name for tag revisions, defaults to "default". | ||
|
r12922 | convert.hg.usebranchnames | ||
|
r15861 | preserve branch names. The default is True. | ||
|
r12510 | |||
options: | ||||
|
r15145 | -s --source-type TYPE source repository type | ||
-d --dest-type TYPE destination repository type | ||||
|
r19864 | -r --rev REV import up to source revision REV | ||
|
r15145 | -A --authormap FILE remap usernames using this file | ||
--filemap FILE remap file names using contents of file | ||||
|
r22300 | --full apply filemap changes by converting all files again | ||
|
r15145 | --splicemap FILE splice synthesized history into place | ||
--branchmap FILE change branch names while converting | ||||
--branchsort try to sort changesets by branches | ||||
--datesort try to sort changesets by date | ||||
--sourcesort preserve source changesets order | ||||
|
r18819 | --closesort try to reorder closed revisions | ||
|
r12510 | |||
|
r22110 | (some details hidden, use --verbose to show complete help) | ||
|
r12510 | $ hg init a | ||
$ cd a | ||||
$ echo a > a | ||||
$ hg ci -d'0 0' -Ama | ||||
adding a | ||||
$ hg cp a b | ||||
$ hg ci -d'1 0' -mb | ||||
$ hg rm a | ||||
$ hg ci -d'2 0' -mc | ||||
$ hg mv b a | ||||
$ hg ci -d'3 0' -md | ||||
$ echo a >> a | ||||
$ hg ci -d'4 0' -me | ||||
$ cd .. | ||||
$ hg convert a 2>&1 | grep -v 'subversion python bindings could not be loaded' | ||||
assuming destination a-hg | ||||
initializing destination a-hg repository | ||||
scanning source... | ||||
sorting... | ||||
converting... | ||||
4 a | ||||
3 b | ||||
2 c | ||||
1 d | ||||
0 e | ||||
$ hg --cwd a-hg pull ../a | ||||
pulling from ../a | ||||
searching for changes | ||||
no changes found | ||||
|
r16986 | conversion to existing file should fail | ||
|
r12510 | |||
|
r16986 | $ touch bogusfile | ||
|
r12510 | $ hg convert a bogusfile | ||
initializing destination bogusfile repository | ||||
abort: cannot create new bundle repository | ||||
[255] | ||||
|
r16986 | |||
|
r20008 | #if unix-permissions no-root | ||
|
r16986 | |||
conversion to dir without permissions should fail | ||||
|
r12510 | $ mkdir bogusdir | ||
$ chmod 000 bogusdir | ||||
$ hg convert a bogusdir | ||||
|
r18227 | abort: Permission denied: 'bogusdir' | ||
|
r12510 | [255] | ||
|
r16986 | user permissions should succeed | ||
|
r12510 | |||
$ chmod 700 bogusdir | ||||
$ hg convert a bogusdir | ||||
initializing destination bogusdir repository | ||||
scanning source... | ||||
sorting... | ||||
converting... | ||||
4 a | ||||
3 b | ||||
2 c | ||||
1 d | ||||
0 e | ||||
|
r16986 | #endif | ||
|
r12510 | test pre and post conversion actions | ||
$ echo 'include b' > filemap | ||||
$ hg convert --debug --filemap filemap a partialb | \ | ||||
> grep 'run hg' | ||||
run hg source pre-conversion action | ||||
run hg sink pre-conversion action | ||||
run hg sink post-conversion action | ||||
run hg source post-conversion action | ||||
converting empty dir should fail "nicely | ||||
$ mkdir emptydir | ||||
override $PATH to ensure p4 not visible; use $PYTHON in case we're | ||||
running from a devel copy, not a temp installation | ||||
$ PATH="$BINDIR" $PYTHON "$BINDIR"/hg convert emptydir | ||||
assuming destination emptydir-hg | ||||
initializing destination emptydir-hg repository | ||||
emptydir does not look like a CVS checkout | ||||
emptydir does not look like a Git repository | ||||
emptydir does not look like a Subversion repository | ||||
emptydir is not a local Mercurial repository | ||||
emptydir does not look like a darcs repository | ||||
emptydir does not look like a monotone repository | ||||
emptydir does not look like a GNU Arch repository | ||||
emptydir does not look like a Bazaar repository | ||||
cannot find required "p4" tool | ||||
abort: emptydir: missing or unsupported repository | ||||
[255] | ||||
convert with imaginary source type | ||||
$ hg convert --source-type foo a a-foo | ||||
initializing destination a-foo repository | ||||
abort: foo: invalid source repository type | ||||
[255] | ||||
convert with imaginary sink type | ||||
$ hg convert --dest-type foo a a-foo | ||||
abort: foo: invalid destination repository type | ||||
[255] | ||||
testing: convert must not produce duplicate entries in fncache | ||||
$ hg convert a b | ||||
initializing destination b repository | ||||
scanning source... | ||||
sorting... | ||||
converting... | ||||
4 a | ||||
3 b | ||||
2 c | ||||
1 d | ||||
0 e | ||||
contents of fncache file: | ||||
|
r13389 | $ cat b/.hg/store/fncache | sort | ||
|
r12510 | data/a.i | ||
data/b.i | ||||
test bogus URL | ||||
$ hg convert -q bzr+ssh://foobar@selenic.com/baz baz | ||||
abort: bzr+ssh://foobar@selenic.com/baz: missing or unsupported repository | ||||
[255] | ||||
|
r17002 | |||
test revset converted() lookup | ||||
|
r17345 | $ hg --config convert.hg.saverev=True convert a c | ||
|
r17002 | initializing destination c repository | ||
scanning source... | ||||
sorting... | ||||
converting... | ||||
4 a | ||||
3 b | ||||
2 c | ||||
1 d | ||||
0 e | ||||
$ echo f > c/f | ||||
$ hg -R c ci -d'0 0' -Amf | ||||
adding f | ||||
created new head | ||||
$ hg -R c log -r "converted(09d945a62ce6)" | ||||
changeset: 1:98c3dd46a874 | ||||
user: test | ||||
date: Thu Jan 01 00:00:01 1970 +0000 | ||||
summary: b | ||||
$ hg -R c log -r "converted()" | ||||
changeset: 0:31ed57b2037c | ||||
user: test | ||||
date: Thu Jan 01 00:00:00 1970 +0000 | ||||
summary: a | ||||
changeset: 1:98c3dd46a874 | ||||
user: test | ||||
date: Thu Jan 01 00:00:01 1970 +0000 | ||||
summary: b | ||||
changeset: 2:3b9ca06ef716 | ||||
user: test | ||||
date: Thu Jan 01 00:00:02 1970 +0000 | ||||
summary: c | ||||
changeset: 3:4e0debd37cf2 | ||||
user: test | ||||
date: Thu Jan 01 00:00:03 1970 +0000 | ||||
summary: d | ||||
changeset: 4:9de3bc9349c5 | ||||
user: test | ||||
date: Thu Jan 01 00:00:04 1970 +0000 | ||||
summary: e | ||||