Gittle是一个高级纯python git 库。构建在dulwich之上,提供了大部分的低层机制
Gittle是一个高级纯python git 库。构建在dulwich之上,提供了大部分的低层机制。
Install it
pip install gittle
Examples :
Clone a repository
1
2
3
4
5
6
|
from gittle import Gittle repo_path = '/tmp/gittle_bare' repo_url = 'git://github.com/FriendCode/gittle.git' repo = Gittle.clone(repo_url, repo_path) |
With authentication (see Authentication section for more information) :
1
2
|
auth = GittleAuth(pkey = key) Gittle.clone(repo_url, repo_path, auth = auth) |
Or clone bare repository (no working directory) :
repo = Gittle.clone(repo_url, repo_path, bare=True)
Init repository from a path
repo = Gittle.init(path)
Get repository information
1
2
3
4
5
6
7
8
9
10
11
|
# Get list of objects repo.commits # Get list of branches repo.branches # Get list of modified files (in current working directory) repo.modified_files # Get diff between latest commits repo.diff( 'HEAD' , 'HEAD~1' ) |
Commit
1
2
3
4
5
6
7
8
|
# Stage single file repo.stage( 'file.txt' ) # Stage multiple files repo.stage([ 'other1.txt' , 'other2.txt' ]) # Do the commit repo.commit(name = "Samy Pesse" , email = "samy@friendco.de" , message = "This is a commit" ) |
Pull
1
2
3
4
5
6
7
8
|
repo = Gittle(repo_path, origin_uri = repo_url) # Authentication with RSA private key key_file = open ( '/Users/Me/keys/rsa/private_rsa' ) repo.auth(pkey = key_file) # Do pull repo.pull() |
Push
1
2
3
4
5
6
7
8
|
repo = Gittle(repo_path, origin_uri = repo_url) # Authentication with RSA private key key_file = open ( '/Users/Me/keys/rsa/private_rsa' ) repo.auth(pkey = key_file) # Do push repo.push() |
Authentication for remote operations
1
2
3
4
5
6
|
# With a key key_file = open ( '/Users/Me/keys/rsa/private_rsa' ) repo.auth(pkey = key_file) # With username and password repo.auth(username = "your_name" , password = "your_password" ) |
Branch
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
# Create branch off master repo.create_branch( 'dev' , 'master' ) # Checkout the branch repo.switch_branch( 'dev' ) # Create an empty branch (like 'git checkout --orphan') repo.create_orphan_branch( 'NewBranchName' ) # Print a list of branches print (repo.branches) # Remove a branch repo.remove_branch( 'dev' ) # Print a list of branches print (repo.branches) |
Get file version
1
2
|
versions = repo.get_file_versions( 'gittle/gittle.py' ) print ( "Found %d versions out of a total of %d commits" % ( len (versions), repo.commit_count())) |
Get list of modified files (in current working directory)
repo.modified_files
Count number of commits
repo.commit_count
Get information for commits
List commits :
# Get 20 first commits repo.commit_info(start=0, end=20)
With a given commit :
commit = "a2105a0d528bf770021de874baf72ce36f6c3ccc"
Diff with another commit :
1
2
|
old_commit = repo.get_previous_commit(commit, n = 1 ) print repo.diff(commit, old_commit) |
Explore commit files using :
1
2
3
4
5
6
7
8
9
10
|
commit = "a2105a0d528bf770021de874baf72ce36f6c3ccc" # Files tree print repo.commit_tree(commit) # List files in a subpath print repo.commit_ls(commit, "testdir" ) # Read a file print repo.commit_file(commit, "testdir/test.txt" ) |
Create a GIT server
1
2
3
4
5
6
7
|
from gittle import GitServer # Read only GitServer( '/' , 'localhost' ).serve_forever() # Read/Write GitServer( '/' , 'localhost' , perm = 'rw' ).serve_forever() |