Python Gitモジュールの経験？[閉まっている]

Python用のGitモジュールのいずれかを使用して、どのような経験をしましたか？（私はGitPython、PyGit、およびDulwichを知っています。ご存知の場合は、他の人に言及しても構いません。）

私はGitリポジトリと対話（追加、削除、コミット）する必要があるプログラムを書いていますが、Gitの経験がないため、Gitに関する使いやすさ/理解のしやすさを求めています。

私が主に興味を持っている他のことは、ライブラリの成熟度と完全性、バグの合理的な欠如、継続的な開発、およびドキュメントと開発者の有用性です。

他に知りたい、または知りたいことがあれば、遠慮なくお知らせください。

この質問は少し前に尋ねられたもので、その時点でのライブラリの状態はわかりませんが、GitPythonがコマンドラインツールを抽象化するのに優れているため、サブプロセス。いくつかの便利な組み込みの抽象化を使用できますが、それ以外の場合は次のようなことができます。

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()

GitPythonの他のすべては、ナビゲートを容易にするだけです。私はこのライブラリにかなり満足しており、基礎となるgitツールのラッパーであることを感謝しています。

更新：gitだけでなく、Pythonで必要なほとんどのコマンドラインユーティリティにもshモジュールを使用するように切り替えました。上記を複製するには、代わりにこれを行います：

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()

私は自分の質問に答えるつもりだと思っていました。答えで提案されているのとは異なる方法を取っているからです。それにもかかわらず、答えた人々に感謝します。

まず、GitPython、PyGit、およびDulwichでの私の経験の簡単な概要：

• GitPython：ダウンロード後、これをインポートして適切なオブジェクトを初期化しました。ただし、チュートリアルで提案されたことを実行しようとすると、エラーが発生しました。ドキュメントが足りなかったので、私は別の場所を探しました。
• PyGit：これはインポートすらできず、ドキュメントも見つかりませんでした。
• Dulwich：（少なくとも私が望んで見たものに対して）最も有望であるようです。その卵にはPythonソースが付属しているので、GitPythonよりも少し進歩しました。しかし、しばらくしてから、自分がやったことを試してみる方が簡単かもしれないと思いました。

また、StGitは面白そうですが、別のモジュールに抽出された機能が必要であり、それが今発生するのを待ちたくありません。

上記の3つのモジュールを機能させるために費やした時間よりも（はるかに）短い時間で、サブプロセスモジュールを介してgitコマンドを機能させることができました。

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')

これはまだ私のプログラムに完全に組み込まれていませんが、速度を除いて、問題を予測していません（時々数百または数千のファイルを処理するため）。

たぶん、DulwichやGitPythonで物事を進めるための忍耐力がなかったのかもしれません。そうは言っても、モジュールがもっと開発されてすぐにもっと役立つことを期待しています。

私はpygit2をお勧めします -優れたlibgit2バインディングを使用します

これはかなり古い質問です。Gitライブラリを探しているときに、今年（2013）に作成されたGittleと呼ばれるライブラリを見つけました。

それは私にとってはうまくいき（私が試した他のものは不安定でした）、一般的なアクションのほとんどをカバーしているようです。

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()

多分それは役立つかもしれませんが、BazaarとMercurialはどちらもGitの相互運用性のためにdulwichを使用しています。

Dulwichは、Pythonでのgitの再実装であるという意味で、おそらく他のものとは異なります。もう1つは単にGitのコマンドのラッパーである可能性があるため（高レベルの観点から見ると、コミット/追加/削除の方が簡単です）、おそらくAPIがgitのコマンドラインに非常に近いため、必要になりますGitの経験を積むため。

完全を期すために、http： //github.com/alex/pyvcs/はすべてのdvcの抽象化レイヤーです。Dulwichを使用しますが、他のDVCとの相互運用性を提供します。

変更された時間を反映する更新された回答：

現在、GitPythonが最も簡単に使用できます。多くのgit plumbingコマンドのラッピングをサポートし、プラグイン可能なオブジェクトデータベース（dulwichはその1つです）を備えています。コマンドが実装されていない場合は、コマンドラインに簡単にAPIを提供できます。例えば：

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

これは：

bash$ git checkout -b new_branch

ダルウィッチも良いですが、はるかに低いレベルです。配管レベルでgitオブジェクトを操作する必要があり、通常はやりたい素敵な磁器がないため、使用するのは多少面倒です。ただし、gitの一部を変更する予定がある場合、またはgit-receive-packとgit-upload-packを使用する場合は、dulwichを使用する必要があります。

ここに「git status」の本当に速い実装があります：

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() )

PTBNLの回答は私にとって非常に完璧です。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)

StGitのgit対話ライブラリー部分は、実際には非常に優れています。ただし、別パッケージとしては別れていませんが、十分ご興味がありましたら、修正できると確信しております。

コミットやツリーなどを表すため、そして新しいコミットやツリーを作成するための非常に素晴らしい抽象化があります。

ちなみに、前述のGit Pythonライブラリには、同等の「git status」が含まれているようには見えません。これは、サブプロセスを介して残りのgitコマンドを処理することが非常に簡単であるため、実際に必要なのはこれだけです。