Viewing: github.cpython-36.pyc
3 �N�b�� � @ s� d Z ddlZddlZddlmZ dZy,ddlZddlZddl Zddl m Z dZW n e k rd Y nX ej e�ZdZdd � Zd d � Zd d � Zd`dd�Zdadd�Zdbdd�Zdcdd�Zdddd�Zdedd�Zdfdd �Zdgd d �Zdhd"d#�Z did&d'�Z djd(d)�Z d*d+� Z dkd,d-�Z dld.d/�Z!dmd0d1�Z"dnd2d3�Z#dod4d5�Z$dpd6d7�Z%dqd8d9�Z&drd:d;�Z'dsd<d=�Z(dtd>d?�Z)dud@dA�Z*dvdBdC�Z+dwdDdE�Z,dxdFdG�Z-dydHdI�Z.dzdJdK�Z/d{dLdM�Z0d|dNdO�Z1d}dPdQ�Z2d~dRdS�Z3ddTdU�Z4d�dVdW�Z5dXdY� Z6dZd[� Z7d�d^d_�Z8dS )�a Module for interacting with the GitHub v3 API. .. versionadded:: 2016.3.0 :depends: PyGithub python module Configuration ------------- Configure this module by specifying the name of a configuration profile in the minion config, minion pillar, or master config. The module will use the 'github' key by default, if defined. For example: .. code-block:: yaml github: token: abc1234 org_name: my_organization # optional: some functions require a repo_name, which # can be set in the config file, or passed in at the CLI. repo_name: my_repo # optional: it can be dangerous to change the privacy of a repository # in an automated way. set this to True to allow privacy modifications allow_repo_privacy_changes: False � N)�CommandExecutionErrorF)�UnknownObjectExceptionT�githubc C s t rtS dS )zH Only load this module if PyGithub is installed on this minion. F�PThe github execution module cannot be loaded: PyGithub library is not installed.)Fr )�HAS_LIBS�__virtualname__� r r � /usr/lib/python3.6/github.py� __virtual__8 s r c C sD t d | �}|s tdj| ���|j|�}|dkr@tdj|| ���|S )a! Helper function that returns a profile's configuration value based on the supplied configuration name. profile The profile name that contains configuration information. config_name The configuration item's name to use to return configuration values. z config.optionzCAuthentication information could not be found for the '{}' profile.Nz5The '{}' parameter was not found in the '{}' profile.)Z__salt__r �format�get)�profileZ config_name�configZ config_valuer r r �_get_config_valueE s r c C s> t | d�}dj|t | d��}|tkr6tj|dd�t|< t| S )zK Return the GitHub client, cached into __context__ for performance �tokenz github.{}:{}�org_name�d )�per_page)r r � __context__r ZGithub)r r �keyr r r � _get_clientb s r c C s t jjt jj| j| jd |�S )Nz/members)r � PaginatedListZ NamedUser� _requester�url)� organization�paramsr r r � _get_membersn s r c C s� t | d�}dj|�}|tks(|s(|d k r�t | d�}t| �}|j|�}tjjtjj|j|j d |�}|d k rn|S g }x4|D ],} |j | � dj|| j j � �} t | �t| < qxW |t|< t| S )Nr zgithub.{}:reposz/reposzgithub.{}:{}:repo_info)r r r r �get_organizationr r Z Repositoryr r �append�name�lower� _repo_to_dict) r r � ignore_cacher r �clientr �resultZ next_result�repoZrepo_keyr r r � _get_reposw s( r& c C sR t | d�}dj|�}|tks |rJt| �}|j|�}dd� t|d�D �t|< t| S )a� List all users within the organization. profile The name of the profile configuration to use. Defaults to ``github``. ignore_cache Bypasses the use of cached users. .. versionadded:: 2016.11.0 CLI Example: .. code-block:: bash salt myminion github.list_users salt myminion github.list_users profile='my-github-profile' r zgithub.{}:usersc S s g | ] }|j �qS r )�login)�.0�memberr r r � <listcomp>� s z list_users.<locals>.<listcomp>N)r r r r r r )r r" r r r# r r r r � list_users� s r+ c C s$ | r| t |�krdS i }t|�}|jt|d��}y|j| �}W n tk r^ tjd� dS X |j|d< |j |d< |j |d< |j |d< |j |d < |j |d < |j|d < |j|d < |j|d < y"|jjd|jd |j �\}}W n& tk �r d|d< d|d< |S X |j|�|d< |jd�|d< |S )a� Get a GitHub user by name. name The user for which to obtain information. profile The name of the profile configuration to use. Defaults to ``github``. user_details Prints user information details. Defaults to ``False``. If the user is already in the organization and user_details is set to False, the get_user function returns ``True``. If the user is not already present in the organization, user details will be printed by default. CLI Example: .. code-block:: bash salt myminion github.get_user github-handle salt myminion github.get_user github-handle user_details=true Tr zResource not foundF�company� created_at�email�html_url�idr' r �typer �GETz /memberships/Z nonexistentZmembership_stateZin_org�state)r+ r r r �get_userr �log� exceptionr, r- r. r/ r0 r' r r1 r r �requestJsonAndCheck� _identity�has_in_membersr ) r r Z user_detailsZresponser# r �user�headers�datar r r r4 � s: r4 c C sr t |�}|jt|d��}y|j| �}W n tk rD tjd� dS X |jjd|j d |j �\}}|j d�dkS )a Add a GitHub user. name The user for which to obtain information. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.add_user github-handle r zResource not foundF�PUTz /memberships/r3 �pending) r r r r4 r r5 r6 r r7 r r8 r )r r r# r Zgithub_named_userr; r< r r r �add_user� s r? c C sf t |�}|jt|d��}y|j| �}W n tk rD tjd� dS X |j|�rZ|j|� |j|� S )a" Remove a Github user by name. name The user for which to obtain information. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.remove_user github-handle r zResource not foundF) r r r r4 r r5 r6 r9 �remove_from_members)r r r# r Zgit_userr r r � remove_user s rA �minc C sv t |d�}|dkr t |d�}djd||g�}dt| � }i }t|||d�}|jd�} |d krf||| < n t|�|| < |S ) aU Return information about a single issue in a named repository. .. versionadded:: 2016.11.0 issue_number The number of the issue to retrieve. repo_name The name of the repository from which to get the issue. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the repo_name defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. output The amount of data returned by each issue. Defaults to ``min``. Change to ``full`` to see all issue output. CLI Example: .. code-block:: bash salt myminion github.get_issue 514 salt myminion github.get_issue 514 repo_name=salt r N� repo_name�/�reposzissues/)�action�commandr0 �full)r �join�str�_queryr � _format_issue) � issue_numberrC r �outputr rF rG �retZ issue_data�issue_idr r r � get_issue7 s rQ c C s� t |d�}|dkr t |d�}djd||g�}djdt| �dg�}i }|rP||d< t||||d �} i } xX| D ]P} | jd �} |d kr�| | | < qj| jd �| jd �| jd �| jd�jd�d�| | < qjW | S )a Return information about the comments for a given issue in a named repository. .. versionadded:: 2016.11.0 issue_number The number of the issue for which to retrieve comments. repo_name The name of the repository to which the issue belongs. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the repo_name defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. since Only comments updated at or after this time are returned. This is a timestamp in ISO 8601 format: ``YYYY-MM-DDTHH:MM:SSZ``. output The amount of data returned by each issue. Defaults to ``min``. Change to ``full`` to see all issue output. CLI Example: .. code-block:: bash salt myminion github.get_issue_comments 514 salt myminion github.get_issue 514 repo_name=salt r NrC rD rE �issues�comments�since)rF rG �argsr0 rH r- � updated_atr: r' )r0 r- rV Z user_login)r rI rJ rK r ) rM rC r rT rN r rF rG rU rS rO ZcommentZ comment_idr r r �get_issue_commentsg s& # rW �open�created�descc C s t |d�} | dkr t |d�} djd| | g�}i }|r<||d< |rH||d< |rT||d< |r`||d < |rl||d < | rx| |d < | r�| |d < |r�|d kr�||d< |r�|dkr�||d< | r�| dkr�| |d< i }t||d|d�}xB|D ]:}|jd�r�q�|jd�}| dk�r|||< q�t|�||< q�W |S )a+ Returns information for all issues in a given repository, based on the search options. .. versionadded:: 2016.11.0 repo_name The name of the repository for which to list issues. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the repo_name defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. milestone The number of a GitHub milestone, or a string of either ``*`` or ``none``. If a number is passed, it should refer to a milestone by its number field. Use the ``github.get_milestone`` function to obtain a milestone's number. If the string ``*`` is passed, issues with any milestone are accepted. If the string ``none`` is passed, issues without milestones are returned. state Indicates the state of the issues to return. Can be either ``open``, ``closed``, or ``all``. Default is ``open``. assignee Can be the name of a user. Pass in ``none`` (as a string) for issues with no assigned user or ``*`` for issues assigned to any user. creator The user that created the issue. mentioned A user that's mentioned in the issue. labels A string of comma separated label names. For example, ``bug,ui,@high``. sort What to sort results by. Can be either ``created``, ``updated``, or ``comments``. Default is ``created``. direction The direction of the sort. Can be either ``asc`` or ``desc``. Default is ``desc``. since Only issues updated at or after this time are returned. This is a timestamp in ISO 8601 format: ``YYYY-MM-DDTHH:MM:SSZ``. output The amount of data returned by each issue. Defaults to ``min``. Change to ``full`` to see all issue output. per_page GitHub paginates data in their API calls. Use this value to increase or decrease the number of issues gathered from GitHub, per page. If not set, GitHub defaults are used. Maximum is 100. CLI Example: .. code-block:: bash salt myminion github.get_issues my-github-repo r NrC rD rE � milestone�assignee�creator� mentioned�labelsrT r rX r3 rY �sortrZ � directionrR )rF rG rU Z pull_requestr0 rH )r rI rK r rL )rC r r[ r3 r\ r] r^ r_ r` ra rT rN r r rF rU rO rR �issuerP r r r � get_issues� sF U rc �due_on�ascc C s� t |d�}| dkr t |d�} djd|| g�}i } |r<|| d< |rP|dkrP|| d< |rd|d krd|| d < |rx|d krx|| d < i } t||d | d�} xN| D ]F} | jd�} |dkr�| | | < q�| jd� | jd� | jd� | | | < q�W | S )a� Return information about milestones for a given repository. .. versionadded:: 2016.11.0 repo_name The name of the repository for which to list issues. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the repo_name defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. state The state of the milestone. Either ``open``, ``closed``, or ``all``. Default is ``open``. sort What to sort results by. Either ``due_on`` or ``completeness``. Default is ``due_on``. direction The direction of the sort. Either ``asc`` or ``desc``. Default is ``asc``. output The amount of data returned by each issue. Defaults to ``min``. Change to ``full`` to see all issue output. per_page GitHub paginates data in their API calls. Use this value to increase or decrease the number of issues gathered from GitHub, per page. If not set, GitHub defaults are used. CLI Example: .. code-block:: bash salt myminion github.get_milestones r NrC rD rE r rX r3 rd r` re ra � milestones)rF rG rU r0 rH r] r/ � labels_url)r rI rK r �pop)rC r r3 r` ra rN r r rF rU rO rf r[ � milestone_idr r r �get_milestones+ s0 2 rj c C s� i }t | |g�std��t|d�}|dkr4t|d�}djd||g�}| r�dt| � }t|||d�} | jd �} |d kr~| || < n&| jd � | jd � | jd � | || < |S t|||d�} x.| j � D ]"\} } | jd�|kr�| || < |S q�W |S )a� Return information about a single milestone in a named repository. .. versionadded:: 2016.11.0 number The number of the milestone to retrieve. If provided, this option will be favored over ``name``. name The name of the milestone to retrieve. repo_name The name of the repository for which to list issues. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the repo_name defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. output The amount of data returned by each issue. Defaults to ``min``. Change to ``full`` to see all issue output. CLI Example: .. code-block:: bash salt myminion github.get_milestone 72 salt myminion github.get_milestone name=my_milestone z7Either a milestone 'name' or 'number' must be provided.r NrC rD rE z milestones/)rF rG r0 rH r] r/ rg )rC r rN �title) �anyr r rI rJ rK r rh rj �items)�numberr rC r rN rO r rF rG Zmilestone_datari rf r �valr r r � get_milestone s2 $ rp c C s� i }| j |d< | j|d< | j|d< | jj|d< | j|d< | j|d< | j|d< | j|d< | j |d < | j |d < | j |d < | j |d < | j |d < | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< | j|d< |S )Nr0 r � full_name�owner�privater/ � description�fork�homepage�size�stargazers_count�watchers_count�language�open_issues_count�forks� open_issues�watchers�default_branch� has_issues�has_wiki� has_downloads)r0 r rq rr r' rs r/ rt ru rv rw rx ry rz r{ r| r} r~ r r� r� r� )r% rO r r r r! � s. r! c C s� t |d�}djt |d�| j� �}|tks,|r�t|�}y0|jdj|| g��}|sRi S t|�}|t|< W n& tj k r� t dj| |���Y nX t| S )a� Return information for a given repo. .. versionadded:: 2016.11.0 repo_name The name of the repository. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.get_repo_info salt salt myminion github.get_repo_info salt profile='my-github-profile' r zgithub.{}:{}:repo_inforD zCThe '{}' repository under the '{}' organization could not be found.) r r r r r �get_reporI r! r r r )rC r r" r r r# r% rO r r r � get_repo_info� s r� c C s� g }t |d�}t|�}y|jdj|| g��}W n& tjk rT tdj| |���Y nX y2|j� }x$|D ] }|j |j |j |j d�� qfW W n& tjk r� tdj| |���Y nX |S )a� Return teams belonging to a repository. .. versionadded:: 2017.7.0 repo_name The name of the repository from which to retrieve teams. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.get_repo_teams salt salt myminion github.get_repo_teams salt profile='my-github-profile' r rD zCThe '{}' repository under the '{}' organization could not be found.)r0 r � permissionzIUnable to retrieve teams for repository '{}' under the '{}' organization.) r r r� rI r r r r � get_teamsr r0 r r� )rC r rO r r# r% �teams�teamr r r �get_repo_teams s& r� c C s dd� t | �D �S )a� List all repositories within the organization. Includes public and private repositories within the organization Dependent upon the access rights of the profile token. .. versionadded:: 2016.11.0 profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.list_repos salt myminion github.list_repos profile='my-github-profile' c S s g | ] }|j �qS r )r )r( r% r r r r* M s z list_repos.<locals>.<listcomp>)r& )r r r r � list_repos; s r� c C s0 g }x&t | �D ]}|jdkr|j|j� qW |S )a� List private repositories within the organization. Dependent upon the access rights of the profile token. .. versionadded:: 2016.11.0 profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.list_private_repos salt myminion github.list_private_repos profile='my-github-profile' T)r& rs r r )r rE r% r r r �list_private_reposP s r� c C s0 g }x&t | �D ]}|jdkr|j|j� qW |S )a^ List public repositories within the organization. .. versionadded:: 2016.11.0 profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.list_public_repos salt myminion github.list_public_repos profile='my-github-profile' F)r& rs r r )r rE r% r r r �list_public_reposh s r� c C s� yzt | �} | jt| d��} ||||||||| d� } d| i}x$| j� D ]\}}|dk rD|||< qDW | jjd| jd |d� dS tjk r� t j d � d S X dS ) a$ Create a new github repository. name The name of the team to be created. description The description of the repository. homepage The URL with more information about the repository. private The visiblity of the repository. Note that private repositories require a paid GitHub account. has_issues Whether to enable issues for this repository. has_wiki Whether to enable the wiki for this repository. has_downloads Whether to enable downloads for this repository. auto_init Whether to create an initial commit with an empty README. gitignore_template The desired language or platform for a .gitignore, e.g "Haskell". license_template The desired LICENSE template to apply, e.g "mit" or "mozilla". profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.add_repo 'repo_name' .. versionadded:: 2016.11.0 r ) rt rv rs r� r� r� � auto_init�gitignore_template�license_templater N�POSTz/repos)�inputTzError creating a repoF) r r r rm r r7 r r �GithubExceptionr5 r6 )r rt rv rs r� r� r� r� r� r� r r# r � given_params� parameters� param_name� param_valuer r r �add_repo s, : r� c C s� yt |d�}W n tk r& d}Y nX |dk rD| rDtdj| ���y�t|�} | jt |d��} | j| �} ||||||d�} d| i} x$| j� D ]\}}|dk r�|| |< q�W | jjd| j | d � t | |d d � d S t j k r� t jd � dS X dS ) a Updates an existing Github repository. name The name of the team to be created. description The description of the repository. homepage The URL with more information about the repository. private The visiblity of the repository. Note that private repositories require a paid GitHub account. has_issues Whether to enable issues for this repository. has_wiki Whether to enable the wiki for this repository. has_downloads Whether to enable downloads for this repository. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.add_repo 'repo_name' .. versionadded:: 2016.11.0 Zallow_repo_privacy_changesFNzaThe private field is set to be changed for repo {} but allow_repo_privacy_changes disallows this.r )rt rv rs r� r� r� r �PATCH)r� T)r r" zError editing a repo)r r r r r r� rm r r7 r r� r r� r5 r6 )r rt rv rs r� r� r� r Zallow_private_changer# r r% r� r� r� r� r r r � edit_repo� s8 / r� c C s� t | |d�}|s tjd| � dS y:t|�}|jt|d��}|j| �}|j� t|dd� dS t j k rz tj d� dS X dS ) a= Remove a Github repository. name The name of the repository to be removed. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.remove_repo 'my-repo' .. versionadded:: 2016.11.0 )r z%Repo %s to be removed does not exist.Fr T)r r" zError deleting a repoN) r� r5 �errorr r r r� �deleter& r r� r6 )r r Z repo_infor# r r% r r r � remove_repo* s r� c C s t |�j| �S )aZ Returns the team details if a team with the given name exists, or None otherwise. name The team name for which to obtain information. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.get_team 'team_name' )� list_teamsr )r r r r r �get_teamL s r� c C s� y�t |�}|jt|d��}i }| |d< |dk r6||d< |dk rF||d< |dk rV||d< |dk rf||d< |jjd|jd |d � td d � d S tjk r� t j d � dS X dS )a� Create a new Github team within an organization. name The name of the team to be created. description The description of the team. repo_names The names of repositories to add the team to. privacy The level of privacy for the team, can be 'secret' or 'closed'. permission The default permission for new repositories added to the team, can be 'pull', 'push' or 'admin'. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.add_team 'team_name' .. versionadded:: 2016.11.0 r r Nrt � repo_namesr� �privacyr� z/teams)r� T)r" zError creating a teamF) r r r r r7 r r� r r� r5 r6 ) r rt r� r� r� r r# r r� r r r �add_team` s( & r� c C s� t | |d�}|s tjd| � dS y�t|�}|jt|d��}|j |d �}i }| dk r\| |d< |dk rl||d< |dk r|||d < |dk r�||d < |jjd |j|d � d S t k r� tj d� dS X dS )af Updates an existing Github team. name The name of the team to be edited. description The description of the team. privacy The level of privacy for the team, can be 'secret' or 'closed'. permission The default permission for new repositories added to the team, can be 'pull', 'push' or 'admin'. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.edit_team 'team_name' description='Team description' .. versionadded:: 2016.11.0 )r zTeam %s does not existFr r0 Nr rt r� r� r� )r� TzResource not found) r� r5 r� r r r r r7 r r r6 ) r rt r� r� r r� r# r r� r r r � edit_team� s, r� c C s� t | |d�}|s tjd| � dS yDt|�}|jt|d��}|j |d �}|j� td|d�j| �dkS t j k r� tj d � dS X dS ) a3 Remove a github team. name The name of the team to be removed. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.remove_team 'team_name' .. versionadded:: 2016.11.0 )r z%Team %s to be removed does not exist.Fr r0 T)r" r NzError deleting a team) r� r5 r� r r r r� r� r r r� r6 )r r Z team_infor# r r� r r r � remove_team� s r� c C s t | |d�}|s tjd| � dS |jd�r:| r:|jd�S y*t|�}|jt|d��}|j |d �}W n$ tk r� tjd|d � Y nX yRi }x@|j � D ]4}d} |j j r�d } n |j j r�d } d | i||j j� < q�W ||d< |S tk �r tjd|d � g S X d S ) a� Gets the repo details for a given team as a dict from repo_name to repo details. Note that repo names are always in lower case. team_name The name of the team from which to list repos. profile The name of the profile configuration to use. Defaults to ``github``. ignore_cache Bypasses the use of cached team repos. CLI Example: .. code-block:: bash salt myminion github.list_team_repos 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not exist.FrE r r0 zResource not found: %sZpull�admin�pushr� N)r� r5 r� r r r r r r6 Z get_reposZ permissionsr� r� r r ) � team_namer r" � cached_teamr# r r� rE r% r� r r r �list_team_repos� s4 r� c C s� t ||d�}|s tjd|� dS y4t|�}|jt|d��}|j |d �}|j| �}W n$ tk rx tjd|d � dS X d}|dk r�d|i}|j j d |j d |j |d �\} } t ||d d � d S )a� Adds a repository to a team with team_name. repo_name The name of the repository to add. team_name The name of the team of which to add the repository. profile The name of the profile configuration to use. Defaults to ``github``. permission The permission for team members within the repository, can be 'pull', 'push' or 'admin'. If not specified, the default permission specified on the team will be used. .. versionadded:: 2017.7.0 CLI Example: .. code-block:: bash salt myminion github.add_team_repo 'my_repo' 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not existFr r0 zResource not found: %sNr� r= z/repos/)r� T)r r" )r� r5 r� r r r r� r r6 r r7 r r8 r� ) rC r� r r� r� r# r r% r r; r< r r r � add_team_repo, s& r� c C s� t ||d�}|s tjd|� dS y4t|�}|jt|d��}|j |d �}|j| �}W n$ tk rx tjd|d � dS X |j |� | t ||dd�kS ) a� Removes a repository from a team with team_name. repo_name The name of the repository to remove. team_name The name of the team of which to remove the repository. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.remove_team_repo 'my_repo' 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not existFr r0 zResource not found: %sT)r r" ) r� r5 r� r r r r� r r6 Zremove_from_reposr� )rC r� r r� r# r r% r r r �remove_team_repo` s r� c C s� t | |d�}|s tjd| � dS |jd�r:| r:|jd�S y*t|�}|jt|d��}|j |d �}W n$ tk r� tjd|d � Y nX y dd � |j � D �|d< |d S tk r� tjd|d � g S X d S ) a� Gets the names of team members in lower case. team_name The name of the team from which to list members. profile The name of the profile configuration to use. Defaults to ``github``. ignore_cache Bypasses the use of cached team members. CLI Example: .. code-block:: bash salt myminion github.list_team_members 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not exist.F�membersr r0 zResource not found: %sc S s g | ]}|j j� �qS r )r' r )r( r) r r r r* � s z%list_team_members.<locals>.<listcomp>N) r� r5 r� r r r r r r6 Z get_members)r� r r" r� r# r r� r r r �list_team_members� s$ r� c C sn dj t| d��}|tks |rft| �}|jt| d��}d}ttjjd�rJd}dd� t||di�D �t|< t| S ) aa List all members (in lower case) without MFA turned on. profile The name of the profile configuration to use. Defaults to ``github``. ignore_cache Bypasses the use of cached team repos. CLI Example: .. code-block:: bash salt myminion github.list_members_without_mfa .. versionadded:: 2016.11.0 zgithub.{}:non_mfa_usersr �filterZ membershipZfilter_c S s g | ]}|j j� �qS r )r' r )r( �mr r r r* � s z,list_members_without_mfa.<locals>.<listcomp>Z 2fa_disabled) r r r r r �hasattrr ZTeamr )r r" r r# r Z filter_keyr r r �list_members_without_mfa� s r� c C s | j � t||d�kS )a� Returns True if the github user is in the team with team_name, or False otherwise. name The name of the user whose membership to check. team_name The name of the team to check membership in. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.is_team_member 'user_name' 'team_name' .. versionadded:: 2016.11.0 )r )r r� )r r� r r r r �is_team_member� s r� c C s� t ||d�}|s tjd|� dS y4t|�}|jt|d��}|j |d �}|j| �}W n$ tk rx tjd|d � dS X y0|j j d|j d |j d d id d id �\}}W n t jk r� tjd � dS X d S )a� Adds a team member to a team with team_name. name The name of the team member to add. team_name The name of the team of which to add the user. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.add_team_member 'user_name' 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not existFr r0 zResource not found: %sr= z /memberships/Zroler) )r� r� z"Error in adding a member to a teamT)r� r5 r� r r r r4 r r6 r r7 r r8 r r� ) r r� r r� r# r r) r; r< r r r �add_team_member� s, r� c C s� t ||d�}|s tjd|� dS y4t|�}|jt|d��}|j |d �}|j| �}W n$ tk rx tjd|d � dS X t |d�s�d S |j |� |j |� S ) a� Removes a team member from a team with team_name. name The name of the team member to remove. team_name The name of the team from which to remove the user. profile The name of the profile configuration to use. Defaults to ``github``. CLI Example: .. code-block:: bash salt myminion github.remove_team_member 'user_name' 'team_name' .. versionadded:: 2016.11.0 )r zTeam %s does not existFr r0 zResource not found: %sr@ �KPyGithub 1.26.0 or greater is required for team management, please upgrade.)Fr� ) r� r5 r� r r r r4 r r6 r� r@ r9 )r r� r r� r# r r) r r r �remove_team_member! s" r� c C s� dj t| d��}|tks |r~t| �}|jt| d��}|j� }i }x4|D ],}|j|j|jd |j |jd d�||j < qFW |t|< t| S )a= Lists all teams with the organization. profile The name of the profile configuration to use. Defaults to ``github``. ignore_cache Bypasses the use of cached teams. CLI Example: .. code-block:: bash salt myminion github.list_teams .. versionadded:: 2016.11.0 zgithub.{}:teamsr rt r� )r0 �slugrt r� r� ) r r r r r r� r0 r� Z_rawDatar� r )r r" r r# r Z teams_datar� r� r r r r� O s r� c C s� t |d�} | dkr t |d�} djd| | g�} i } |r<|| d< |rH|| d< |rT|| d< |rh|d krh|| d < |r||d kr||| d < |r�|d kr�|| d< i } t|| d| d�} x4| D ],}|jd�}|dkr�|| |< q�t|�| |< q�W | S )aN Returns information for all pull requests in a given repository, based on the search options provided. .. versionadded:: 2017.7.0 repo_name The name of the repository for which to list pull requests. This argument is required, either passed via the CLI, or defined in the configured profile. A ``repo_name`` passed as a CLI argument will override the ``repo_name`` defined in the configured profile, if provided. profile The name of the profile configuration to use. Defaults to ``github``. state Indicates the state of the pull requests to return. Can be either ``open``, ``closed``, or ``all``. Default is ``open``. head Filter pull requests by head user and branch name in the format of ``user:ref-name``. Example: ``'github:new-script-format'``. Default is ``None``. base Filter pulls by base branch name. Example: ``gh-pages``. Default is ``None``. sort What to sort results by. Can be either ``created``, ``updated``, ``popularity`` (comment count), or ``long-running`` (age, filtering by pull requests updated within the last month). Default is ``created``. direction The direction of the sort. Can be either ``asc`` or ``desc``. Default is ``desc``. output The amount of data returned by each pull request. Defaults to ``min``. Change to ``full`` to see all pull request output. per_page GitHub paginates data in their API calls. Use this value to increase or decrease the number of pull requests gathered from GitHub, per page. If not set, GitHub defaults are used. Maximum is 100. CLI Example: .. code-block:: bash salt myminion github.get_prs salt myminion github.get_prs base=2016.11 r NrC rD rE �head�baser rX r3 rY r` rZ ra Zpulls)rF rG rU r0 rH )r rI rK r � _format_pr)rC r r3 r� r� r` ra rN r r rF rU rO Zprs�pr_Zpr_idr r r �get_prsy s2 A r� c C sN | j d�| j d�| j d�| j d�| j d�j d�| j d�| j d�j d �d �}|S ) z� Helper function to format API return information into a more manageable and useful dictionary for pull request information. pr_ The pull request to format. r0 rn r3 rk r: r' r/ r� �ref)r0 Z pr_numberr3 rk r: r/ Z base_branch)r )r� rO r r r r� � s r� c C s� | j d�| j d�| j d�| j d�| j d�j d�| j d�d�}| j d �}|rT|j d�}| j d �}g }x |D ]}|j|j d �� qhW | j d �}|r�|j d�}||d < ||d < ||d < |S ) z� Helper function to format API return information into a more manageable and useful dictionary for issue information. issue The issue to format. r0 rn r3 rk r: r' r/ )r0 rM r3 rk r: r/ r\ r_ r r[ )r r )rb rO r\ r_ Z label_namesZlabelr[ r r r rL � s( rL r2 �https://api.github.com/c C s� t |t�si }|r||7 }|r,|dj|�7 }tjd|� d|j� krRt| d�|d< |rjd|j� krj||d< |dkrvi }|dkr�d|d < d } |d kr�d } g } d } d } x�| d k�r�| r�| |d< tjj j |||||| dd d d dgt d� } tjd| d � | d dk�r&t | d t��r| d S | | d } nt dj| j d����y | j d�j d�jd�d }W n tk �rt d } w�Y nX d|k�r�|jd �d jd �d } q�d } q�W | S ) zL Make a web call to the GitHub API and deal with paginated results. z/{}zGitHub URL: %sZ access_tokenr r Nr� zapplication/jsonZAcceptTZDELETEF� ZpageZjson) r r< � header_dict�decodeZ decode_typer; �status�textZ hide_fieldsZoptsz GitHub Response Status Code: %sr� �� �dictzGitHub Response Error: {}r� r; ZLink�,r �next�>z&page=� )� isinstancer� r r5 �debug�keysr �saltZutilsZhttpZqueryZ__opts__r r �split�AttributeError)r rF rG rU �methodr� r< r r r� Zcomplete_resultZ next_pageZ page_numberr$ Z link_infor r r rK sj rK )N)NF)r F)r F)r )r )Nr rB )Nr NrB ) Nr NrX NNNNrY rZ NrB N)Nr rX rd re rB N)NNNr rB )r F)r )r )r )r ) NNNNNNNNNr )NNNNNNr )r )r )NNNNr )NNNr )r )r F)r N)r )r F)r F)r )r )r )r F) Nr rX NNrY rZ rB N)NNNr2 NNr� N)9�__doc__ZloggingZsalt.utils.httpr� Zsalt.exceptionsr r r Zgithub.PaginatedListZgithub.NamedUserZgithub.GithubExceptionr � ImportErrorZ getLogger�__name__r5 r r r r r r& r+ r4 r? rA rQ rW rc rj rp r! r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� rL rK r r r r �<module> s� # @ ! 1 ? y N F / , M M " 9 6 ! 6 4 ' + % 1 . + \'
Return