GitMap: Map git commits to new commits, preserving history.
Project description
gitmap
Map git commits to new commits, preserving history.
Usage
- Install dependencies,
pip install -r requirements.txt
. (python2 is currently unsupported.) - Inherit the class
gitmap.GitMap
, and overrideblob_map
andcommit_map
. Theblob_map
function maps a source path to a destination path, etc. Thecommit_map
function maps a commit message to a new message, etc. - Call
run(src_repo_path, dst_repo_path)
. All heads will be mapped. - Set
remove_empty_commits
toTrue
if you want to remove empty commits. (A non-empty commit may be mapped to an empty commit, depending on your map function.) - Moreover, you can add blobs to each commit by overriding
commit_add
, and print progress by overrideprogress
. Thecommit_add
returns a list of blobs, each of which is in the same scheme asblob_map
.progress
is called after each commit is mapped.
Example
See example.py.
class MyGitMap(gitmap.GitMap):
def blob_map(self, data_stream, mode, path):
# keep README and LICENSE
if path in ['README.md', 'LICENSE.txt']:
return data_stream.read(), mode, path
# flatten python dir
if path.startswith('python/'):
return data_stream.read(), mode, path[len('python/'):]
# delete other files
else:
return None
def commit_add(self, old_commit):
# add .gitignore
return [
(b'__pycache__\njittor.egg-info\n', 0o100644, '.gitignore'),
]
def commit_map(self, old_commit, message, author, authored_date, author_tz_offset, committer, committed_date, committer_tz_offset):
# keep author, update committer
committer = git.Actor('Tailing Yuan', 'yuantailing@gmail.com')
committed_date = time.time()
return message, author, authored_date, author_tz_offset, committer, committed_date, committer_tz_offset
def progress(self, old_commit, new_commit):
# logging
print('committed', old_commit, '=>', new_commit)
remove_empty_commits = True
MyGitMap().run('../jittor', '../jittor-python-only')
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gitmap-0.0.1.tar.gz
(3.7 kB
view hashes)
Built Distribution
gitmap-0.0.1-py3-none-any.whl
(4.9 kB
view hashes)