Python module to simplify loading of snapshot of git repository
Project description
gitsnapshot
A simple library to load snapshots of git repository.
Usage
To load git repository call load_repo
as follows:
from gitsnapshot import load_repo
load_repo('~/target/directory', 'git@github.com/test/repo')
This code creates folder ~/target/directory
if this folder doesn't exists, and then
clone shallow copy of repository git@github.com/test/repo
.
By default this function loads current master
branch.
To load another branch (i.e. develop
) pass branch name in branch
parameter:
from gitsnapshot import load_repo
load_repo('~/target/directory', 'git@github.com/test/repo', branch='develop')
Also you can load snapshot by tag:
from gitsnapshot import load_repo
load_repo('~/target/directory', 'git@github.com/test/repo', tag='v0.1.2')
Or by commit hash:
from gitsnapshot import load_repo
load_repo('~/target/directory', 'git@github.com/test/repo', commit='abcdef')
Errors
load_repo
function return optional string with error description.
If load_repo
returned None
then no errors was happened.
Reusing of directory
If you try to load repository snapshot into existing directory with another snapshot
of the same repository, load_repo
will return error.
To avoid this behavior pass use_existing=True
as argument.
from gitsnapshot import load_repo
load_repo('~/target/directory', 'git@github.com/test/repo', use_existing=True)
In this case load_repo
will load repository index and will checkout to specified
branch, tag or commit.
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.