Trải nghiệm mô-đun Python Git? [đóng cửa]

Trải nghiệm của mọi người với bất kỳ mô-đun Git nào cho Python? (Tôi biết về GitPython, PyGit và Dulwich - vui lòng đề cập đến những người khác nếu bạn biết về họ.)

Tôi đang viết một chương trình sẽ phải tương tác (thêm, xóa, cam kết) với kho Git, nhưng không có kinh nghiệm với Git, vì vậy một trong những điều tôi đang tìm kiếm là dễ sử dụng / hiểu về Git.

Những thứ khác tôi chủ yếu quan tâm là sự trưởng thành và đầy đủ của thư viện, thiếu lỗi hợp lý, tiếp tục phát triển và sự hữu ích của tài liệu và nhà phát triển.

Nếu bạn nghĩ về điều gì khác mà tôi có thể muốn / cần biết, xin vui lòng đề cập đến nó.

Mặc dù câu hỏi này đã được hỏi cách đây một thời gian và tôi không biết trạng thái của các thư viện vào thời điểm đó, điều đáng nói với những người tìm kiếm là GitPython thực hiện tốt việc trừu tượng hóa các công cụ dòng lệnh để bạn không cần sử dụng quy trình con. Có một số tóm tắt hữu ích mà bạn có thể sử dụng, nhưng đối với mọi thứ khác, bạn có thể làm những việc như:

import git
repo = git.Repo( '/home/me/repodir' )
print repo.git.status()
# checkout and track a remote branch
print repo.git.checkout( 'origin/somebranch', b='somebranch' )
# add a file
print repo.git.add( 'somefile' )
# commit
print repo.git.commit( m='my commit message' )
# now we are one commit ahead
print repo.git.status()

Mọi thứ khác trong GitPython chỉ giúp điều hướng dễ dàng hơn. Tôi khá hài lòng với thư viện này và đánh giá cao rằng nó là một trình bao bọc trên các công cụ git cơ bản.

CẬP NHẬT : Tôi đã chuyển sang sử dụng mô-đun sh không chỉ cho git mà hầu hết các tiện ích dòng lệnh tôi cần trong python. Để nhân rộng ở trên, tôi sẽ làm điều này thay vào đó:

import sh
git = sh.git.bake(_cwd='/home/me/repodir')
print git.status()
# checkout and track a remote branch
print git.checkout('-b', 'somebranch')
# add a file
print git.add('somefile')
# commit
print git.commit(m='my commit message')
# now we are one commit ahead
print git.status()

Tôi nghĩ rằng tôi sẽ trả lời câu hỏi của riêng mình, vì tôi đang đi một con đường khác với đề xuất trong câu trả lời. Tuy nhiên, cảm ơn những người đã trả lời.

Đầu tiên, một bản tóm tắt ngắn gọn về những trải nghiệm của tôi với GitPython, PyGit và Dulwich:

• GitPython : Sau khi tải xuống, tôi đã nhập cái này và đối tượng thích hợp được khởi tạo. Tuy nhiên, cố gắng làm những gì được đề xuất trong hướng dẫn đã dẫn đến lỗi. Thiếu thêm tài liệu, tôi chuyển sang nơi khác.
• PyGit : Điều này thậm chí sẽ không nhập và tôi không thể tìm thấy tài liệu nào.
• Dulwich : Có vẻ là hứa hẹn nhất (ít nhất là cho những gì tôi muốn và thấy). Tôi đã thực hiện một số tiến bộ với nó, hơn cả với GitPython, vì trứng của nó đi kèm với nguồn Python. Tuy nhiên, sau một thời gian, tôi quyết định có thể dễ dàng hơn để thử những gì tôi đã làm.

Ngoài ra, StGit có vẻ thú vị, nhưng tôi sẽ cần chức năng được trích xuất thành một mô-đun riêng biệt và không muốn chờ đợi điều đó xảy ra ngay bây giờ.

Trong (nhiều) ít thời gian hơn tôi đã cố gắng để làm cho ba mô-đun ở trên hoạt động, tôi đã quản lý để có được các lệnh git hoạt động thông qua mô-đun quy trình con, ví dụ:

def gitAdd(fileName, repoDir):
    cmd = ['git', 'add', fileName]
    p = subprocess.Popen(cmd, cwd=repoDir)
    p.wait()

gitAdd('exampleFile.txt', '/usr/local/example_git_repo_dir')

Điều này chưa được tích hợp hoàn toàn vào chương trình của tôi, nhưng tôi không lường trước được vấn đề, ngoại trừ có thể là tốc độ (vì tôi sẽ xử lý hàng trăm hoặc thậm chí hàng nghìn tệp mỗi lần).

Có lẽ tôi không đủ kiên nhẫn để làm mọi thứ với Dulwich hoặc GitPython. Điều đó nói rằng, tôi hy vọng các mô-đun sẽ được phát triển nhiều hơn và sớm hữu ích hơn.

Tôi muốn giới thiệu pygit2 - nó sử dụng các liên kết libgit2 tuyệt vời

Đây là một câu hỏi khá cũ và trong khi tìm kiếm các thư viện Git, tôi đã tìm thấy một câu hỏi được thực hiện trong năm nay (2013) có tên là Gittle .

Nó hoạt động rất tốt đối với tôi (nơi mà những người khác tôi đã thử là không ổn), và dường như bao trùm hầu hết các hành động thông thường.

Một số ví dụ từ README:

from gittle import Gittle

# Clone a repository
repo_path = '/tmp/gittle_bare'
repo_url = 'git://github.com/FriendCode/gittle.git'
repo = Gittle.clone(repo_url, repo_path)

# 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")

# Authentication with RSA private key
key_file = open('/Users/Me/keys/rsa/private_rsa')
repo.auth(pkey=key_file)

# Do push
repo.push()

Có thể nó giúp, nhưng Bazaar và Mercurial đều sử dụng dulwich cho khả năng tương tác Git của họ.

Dulwich có lẽ khác với người khác theo nghĩa đó là sự tái hiện của git trong trăn. Cái kia có thể chỉ là một trình bao bọc xung quanh các lệnh của Git (vì vậy có thể sử dụng đơn giản hơn từ quan điểm cấp cao: commit / add / xóa), điều đó có thể có nghĩa là API của chúng rất gần với dòng lệnh của git nên bạn sẽ cần để có kinh nghiệm với Git.

Để hoàn thiện, http://github.com/alex/pyvcs/ là một lớp trừu tượng cho tất cả các dvcs. Nó sử dụng dulwich, nhưng cung cấp interop với các dvcs khác.

Một câu trả lời cập nhật phản ánh thời gian thay đổi:

GitPython hiện là dễ sử dụng nhất. Nó hỗ trợ gói nhiều lệnh hệ thống ống nước git và có cơ sở dữ liệu đối tượng có thể cắm được (dulwich là một trong số đó) và nếu một lệnh không được thực thi, sẽ cung cấp một api dễ dàng để tách ra khỏi dòng lệnh. Ví dụ:

repo = Repo('.')
repo.checkout(b='new_branch')

Cuộc gọi này:

bash$ git checkout -b new_branch

Dulwich cũng tốt nhưng trình độ thấp hơn nhiều. Nó hơi khó sử dụng vì nó đòi hỏi phải hoạt động trên các vật thể git ở cấp ống nước và không có đồ sứ đẹp mà bạn thường muốn làm. Tuy nhiên, nếu bạn có kế hoạch sửa đổi bất kỳ phần nào của git hoặc sử dụng git-receive-pack và git-upload-pack, bạn cần sử dụng dulwich.

Đây là một triển khai thực sự nhanh chóng của "trạng thái git":

import os
import string
from subprocess import *

repoDir = '/Users/foo/project'

def command(x):
    return str(Popen(x.split(' '), stdout=PIPE).communicate()[0])

def rm_empty(L): return [l for l in L if (l and l!="")]

def getUntracked():
    os.chdir(repoDir)
    status = command("git status")
    if "# Untracked files:" in status:
        untf = status.split("# Untracked files:")[1][1:].split("\n")
        return rm_empty([x[2:] for x in untf if string.strip(x) != "#" and x.startswith("#\t")])
    else:
        return []

def getNew():
    os.chdir(repoDir)
    status = command("git status").split("\n")
    return [x[14:] for x in status if x.startswith("#\tnew file:   ")]

def getModified():
    os.chdir(repoDir)
    status = command("git status").split("\n")
    return [x[14:] for x in status if x.startswith("#\tmodified:   ")]

print("Untracked:")
print( getUntracked() )
print("New:")
print( getNew() )
print("Modified:")
print( getModified() )

Câu trả lời của PTBNL khá hoàn hảo đối với tôi. Tôi làm thêm một chút cho người dùng Windows.

import time
import subprocess
def gitAdd(fileName, repoDir):
    cmd = 'git add ' + fileName
    pipe = subprocess.Popen(cmd, shell=True, cwd=repoDir,stdout = subprocess.PIPE,stderr = subprocess.PIPE )
    (out, error) = pipe.communicate()
    print out,error
    pipe.wait()
    return 

def gitCommit(commitMessage, repoDir):
    cmd = 'git commit -am "%s"'%commitMessage
    pipe = subprocess.Popen(cmd, shell=True, cwd=repoDir,stdout = subprocess.PIPE,stderr = subprocess.PIPE )
    (out, error) = pipe.communicate()
    print out,error
    pipe.wait()
    return 
def gitPush(repoDir):
    cmd = 'git push '
    pipe = subprocess.Popen(cmd, shell=True, cwd=repoDir,stdout = subprocess.PIPE,stderr = subprocess.PIPE )
    (out, error) = pipe.communicate()
    pipe.wait()
    return 

temp=time.localtime(time.time())
uploaddate= str(temp[0])+'_'+str(temp[1])+'_'+str(temp[2])+'_'+str(temp[3])+'_'+str(temp[4])

repoDir='d:\\c_Billy\\vfat\\Programming\\Projector\\billyccm' # your git repository , windows your need to use double backslash for right directory.
gitAdd('.',repoDir )
gitCommit(uploaddate, repoDir)
gitPush(repoDir)

Phần thư viện tương tác git của StGit thực sự khá tốt. Tuy nhiên, nó không được chia thành một gói riêng biệt nhưng nếu có đủ tiền lãi, tôi chắc chắn rằng nó có thể được sửa chữa.

Nó có những tóm tắt rất hay để thể hiện các xác nhận, cây, v.v. và để tạo các xác nhận và cây mới.

Đối với bản ghi, không có thư viện Git Python nào nói trên dường như có chứa "trạng thái git" tương đương, đây thực sự là điều duy nhất tôi muốn vì việc xử lý các lệnh git còn lại thông qua quy trình con rất dễ dàng.