โมดูล Python Git ประสบ? [ปิด]

ประสบการณ์ของผู้คนกับโมดูล Git ใด ๆ สำหรับ Python คืออะไร (ฉันรู้ GitPython, PyGit และ Dulwich - อย่าลังเลที่จะพูดถึงคนอื่นถ้าคุณรู้จักพวกเขา)

ฉันกำลังเขียนโปรแกรมที่จะต้องโต้ตอบ (เพิ่มลบกระทำ) กับที่เก็บ Git แต่ไม่มีประสบการณ์กับ Git ดังนั้นสิ่งหนึ่งที่ฉันกำลังมองหาคือความง่ายในการใช้ / ทำความเข้าใจเกี่ยวกับ Git

สิ่งอื่น ๆ ที่ฉันสนใจเป็นหลักคือความสมบูรณ์และความสมบูรณ์ของห้องสมุดการขาดข้อบกพร่องที่สมเหตุสมผลการพัฒนาอย่างต่อเนื่องและความเป็นประโยชน์ของเอกสารและนักพัฒนา

หากคุณนึกถึงอย่างอื่นที่ฉันอาจต้องการ / จำเป็นต้องรู้โปรดอย่าลังเลที่จะพูดถึงมัน

ในขณะที่คำถามนี้ถูกถามเมื่อไม่นานมานี้และฉันไม่ทราบสถานะของไลบรารีในตอนนั้น แต่ก็คุ้มค่าที่จะกล่าวถึงสำหรับผู้ค้นหาว่า GitPython ทำงานได้ดีในการสรุปเครื่องมือบรรทัดคำสั่งเพื่อให้คุณไม่จำเป็นต้องใช้ กระบวนการย่อย มีบางส่วนที่เป็นประโยชน์ที่สร้างขึ้นใน abstractions ที่คุณสามารถใช้ได้ แต่สำหรับทุกสิ่งอื่นคุณสามารถทำสิ่งต่าง ๆ เช่น:

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 ช่วยให้นำทางง่ายขึ้น ฉันค่อนข้างพอใจกับห้องสมุดนี้เป็นอย่างมากและขอขอบคุณว่านี่เป็นเสื้อคลุมสำหรับเครื่องมือคอมไพล์พื้นฐาน

UPDATE : ฉันเปลี่ยนมาใช้โมดูล sh ไม่ใช่แค่คอมไพล์ แต่ยูทิลิตี้ commandline ส่วนใหญ่ที่ฉันต้องการใน python เพื่อทำซ้ำข้างต้นฉันจะทำเช่นนี้แทน:

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 : ดูเหมือนว่าจะมีแนวโน้มมากที่สุด (อย่างน้อยสำหรับสิ่งที่ฉันต้องการและเห็น) ฉันใช้ความก้าวหน้ามากกว่ากับ GitPython เนื่องจากไข่ของมันมาพร้อมกับแหล่ง Python อย่างไรก็ตามหลังจากผ่านไปครู่หนึ่งฉันตัดสินใจว่าการลองทำในสิ่งที่ทำก็อาจจะง่ายกว่า

นอกจากนี้ StGitดูน่าสนใจ แต่ฉันต้องการฟังก์ชั่นที่แยกออกมาเป็นโมดูลแยกต่างหากและไม่ต้องการที่จะรอให้มันเกิดขึ้นตอนนี้

ในเวลา (มาก) น้อยกว่าที่ฉันใช้พยายามทำให้ทั้งสามโมดูลทำงานได้ฉันได้รับคำสั่ง 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

ดัลวิชอาจจะแตกต่างจากคนอื่น ๆ ในแง่ที่ว่ามันเป็นการปรับใช้คอมไพล์ในไพ ธ อน อีกอันอาจเป็น wrapper รอบคำสั่งของ Git (ดังนั้นมันจึงง่ายกว่าที่จะใช้จากมุมมองระดับสูง: commit / add / delete) มันอาจหมายความว่า API ของพวกเขานั้นใกล้กับบรรทัดคำสั่งของ git มากดังนั้นคุณต้อง เพื่อรับประสบการณ์กับ Git

เพื่อความสมบูรณ์http://github.com/alex/pyvcs/เป็นเลเยอร์นามธรรมสำหรับ dvcs ทั้งหมด มันใช้ดัลวิช แต่ให้ interop กับ dvcs อื่น ๆ

คำตอบที่อัปเดตซึ่งสะท้อนถึงเวลาที่เปลี่ยนแปลง:

ปัจจุบัน GitPython ใช้งานง่ายที่สุด สนับสนุนการตัดคำสั่ง git plumbing จำนวนมากและมีฐานข้อมูลวัตถุที่ถอดได้ (ดัลวิชเป็นหนึ่งในนั้น) และหากคำสั่งไม่ได้ถูกใช้ ตัวอย่างเช่น:

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

สายนี้:

bash$ git checkout -b new_branch

ดัลวิชยังดี แต่ระดับต่ำกว่ามาก มันค่อนข้างเจ็บปวดที่จะใช้เพราะมันต้องใช้งานกับวัตถุ git ที่ระดับการประปาและไม่มีเครื่องลายครามที่ดีที่ปกติคุณต้องการจะทำ อย่างไรก็ตามหากคุณวางแผนที่จะแก้ไขส่วนใดส่วนหนึ่งของ git หรือใช้ git-receive-pack และ git-upload-pack คุณต้องใช้ dulwich

นี่คือการใช้งานอย่างรวดเร็วของ "สถานะ 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() )

คำตอบของ 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)

ส่วนไลบรารีปฏิสัมพันธ์ git ของ StGit นั้นค่อนข้างดีทีเดียว อย่างไรก็ตามมันไม่ได้แยกออกเป็นแพคเกจแยกต่างหาก แต่หากมีความสนใจเพียงพอฉันแน่ใจว่าสามารถแก้ไขได้

มันมี abstractions ที่ดีมากสำหรับการทำคอมมิชชันต้นไม้เป็นต้นและสำหรับการสร้างคอมมิทและต้นไม้ใหม่

สำหรับบันทึกแล้วไม่มีไลบรารี Git Python ดังกล่าวข้างต้นที่ดูเหมือนจะมี "สถานะ git" ซึ่งเป็นสิ่งเดียวที่ฉันต้องการตั้งแต่จัดการกับคำสั่ง git ที่เหลือผ่าน subprocess นั้นง่ายมาก