𝗖𝗨𝗥𝗥𝗘𝗡𝗧 𝗙𝗜𝗟𝗘 : /opt/alt/python27/lib/python2.7/site-packages/github//MainClass.pyc
�
b�1[c @ s� d d l Z d d l Z d d l Z d d l Z d d l m Z d d l Z d d l m Z m Z d d l Z d d l
Z
d d l Z d d l Z d d l
Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z e j d k Z d Z d Z d Z d Z! d e" f d
� � YZ# d e" f d � � YZ$ d S(
i����N( t HTTPSConnection( t Requestert jsoni s https://api.github.coms https://status.github.comi i t Githubc B sB e Z d Z d( d( e e d( d( d e e e d �
Z d � Z
d � Z e e
e � Z
d � Z d � Z e e e � Z e d � � Z e d � � Z d � Z e d
� � Z e j j d � Z d � Z e j j d
� Z e j j d � Z d � Z e j j d � Z e d � Z e j j d � Z d � Z d � Z! e j j e j j d � Z" e j j e j j d � Z# e j j e j j d � Z$ e j j e j j d � Z% e j j e j j d � Z& e j j d � Z' d � Z( d � Z) d � Z* d � Z+ d � Z, i d � Z- d! d" � Z. d# � Z/ d$ � Z0 d% � Z1 d& � Z2 d' � Z3 RS() s�
This is the main class you instantiate to access the Github API v3. Optional parameters allow different authentication methods.
s PyGithub/Pythonc C sf | d k s- t | t t f � s- t | � � | d k sZ t | t t f � sZ t | � � t | t t f � s{ t | � � t | t t f � s� t | � � | d k s� t | t t f � s� t | � � | d k s� t | t t f � s� t | � � | d k s#t | t t f � s#t | � � t | t � s8t � t | | | | | | | | | |
�
| _ d S( s=
:param login_or_token: string
:param password: string
:param base_url: string
:param timeout: integer
:param client_id: string
:param client_secret: string
:param user_agent: string
:param per_page: int
:param verify: boolean or string
N(
t Nonet
isinstancet strt unicodet AssertionErrort intt longt boolR t _Github__requester( t selft login_or_tokent passwordt base_urlt timeoutt client_idt
client_secrett
user_agentt per_paget api_previewt verify( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt __init__X s
--!!---c C s
| j j S( s
:type: bool
( R t FIX_REPO_GET_GIT_REF( R
( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt __get_FIX_REPO_GET_GIT_REFo s c C s | | j _ d S( N( R R ( R
t value( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt __set_FIX_REPO_GET_GIT_REFu s c C s
| j j S( s
:type: int
( R R ( R
( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt __get_per_pagez s c C s | | j _ d S( N( R R ( R
R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt __set_per_page� s c C s5 | j j \ } } | d k r+ | j � n | j j S( sm
First value is requests remaining, second value is request limit.
:type: (int, int)
i ( R t
rate_limitingt get_rate_limit( R
t remainingt limit( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR � s
c C s) | j j d k r | j � n | j j S( s]
Unix timestamp indicating when rate limiting will reset.
:type: int
i ( R t rate_limiting_resettimeR ( R
( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR# � s
c C s4 | j j d d � \ } } t j | j | | t � S( sb
Don't forget you can access the rate limit returned in headers of last Github API v3 response, by :attr:`github.MainClass.Github.rate_limiting` and :attr:`github.MainClass.Github.rate_limiting_resettime`.
:calls: `GET /rate_limit <http://developer.github.com/v3/rate_limit>`_
:rtype: :class:`github.RateLimit.RateLimit`
t GETs /rate_limit( R t requestJsonAndCheckt RateLimitt True( R
t headerst
attributes( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR � s c C s
| j j S( s'
:type: list of string
( R t oauth_scopes( R
( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR* � s c C s_ t | t t f � s! t | � � | j j d d | � \ } } t j j | j | | d t �S( s�
:calls: `GET /license/:license <https://developer.github.com/v3/licenses/#get-an-individual-license>`_
:param key: string
:rtype: :class:`github.License.License`
R$ s
/licenses/t completed( R R R R R R% t githubt LicenseR' ( R
t keyR( t data( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_license� s
! c C s+ t � } t j j t j j | j d | � S( s�
:calls: `GET /licenses <https://developer.github.com/v3/licenses/#list-all-licenses>`_
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.License.License`
s /licenses( t dictR, t
PaginatedListR- R ( R
t url_parameters( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_licenses� s c C s� | t j j k s3 t | t t f � s3 t | � � | t j j k rh t j | j i i d d 6d t �S| j j
d d | � \ } } t j j | j | | d t �Sd S( s�
:calls: `GET /users/:user <http://developer.github.com/v3/users>`_ or `GET /user <http://developer.github.com/v3/users>`_
:param login: string
:rtype: :class:`github.NamedUser.NamedUser`
s /usert urlR+ R$ s /users/N(
R, t GithubObjectt NotSetR R R R t AuthenticatedUserR t FalseR% t NamedUserR' ( R
t loginR( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_user� s 3# c C s} | t j j k s3 t | t t f � s3 t | � � t � } | t j j k r[ | | d <n t j j t j j | j
d | � S( s�
:calls: `GET /users <http://developer.github.com/v3/users>`_
:param since: integer
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.NamedUser.NamedUser`
t sinces /users( R, R6 R7 R R R
R R1 R2 R: R ( R
R= R3 ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_users� s 3
c C s_ t | t t f � s! t | � � | j j d d | � \ } } t j j | j | | d t �S( s�
:calls: `GET /orgs/:org <http://developer.github.com/v3/orgs>`_
:param login: string
:rtype: :class:`github.Organization.Organization`
R$ s /orgs/R+ ( R R R R R R% R, t OrganizationR' ( R
R; R( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_organization� s
! c C s} | t j j k s3 t | t t f � s3 t | � � t � } | t j j k r[ | | d <n t j j t j j | j
d | � S( s�
:calls: `GET /organizations <http://developer.github.com/v3/orgs#list-all-organizations>`_
:param since: integer
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Organization.Organization`
R= s /organizations( R, R6 R7 R R R
R R1 R2 R: R ( R
R= R3 ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_organizations� s 3
c C s� t | t t t t f � s' t | � � t | t � sE t | t � rK d n d } d | | f } | r� t j | j i i | d 6d t �S| j j d d | | f � \ } } t j | j | | d t
�S( s�
:calls: `GET /repos/:owner/:repo <http://developer.github.com/v3/repos>`_ or `GET /repositories/:id <http://developer.github.com/v3/repos>`_
:rtype: :class:`github.Repository.Repository`
s /repositories/s /repos/s %s%sR5 R+ R$ ( R R R R R
R t
RepositoryR R9 R% R' ( R
t full_name_or_idt lazyt url_baseR5 R( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_repo s '*# c C s} | t j j k s3 t | t t f � s3 t | � � t � } | t j j k r[ | | d <n t j j t j j | j
d | � S( s�
:calls: `GET /repositories <http://developer.github.com/v3/repos/#list-all-public-repositories>`_
:param since: integer
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Repository.Repository`
R= s
/repositories( R, R6 R7 R R R
R R1 R2 RB R ( R
R= R3 ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_repos s 3
c C s_ t | t t f � s! t | � � | j j d d | � \ } } t j j | j | | d t �S( s�
:calls: `GET /gists/:id <http://developer.github.com/v3/gists>`_
:param id: string
:rtype: :class:`github.Gist.Gist`
R$ s /gists/R+ ( R R R R R R% R, t GistR' ( R
t idR( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_gist/ s
! c C s" t j j t j j | j d d � S( s�
:calls: `GET /gists/public <http://developer.github.com/v3/gists>`_
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Gist.Gist`
s
/gists/publicN( R, R2 RH R R ( R
( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_gists< s
c K s3 t | t t f � s! t | � � t � } | t j j k ra | d
k sT t | � � | | d <n | t j j k r� | d k s� t | � � | | d <n g } | r� | j | � n x1 | j � D]# \ } } | j d | | f � q� Wd j
| � | d
<| d
st d � � t j j t j j | j
d | � S( s
:calls: `GET /search/repositories <http://developer.github.com/v3/search>`_
:param query: string
:param sort: string ('stars', 'forks', 'updated')
:param order: string ('asc', 'desc')
:param qualifiers: keyword dict query qualifiers
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Repository.Repository`
t starst forkst updatedt sortt asct desct orders %s:%st t qs need at least one qualifiers /search/repositories( RL RM RN ( RP RQ ( R R R R R1 R, R6 R7 t appendt itemst joinR2 RB R ( R
t queryRO RR t
qualifiersR3 t query_chunkst qualifierR ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt search_repositoriesH s( !
c K s3 t | t t f � s! t | � � t � } | t j j k ra | d
k sT t | � � | | d <n | t j j k r� | d k s� t | � � | | d <n g } | r� | j | � n x1 | j � D]# \ } } | j d | | f � q� Wd j
| � | d
<| d
st d � � t j j t j j | j
d | � S( s�
:calls: `GET /search/users <http://developer.github.com/v3/search>`_
:param query: string
:param sort: string ('followers', 'repositories', 'joined')
:param order: string ('asc', 'desc')
:param qualifiers: keyword dict query qualifiers
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.NamedUser.NamedUser`
t followerst repositoriest joinedRO RP RQ RR s %s:%sRS RT s need at least one qualifiers
/search/users( R] R^ R_ ( RP RQ ( R R R R R1 R, R6 R7 RU RV RW R2 R: R ( R
RX RO RR RY R3 RZ R[ R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt search_usersk s( !
c K s3 t | t t f � s! t | � � t � } | t j j k ra | d
k sT t | � � | | d <n | t j j k r� | d k s� t | � � | | d <n g } | r� | j | � n x1 | j � D]# \ } } | j d | | f � q� Wd j
| � | d
<| d
st d � � t j j t j j | j
d | � S( st
:calls: `GET /search/issues <http://developer.github.com/v3/search>`_
:param query: string
:param sort: string ('comments', 'created', 'updated')
:param order: string ('asc', 'desc')
:param qualifiers: keyword dict query qualifiers
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Issue.Issue`
t commentst createdRN RO RP RQ RR s %s:%sRS RT s need at least one qualifiers /search/issues( Ra Rb RN ( RP RQ ( R R R R R1 R, R6 R7 RU RV RW R2 t IssueR ( R
RX RO RR RY R3 RZ R[ R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt
search_issues� s( !
c K s3 t | t t f � s! t | � � t � } | t j j k ra | d k sT t | � � | | d <n | t j j k r� | d k s� t | � � | | d <n g } | r� | j | � n x1 | j � D]# \ } } | j d | | f � q� Wd j
| � | d <| d st d � � t j j t j j | j
d
| � S(
sg
:calls: `GET /search/code <http://developer.github.com/v3/search>`_
:param query: string
:param sort: string ('indexed')
:param order: string ('asc', 'desc')
:param qualifiers: keyword dict query qualifiers
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.ContentFile.ContentFile`
t indexedRO RP RQ RR s %s:%sRS RT s need at least one qualifiers /search/code( Re ( RP RQ ( R R R R R1 R, R6 R7 RU RV RW R2 t ContentFileR ( R
RX RO RR RY R3 RZ R[ R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt search_code� s( !
c K s@ t | t t f � s! t | � � t � } | t j j k ra | d k sT t | � � | | d <n | t j j k r� | d k s� t | � � | | d <n g } | r� | j | � n x1 | j � D]# \ } } | j d | | f � q� Wd j
| � | d <| d st d
� � t j j t j j | j
d | d i d
d 6�S( sv
:calls: `GET /search/commits <http://developer.github.com/v3/search>`_
:param query: string
:param sort: string ('author-date', 'committer-date')
:param order: string ('asc', 'desc')
:param qualifiers: keyword dict query qualifiers
:rtype: :class:`github.PaginatedList.PaginatedList` of :class:`github.Commit.Commit`
s author-dates committer-dateRO RP RQ RR s %s:%sRS RT s need at least one qualifiers /search/commitsR( s$ application/vnd.github.cloak-previewt Accept( s author-dates committer-date( RP RQ ( R R R R R1 R, R6 R7 RU RV RW R2 t CommitR ( R
RX RO RR RY R3 RZ R[ R ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt search_commits� s, !
c C s� t | t t f � s! t | � � | t j j k sT t | t j j � sT t | � � i | d 6} | t j j k r� d | d <| j | d <n | j j
d d d | �\ } } } | S( s�
:calls: `POST /markdown <http://developer.github.com/v3/markdown>`_
:param text: string
:param context: :class:`github.Repository.Repository`
:rtype: string
t textt gfmt modet contextt POSTs /markdownt input( R R R R R, R6 R7 RB t _identityR t requestJson( R
Rk Rn t post_parameterst statusR( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt render_markdown� s !3
c C s\ t | t t f � s! t | � � | j j d d | � \ } } t j | j | | d t �S( s�
:calls: `GET /hooks/:name <http://developer.github.com/v3/repos/hooks/>`_
:param name: string
:rtype: :class:`github.HookDescription.HookDescription`
R$ s /hooks/R+ ( R R R R R R% t HookDescriptionR' ( R
t nameR( R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_hook s
! c C sJ | j j d d � \ } } g | D]$ } t j | j | | d t �^ q" S( s�
:calls: `GET /hooks <http://developer.github.com/v3/repos/hooks/>`_
:rtype: list of :class:`github.HookDescription.HookDescription`
R$ s /hooksR+ ( R R% Rv R' ( R
R( R/ R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_hooks s c C s | j j d d � \ } } | S( s
:calls: `GET /gitignore/templates <http://developer.github.com/v3/gitignore>`_
:rtype: list of string
R$ s /gitignore/templates( R R% ( R
R( R/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_gitignore_templates) s c C s\ t | t t f � s! t | � � | j j d d | � \ } } t j | j | | d t �S( s�
:calls: `GET /gitignore/templates/:name <http://developer.github.com/v3/gitignore>`_
:rtype: :class:`github.GitignoreTemplate.GitignoreTemplate`
R$ s /gitignore/templates/R+ ( R R R R R R% t GitignoreTemplateR' ( R
Rw R( R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_gitignore_template4 s
! c C s | j j d d � \ } } | S( s�
:calls: `GET /emojis <http://developer.github.com/v3/emojis/>`_
:rtype: dictionary of type => url for emoji`
R$ s /emojis( R R% ( R
R( R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt
get_emojis@ s c C s | | j | | d t �S( s�
Creates an object from raw_data previously obtained by :attr:`github.GithubObject.GithubObject.raw_data`,
and optionaly headers previously obtained by :attr:`github.GithubObject.GithubObject.raw_headers`.
:param klass: the class of the object to create
:param raw_data: dict
:param headers: dict
:rtype: instance of class ``klass``
R+ ( R R' ( R
t klasst raw_dataR( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt create_from_raw_dataK s
i c C s) t j | j | j | j f | | � d S( s
Dumps (pickles) a PyGithub object to a file-like object.
Some effort is made to not pickle sensitive informations like the Github credentials used in the :class:`Github` instance.
But NO EFFORT is made to remove sensitive information from the object's attributes.
:param obj: the object to pickle
:param file: the file-like object to pickle to
:param protocol: the `pickling protocol <http://docs.python.org/2.7/library/pickle.html#data-stream-format>`_
N( t picklet dumpt __class__R t raw_headers( R
t objt filet protocol( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR� W s
c C s | j t j | � � S( s�
Loads (unpickles) a PyGithub object from a file-like object.
:param f: the file-like object to unpickle from
:return: the unpickled object
( R� R� t load( R
t f( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR� c s c C s; | j j d t d � \ } } t j | j | | d t �S( s�
This doesn't work with a Github Enterprise installation, because it always targets https://status.github.com.
:calls: `GET /api/status.json <https://status.github.com/api>`_
:rtype: :class:`github.Status.Status`
R$ s /api/status.jsonR+ ( R R% t DEFAULT_STATUS_URLt StatusR' ( R
R( R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_api_statusl s c C s; | j j d t d � \ } } t j | j | | d t �S( s
This doesn't work with a Github Enterprise installation, because it always targets https://status.github.com.
:calls: `GET /api/last-message.json <https://status.github.com/api>`_
:rtype: :class:`github.StatusMessage.StatusMessage`
R$ s /api/last-message.jsonR+ ( R R% R� t
StatusMessageR' ( R
R( R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_last_api_status_messagey s c C sN | j j d t d � \ } } g | D]$ } t j | j | | d t �^ q& S( s
This doesn't work with a Github Enterprise installation, because it always targets https://status.github.com.
:calls: `GET /api/messages.json <https://status.github.com/api>`_
:rtype: list of :class:`github.StatusMessage.StatusMessage`
R$ s /api/messages.jsonR+ ( R R% R� R� R' ( R
R( R/ R) ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_api_status_messages� s c C s) t j | j d i d i | d 6d t �S( s.
:param id:
:return:
R( R) RI R+ ( t InstallationR R' ( R
RI ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_installation� s N(4 t __name__t
__module__t __doc__R t DEFAULT_BASE_URLt DEFAULT_TIMEOUTt DEFAULT_PER_PAGER9 R' R t! _Github__get_FIX_REPO_GET_GIT_REFt! _Github__set_FIX_REPO_GET_GIT_REFt propertyR t _Github__get_per_paget _Github__set_per_pageR R R# R R* R, R6 R7 R0 R4 R< R> R@ RA RF RG RJ RK R\ R` Rd Rg Rj Ru Rx Ry Rz R| R} R� R� R� R� R� R� R� ( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR S sP '
###$&
t GithubIntegrationc B s, e Z d Z d � Z d � Z d d � Z RS( s?
Main class to obtain tokens for a GitHub integration.
c C s | | _ | | _ d S( sO
:param integration_id: int
:param private_key: string
N( t integration_idt private_key( R
R� R� ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR � s c C sn t t j � � } i | d 6| d d 6| j d 6} t j | d | j d d �} t rj | j d � } n | S( sN
Creates a signed JWT, valid for 60 seconds.
:return:
t iati< t expt issR. t algorithmt RS256s utf-8( R t timeR� t jwtt encodeR� t atLeastPython3t decode( R
t nowt payloadt encrypted( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt
create_jwt� s
c C ss d } | r% t j i | d 6� } n t d � } | j d d d d j | � d i d j | j � � d 6d
d 6d d
6d | � | j � } | j � } t r� | j
d � } n | j � | j d k r� t j
| � } t j d d d i d | d t � S| j d k r't j d | j d | � � n- | j d k rTt j d | j d | � � n t j d | j d | � � d S( s,
Get an access token for the given installation id.
POSTs https://api.github.com/installations/<installation_id>/access_tokens
:param user_id: int
:param installation_id: int
:return: :class:`github.InstallationAuthorization.InstallationAuthorization`
t user_ids api.github.comt methodRo R5 s /installations/{}/access_tokensR( s Bearer {}t
Authorizations/ application/vnd.github.machine-man-preview+jsonRh s PyGithub/Pythons
User-Agentt bodys utf-8i� t requesterR) R+ i� Rt R/ i� N( R R t dumpsR t requestt formatR� t getresponset readR� R� t closeRt t loadst InstallationAuthorizationR' t GithubExceptiont BadCredentialsExceptiont UnknownObjectException( R
t installation_idR� R� t connt responset
response_textR/ ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt get_access_token� sF
N( R� R� R� R R� R R� ( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyR� � s (% t urllibR� R� t syst httplibR R� R R R8 R: R? RH t github.PaginatedListR, RB R� t LegacyR- t github.GithubObjectRv R{ R� R� R& R� R� t
Invitationt
hexversionR� R� R� R� R� t objectR R� ( ( ( sA /opt/alt/python27/lib/python2.7/site-packages/github/MainClass.pyt <module>- sB � � K