Найбільш підходяща бібліотека python для Github API v3 [закрито]

Я шукаю бібліотеку python для Github APIv3, що підходить мені.

Я знайшов одну бібліотеку (python-github3), згадану в документах GH API . Погравши з ним в ipython протягом години-двох, я виявив, що це справді неінтуїтивно досліджувати / працювати з ним. Я ще трохи подивився і виявив, що чимала кількість людей хоча б намагається написати таку бібліотеку. Перспективнішими (на перший погляд) є PyGithub та інший python-github3 , який, очевидно, відрізняється від першого.

Перш ніж проводити наступні дні послідовно випробовуючи бібліотеку за бібліотекою, я хотів запитати у спільноти SO, чи є прийнятний, остаточний, очевидний вибір для цієї бібліотеки?

Що мені не сподобалось у першій бібліотеці, це (для мене) неінтуїтивний спосіб отримати дані - деякі речі, які ви отримуєте як атрибути, інші отримуєте як повернене значення методу, це повернене значення - це якийсь складний об'єкт, який повинен бути перекладеним на сторінку та переглянуто тощо.

У цьому відношенні PyGithub на перший погляд виглядає більш привабливим - чітко детально розгорніть ієрархію об’єктів, а потім перейдіть до атрибута, що містить те, що ви хочете:

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

Отже, якимись перлинами мудрості поділитися? Я знаю, що у мене недостатньо навичок, щоб швидко оцінити якість бібліотеки, саме тому я звертаюся до спільноти SO.

edit: fwiw, я закінчив користуватися PyGithub . Це працює добре, і автор справді сприйнятливий до відгуків та повідомлень про помилки. :-)

Оскільки ви згадали, що ви початківець програміст на python, я б запропонував вам спробувати використовувати JSON API без будь-якої бібліотеки Github. Це насправді не так складно, і це допоможе вам набагато пізніше у вашому програмуванні, оскільки такий самий підхід можна застосувати до будь-якого JSON API. Особливо, якщо здається, що випробування бібліотек займе кілька днів.

Я не кажу, що деяку бібліотеку не простіше використовувати, я просто кажу, що невеликі додаткові зусилля щодо безпосереднього використання API можуть коштувати того в довгостроковій перспективі. Принаймні це допоможе вам зрозуміти, чому деякі з цих бібліотек здаються "неінтуїтивними" (як ви вже сказали).

Простий приклад для отримання часу створення сховища django:

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

Це використовує популярну бібліотеку запитів . У вашому коді вам, природно, теж доведеться обробляти випадки помилок.

Якщо вам потрібен доступ з аутентифікацією, це буде дещо складніше.

Врешті-решт, я закінчив користуватися PyGithub . Це працює добре, і автор справді сприйнятливий до відгуків та повідомлень про помилки. :-)

(Адаптовано з мого редагування до оригінального запитання для кращої видимості)

Документація жахлива для PyGitHub, але продукт чудовий. Ось короткий зразок для фактичного отримання файлу, зміни його з новим коментарем на початку файлу та повернення назад

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 чудово підходить для початківців. Він має приємну документацію і простий у використанні, див. Приклад . Не соромтеся робити внески.