/usr/lib/python2.7/dist-packages/cvs2svn_lib/git_run_options.py is in cvs2svn 2.4.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 | # (Be in -*- python -*- mode.)
#
# ====================================================================
# Copyright (c) 2000-2009 CollabNet. All rights reserved.
#
# This software is licensed as described in the file COPYING, which
# you should have received as part of this distribution. The terms
# are also available at http://subversion.tigris.org/license-1.html.
# If newer versions of this license are posted there, you may use a
# newer version instead, at your option.
#
# This software consists of voluntary contributions made by many
# individuals. For exact contribution history, see the revision
# history and logs, available at http://cvs2svn.tigris.org/.
# ====================================================================
"""This module manages cvs2git run options."""
from cvs2svn_lib.common import FatalError
from cvs2svn_lib.context import Ctx
from cvs2svn_lib.dvcs_common import DVCSRunOptions
from cvs2svn_lib.run_options import ContextOption
from cvs2svn_lib.run_options import IncompatibleOption
from cvs2svn_lib.run_options import not_both
from cvs2svn_lib.revision_manager import NullRevisionCollector
from cvs2svn_lib.rcs_revision_manager import RCSRevisionReader
from cvs2svn_lib.cvs_revision_manager import CVSRevisionReader
from cvs2svn_lib.git_revision_collector import GitRevisionCollector
from cvs2svn_lib.external_blob_generator import ExternalBlobGenerator
from cvs2svn_lib.output_option import NullOutputOption
from cvs2svn_lib.git_output_option import GitRevisionMarkWriter
from cvs2svn_lib.git_output_option import GitOutputOption
class GitRunOptions(DVCSRunOptions):
short_desc = 'convert a cvs repository into a git repository'
synopsis = """\
.B cvs2git
[\\fIOPTION\\fR]... \\fIOUTPUT-OPTIONS CVS-REPOS-PATH\\fR
.br
.B cvs2git
[\\fIOPTION\\fR]... \\fI--options=PATH\\fR
"""
long_desc = """\
Create a new git repository based on the version history stored in a
CVS repository. Each CVS commit will be mirrored in the git
repository, including such information as date of commit and id of the
committer.
.P
The output of this program are a "blobfile" and a "dumpfile", which
together can be loaded into a git repository using "git fast-import".
.P
\\fICVS-REPOS-PATH\\fR is the filesystem path of the part of the CVS
repository that you want to convert. This path doesn't have to be the
top level directory of a CVS repository; it can point at a project
within a repository, in which case only that project will be
converted. This path or one of its parent directories has to contain
a subdirectory called CVSROOT (though the CVSROOT directory can be
empty).
.P
It is not possible directly to convert a CVS repository to which you
only have remote access, but the FAQ describes tools that may be used
to create a local copy of a remote CVS repository.
"""
files = """\
A directory called \\fIcvs2svn-tmp\\fR (or the directory specified by
\\fB--tmpdir\\fR) is used as scratch space for temporary data files.
"""
see_also = [
('cvs', '1'),
('git', '1'),
('git-fast-import', '1'),
]
def _get_output_options_group(self):
group = super(GitRunOptions, self)._get_output_options_group()
group.add_option(IncompatibleOption(
'--blobfile', type='string',
action='store',
help='path to which the "blob" data should be written',
man_help=(
'Write the "blob" data (containing revision contents) to '
'\\fIpath\\fR.'
),
metavar='PATH',
))
group.add_option(IncompatibleOption(
'--dumpfile', type='string',
action='store',
help='path to which the revision data should be written',
man_help=(
'Write the revision data (branches and commits) to \\fIpath\\fR.'
),
metavar='PATH',
))
group.add_option(ContextOption(
'--dry-run',
action='store_true',
help=(
'do not create any output; just print what would happen.'
),
man_help=(
'Do not create any output; just print what would happen.'
),
))
return group
def _get_extraction_options_group(self):
group = super(GitRunOptions, self)._get_extraction_options_group()
self._add_use_cvs_option(group)
self._add_use_rcs_option(group)
self.parser.set_default('use_external_blob_generator', False)
group.add_option(IncompatibleOption(
'--use-external-blob-generator',
action='store_true',
help=(
'Use an external Python program to extract file revision '
'contents (much faster than --use-rcs or --use-cvs but '
'leaves keywords unexpanded and requires a separate, '
'seekable blob file to write to in parallel to the main '
'cvs2git script.'
),
man_help=(
'Use an external Python program to extract the file revision '
'contents from the RCS files and output them to the blobfile. '
'This option is much faster than \\fB--use-rcs\\fR or '
'\\fB--use-cvs\\fR but leaves keywords unexpanded and requires '
'a separate, seekable blob file to write to in parallel to the '
'main cvs2git script.'
),
))
return group
def process_extraction_options(self):
"""Process options related to extracting data from the CVS repository."""
ctx = Ctx()
options = self.options
not_both(options.use_rcs, '--use-rcs',
options.use_cvs, '--use-cvs')
not_both(options.use_external_blob_generator,
'--use-external-blob-generator',
options.use_cvs, '--use-cvs')
not_both(options.use_external_blob_generator,
'--use-external-blob-generator',
options.use_rcs, '--use-rcs')
# cvs2git never needs a revision reader:
ctx.revision_reader = None
if ctx.dry_run:
ctx.revision_collector = NullRevisionCollector()
return
if not (options.blobfile and options.dumpfile):
raise FatalError("must pass '--blobfile' and '--dumpfile' options.")
if options.use_external_blob_generator:
ctx.revision_collector = ExternalBlobGenerator(options.blobfile)
else:
if options.use_rcs:
revision_reader = RCSRevisionReader(
co_executable=options.co_executable
)
else:
# --use-cvs is the default:
revision_reader = CVSRevisionReader(
cvs_executable=options.cvs_executable
)
ctx.revision_collector = GitRevisionCollector(
options.blobfile, revision_reader,
)
def process_output_options(self):
"""Process options related to fastimport output."""
ctx = Ctx()
if ctx.dry_run:
ctx.output_option = NullOutputOption()
else:
ctx.output_option = GitOutputOption(
self.options.dumpfile,
GitRevisionMarkWriter(),
# Optional map from CVS author names to git author names:
author_transforms={}, # FIXME
)
|