Github API v3 için en uygun python kitaplığı [kapalı]

Benim için uygun Github APIv3 için bir python kitaplığı arıyorum.

GH API belgelerinde belirtilen bir kitaplık (python-github3) buldum . Bir veya iki saat ipython'da onunla oynadıktan sonra, keşfetmeyi / çalışmayı gerçekten mantıksız buldum. Biraz daha baktım ve en azından böyle bir kitaplık yazmaya çalışan çok sayıda insan olduğunu gördüm. Daha umut verici görünen (bir bakışta) PyGithub ve görünüşe göre ilkinden farklı olan başka bir python-github3'tür .

Sonraki günleri ard arda kütüphaneyi deneyerek geçirmeden önce, SO topluluğuna bu kütüphane için kabul edilmiş, kesin ve açık bir seçim olup olmadığını sormak istedim.

İlk kitaplıktan hoşlanmadığım şey, verilere ulaşmanın (bana göre) sezgisel olmayan yoluydu - bazı şeyler öznitelik olarak elde edersiniz, bazılarını bir yöntemin dönüş değeri olarak alırsınız, bu dönüş değeri, bazı karmaşık nesnelerdir. sayfalandırılmalı ve tekrarlanmalı vb.

Bu bağlamda, PyGithub ilk bakışta daha çekici görünüyor - bir nesne hiyerarşisini net bir şekilde inceleyin ve ardından istediğiniz şeyi içeren özelliğe ulaşın:

for repo in g.get_user().get_repos(): print repo.name

Peki, paylaşacak bilgelik incileri var mı? Kütüphane kalitesini hızlı bir şekilde yargılayacak kadar becerim olmadığını biliyorum, bu yüzden SO topluluğuna dönüyorum.

edit: fwiw, PyGithub'ı kullandım . İyi çalışıyor ve yazar, geri bildirim ve hata raporlarına gerçekten açık. :-)

Yeni başlayan bir python programcısı olduğunuzdan bahsettiğiniz için, önce JSON API'yi herhangi bir Github kitaplığı olmadan kullanmayı denemenizi öneririm. Gerçekten o kadar zor değil ve programlama hayatınızın ilerleyen dönemlerinde size çok yardımcı olacak, çünkü aynı yaklaşım herhangi bir JSON API'ye uygulanabilir. Özellikle de kütüphaneleri denemek günler alacak gibi görünüyorsa.

Bazı kitaplıkların kullanımının daha kolay olmadığını söylemiyorum, sadece API'yi doğrudan kullanmak için küçük bir ekstra çabanın uzun vadede buna değebileceğini söylüyorum. En azından bu kütüphanelerden bazılarının neden "mantıksız" göründüğünü anlamanıza yardımcı olacaktır (sizin de söylediğiniz gibi).

Django deposunun oluşturma zamanını almak için basit bir örnek:

import requests
import json
r = requests.get('https://api.github.com/repos/django/django')
if(r.ok):
    repoItem = json.loads(r.text or r.content)
    print "Django repository created: " + repoItem['created_at']

Bu, popüler istekler kitaplığını kullanıyor . Kodunuzda doğal olarak hata durumlarını da ele almanız gerekir.

Kimlik doğrulama ile erişime ihtiyacınız varsa, biraz daha karmaşık olacaktır.

Sonunda PyGithub'ı kullanmaya başladım . İyi çalışıyor ve yazar, geri bildirim ve hata raporlarına gerçekten açık. :-)

(Daha iyi görünürlük için düzenlememden orijinal soruya uyarlandı)

PyGitHub için dokümantasyon korkunç, ancak ürün harika. İşte bir dosyayı gerçekten almak, dosyanın başlangıcında yeni bir yorumla değiştirmek ve onu geri kaydetmek için hızlı bir örnek.

from github import Github
gh = Github(login_or_token='.....', base_url='...../api/v3')
user = gh.get_user()
repo = user.get_repo("RepoName")
file = repo.get_file_contents("/App/forms.py")
decoded_content = "# Test " + "\r\n" + file.decoded_content
repo.update_file("/"RepoName"/forms.py", "Commit Comments", decoded_content, file.sha)

Libsaas , yeni başlayanlar için harika. Güzel bir dokümantasyona sahiptir ve kullanımı kolaydır, örneğe bakın . Katkıda bulunmaktan çekinmeyin.