Python的高级Git库 Gittle

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()
上一篇:在线SVN仓库实现:金山快盘+TortoiseSVN(Win)+SCPlugin(Mac)


下一篇:tablespace(表空间) / segment(断) / extent(盘区)/ block(块)/datafile(文件)之间的关系