mirror of
https://github.com/status-im/PyGithub.git
synced 2026-09-02 03:41:08 +00:00
87 lines
3.9 KiB
ReStructuredText
87 lines
3.9 KiB
ReStructuredText
This is a Python (2 and 3) library to access the `Github API v3 <http://developer.github.com/v3>`_.
|
|
With it, you can manage your `Github <http://github.com>`_ resources (repositories, user profiles, organizations, etc.) from Python scripts.
|
|
|
|
It covers the **full** API (except recent additions, see "What's missing" bellow), and all methods are tested against the real Github site.
|
|
|
|
Should you have any question, any remark, or if you find a bug, or if there is something you can do with the API but not with PyGithub, please `open an issue <https://github.com/jacquev6/PyGithub/issues>`_.
|
|
|
|
PyGithub is stable. I will maintain it up to date with the API, and fix bugs if any, but I don't plan new heavy developments.
|
|
|
|
What's new?
|
|
===========
|
|
|
|
Summer 2013 - I'm traveling
|
|
---------------------------
|
|
|
|
You may have noticed I'm a bit slower than usual to manage your issues and pull requests.
|
|
That's because I'm traveling a lot this summer. Please be patient.
|
|
|
|
`Version 1.17.0 <https://github.com/jacquev6/PyGithub/issues?milestone=29&state=closed>`_ (Jully 7th, 2013) (Hamburg edition)
|
|
-----------------------------------------------------------------------------------------------------------------------------
|
|
|
|
* `Fix <https://github.com/jacquev6/PyGithub/pull/176>`_ bug in ``Repository.get_comment`` when using custom ``per_page``. Thank you `davidbrai <https://github.com/davidbrai>`_
|
|
* `Handle <https://github.com/jacquev6/PyGithub/pull/174>`_ Http redirects in ``Repository.get_dir_contents``. Thank you `MarkRoddy <https://github.com/MarkRoddy>`_
|
|
* `Implement <https://github.com/jacquev6/PyGithub/issues/173>`_ API ``/user`` in ``Github.get_users``. Thank you `rakeshcusat <https://github.com/rakeshcusat>`_ for asking
|
|
* `Improve <https://github.com/jacquev6/PyGithub/pull/171>`_ the documentation. Thank you `martinqt <https://github.com/martinqt>`_
|
|
|
|
What's missing?
|
|
===============
|
|
|
|
We now have automated ways to list URLs documented in `the reference of Github API v3 <http://developer.github.com>`_ and not covered by PyGithub.
|
|
|
|
Github API v3 URLs not (yet) covered by PyGithub
|
|
------------------------------------------------
|
|
|
|
* ``/applications/:client_id/tokens/:access_token`` (GET)
|
|
* ``/feeds`` (GET)
|
|
* ``/gists/:id/forks`` (POST)
|
|
|
|
* instead, ``Gist.create_fork`` calls the old URL ``/gists/:id/fork``
|
|
|
|
* ``/meta`` (GET)
|
|
* ``/notifications`` (PUT)
|
|
* ``/notifications/emails`` (GET)
|
|
* ``/notifications/emails`` (PATCH)
|
|
* ``/notifications/global/emails`` (GET)
|
|
* ``/notifications/global/emails`` (PUT)
|
|
* ``/notifications/organization/:org/emails`` (GET)
|
|
* ``/notifications/organization/:org/emails`` (PUT)
|
|
* ``/notifications/settings`` (GET)
|
|
* ``/notifications/settings`` (PATCH)
|
|
* ``/notifications/threads/:id`` (PATCH)
|
|
* ``/notifications/threads/:id/subscription`` (DELETE)
|
|
* ``/notifications/threads/:id/subscription`` (GET)
|
|
* ``/notifications/threads/:id/subscription`` (PUT)
|
|
* ``/rate_limit`` (GET)
|
|
|
|
* should be called in method ``Github.get_rate_limit``. See also ``Github.rate_limiting``
|
|
|
|
* ``/repos/:owner/:repo/contents/:path`` (DELETE)
|
|
* ``/repos/:owner/:repo/contents/:path`` (PUT)
|
|
* ``/repos/:owner/:repo/hooks/:id/tests`` (POST)
|
|
|
|
* instead, ``Hook.test`` calls the old URL ``/repos/:owner/:repo/hooks/:id/test``
|
|
|
|
* ``/repos/:owner/:repo/notifications`` (GET)
|
|
* ``/repos/:owner/:repo/notifications`` (PUT)
|
|
* ``/repos/:owner/:repo/stats/code_frequency`` (GET)
|
|
* ``/repos/:owner/:repo/stats/commit_activity`` (GET)
|
|
* ``/repos/:owner/:repo/stats/contributors`` (GET)
|
|
* ``/repos/:owner/:repo/stats/participation`` (GET)
|
|
* ``/repos/:owner/:repo/stats/punch_card`` (GET)
|
|
* ``/repos/:owner/:repo/subscription`` (DELETE)
|
|
* ``/repos/:owner/:repo/subscription`` (GET)
|
|
* ``/repos/:owner/:repo/subscription`` (PUT)
|
|
* ``/repositories`` (GET)
|
|
|
|
* should be called in method ``Github.get_repos``
|
|
|
|
* ``/users/:user/following/:target_user`` (GET)
|
|
|
|
* should be called in method ``NamedUser.has_in_following``
|
|
|
|
Documentation
|
|
=============
|
|
|
|
All the documentation is here: http://jacquev6.github.com/PyGithub.
|