_Og%SrSSKrSSKJr SSKJr SSKJr SSKJ r SSK J r SS K J r SS KJr SS KJr SS KJr \R&(aSSKJ r "S S\5r"SS\R,5r"SS\5r"SS\5r"SS\R,5r"SS\5r"SS\5r"SS\R,5r"SS\R,5r"SS \R,5rg)!zAThis module contains all of the classes related to organizations.N)dumps) URITemplate)models)users) requires_auth)Event)Project) Repository)ShortRepositoryc0^\rSrSrSrSU4SjjrSrU=r$)ShortRepositoryWithPermissionsc8>[TU]U5 USUlg)N permissions)super_update_attributesr)selfrepo __class__s Q/Users/admin/workspace/ai/Jarvis/env/lib/python3.13/site-packages/github3/orgs.pyr1ShortRepositoryWithPermissions._update_attributess "4( .)r)returnN)__name__ __module__ __qualname____firstlineno__ class_namer__static_attributes__ __classcell__rs@rrrs1J//rrc ~\rSrSrSrSr\"SS/5r\RS/5r Sr Sr \ SSj5r \ SS j5r\ S 5r\ SS \S \S\R$\S\R$\4Sjj5r\ S5r\ SSj5r\ S\S\4Sj5r\ SSj5r\ S5r\ S5r\ S5rSrg ) _Teamz$Base class for Team representations.member maintainerallc.USUlUSUl[US5UlUSUlUSUlUR S5UlUSUlUSUl SUl UR S 5nU(a[X 5Ul gg) Nurlid members_urlname permissionprivacyrepositories_urlslugparent) _apir+r members_urltr-r.getr/r0r1r2 ShortTeam)rteamr2s rr_Team._update_attributes#sK t*'](;<L |,xx   !%%7 8L  (# #F1DK rc SRUS9$)Nz<{s.class_name} [{s.name}]>)s)formatrs r_repr _Team._repr3s,33d3;;rc X R;a<[SRSR[ UR5555eSU0nUR SXR S9nURURXCS9S5$)a Add or update the user's membership in this team. This returns a dictionary like so:: { 'state': 'pending', 'url': 'https://api.github.com/teams/...', 'role': 'member', } :param str username: (required), login of user whose membership is being modified :param str role: (optional), the role the user should have once their membership has been modified. Options: 'member', 'maintainer'. Default: 'member' :returns: dictionary of the invitation response :rtype: dict 'role' must be one of {}, role membershipsbase_urljson) member_roles ValueErrorr;joinsorted _build_urlr3_json_put)rusernamerBdatar*s radd_or_update_membership_Team.add_or_update_membership6s. (( (*11IIfT%6%678  ~oomX oJzz$))C)3S99rc0nU(aSU0nURSXRS9nURURU[ U5S9SS5$)a<Add ``repository`` to this team. If a permission is not provided, the team's default permission will be assigned, by GitHub. :param str repository: (required), form: 'user/repo' :param str permission: (optional), ('pull', 'push', 'admin') :returns: True if successful, False otherwise :rtype: bool r.reposrDrQ)rMr3_booleanrOr)r repositoryr.rQr*s radd_repository_Team.add_repositoryWsP   *-DoogzIIoF}}TYYstY=sCHHrcZURURUR5SS5$)zVDelete this team. :returns: True if successful, False otherwise :rtype: bool rWrXrY_deleter3r<s rdelete _Team.deletem$}}T\\$))4c3??rNr-r.parent_team_idr/cU(alSU0nU(aX%S'UbX5S'US;aXES'URURUR[U5S9S5nU(aUR U5 gg ) aEdit this team. :param str name: (required), the new name of this team :param str permission: (optional), one of ('pull', 'push', 'admin') .. deprecated:: 3.0.0 This was deprecated by the GitHub API. :param int parent_team_id: (optional), id of the parent team for this team :param str privacy: (optional), one of "closed" or "secret" :returns: True if successful, False otherwise :rtype: bool r-r.rc>closedsecretr/rVrHTFrN_patchr3rr)rr-r.rcr/rQrGs redit _Team.editxsv4 4:D>D%/\"))7%&..")Y::dkk$))%+kFLD''-rczURSXRS9nURURU5SS5$)zCheck if this team has access to ``repository``. :param str repository: (required), form: 'user/repo' :returns: True if the team can access the repository, False otherwise :rtype: bool rUrDrWrXrMr3rY_getrrZr*s rhas_repository_Team.has_repositorys5oogzIIoF}}TYYs^S#66rc 0n0nXR;a XS'SUS'URSURS9nUR[ U5U[ R UUUS9$)aIterate over the members of this team. :param str role: (optional), filter members returned by their role in the team. Can be one of: ``"member"``, ``"maintainer"``, ``"all"``. Default: ``"all"``. :param int number: (optional), number of users to iterate over. Default: -1 iterates over all values :param str etag: (optional), ETag from a previous request to the same endpoint :returns: generator of the members of this team :rtype: :class:`~github3.users.ShortUser` rB+application/vnd.github.ironman-preview+jsonAcceptmembersrDparamsetagheaders)filterable_member_rolesrMr3_iterintr ShortUser)rrBnumberrwrxrvr*s rrt _Team.memberssq$ // /!6N MGH ooi$))o<zz K  OO   rrZrcSS0nURSXRS9nURURX2S9S5n[ X@5$)Nrsz)application/vnd.github.v3.repository+jsonrUrDrxrH)rMr3rNrmr)rrZrxr*rGs rpermissions_for_Team.permissions_forsKHIoogzIIoFzz$))C)93?-d99rctURSURS9nUR[U5U[US9$)azIterate over the repositories this team has access to. :param int number: (optional), number of repos to iterate over. Default: -1 iterates over all values :param str etag: (optional), ETag from a previous request to the same endpoint :returns: generator of repositories this team has access to :rtype: :class:`~github3.orgs.ShortRepositoryWithPermissions` rUrDrw)rMr3rzr{rrr}rwr*s r repositories_Team.repositoriess@oog o:zz K  *   rcURSXRS9nURURU5S5nU=(d 0$)zRetrieve the membership information for the user. :param str username: (required), name of the user :returns: dictionary with the membership :rtype: dict rCrDrHrMr3rNrmrrPr*rGs rmembership_for_Team.membership_fors<oomX oJzz$))C.#.zrrczURSXRS9nURURU5SS5$)zRevoke this user's team membership. :param str username: (required), name of the team member :returns: True if successful, False otherwise :rtype: bool rCrDrWrXrMr3rYr_rrPr*s rrevoke_membership_Team.revoke_memberships6oomX oJ}}T\\#.S99rczURSXRS9nURURU5SS5$)zRemove ``repository`` from this team. :param str repository: (required), form: 'user/repo' :returns: True if successful, False otherwise :rtype: bool rUrDrWrXrrns rremove_repository_Team.remove_repository s6oogzIIoF}}T\\#.S99r) r3r+r4r-r2r.r/r0r1r&)rNN)NNrN)rrrr__doc__r frozensetrIunionryrr=rrRr[r`strtOptionalr{rirortrrrrrrr rrr$r$sj.Jh 56L*00%92 <::@II*@@*.#' %%% 3 % C %%N 7 7  @:: '::  *   : : : :rr$c0^\rSrSrSrSrU4SjrSrU=r$)TeamiaJObject representing a team in the GitHub API. In addition to the attributes on a :class:`~github3.orgs.ShortTeam` a Team has the following attribute: .. attribute:: created_at A :class:`~datetime.datetime` instance representing the time and date when this team was created. .. attribute:: members_count The number of members in this team. .. attribute:: organization A :class:`~github3.orgs.ShortOrganization` representing the organization this team belongs to. .. attribute:: repos_count The number of repositories this team can access. .. attribute:: updated_at A :class:`~datetime.datetime` instance representing the time and date when this team was updated. Please see GitHub's `Team Documentation`_ for more information. .. _Team Documentation: http://developer.github.com/v3/orgs/teams/ c>[TU]U5 URUS5UlUSUl[ USU5UlUSUlURUS5Ulg)N created_at members_count organization repos_count updated_at) rr _strptimerrShortOrganizationrrr)rr7rs rrTeam._update_attributes?sh "4(..l);<!/2-d>.BDI ...l);<r)rrrrr rrrrrrrr r!r"s@rrrs DJ==rrc \rSrSrSrSr\rSrg)r6iHatObject representing a team in the GitHub API. .. attribute:: id Unique identifier for this team across all of GitHub. .. attribute:: members_count The number of members in this team. .. attribute:: members_urlt A :class:`~uritemplate.URITemplate` instance to either retrieve all members in this team or to test if a user is a member. .. attribute:: name The human-readable name provided to this team. .. attribute:: permission The level of permissions this team has, e.g., ``push``, ``pull``, or ``admin``. .. attribute:: privacy The privacy level of this team inside the organization. .. attribute:: repos_count The number of repositories this team can access. .. attribute:: repositories_url The URL of the resource to enumerate all repositories this team can access. .. attribute:: slug The handle for this team or the portion you would use in an at-mention after the ``/``, e.g., in ``@myorg/myteam`` the slug is ``myteam``. Please see GitHub's `Team Documentation`_ for more information. .. _Team Documentation: http://developer.github.com/v3/orgs/teams/ rN) rrrrrrr _refresh_tor rrrr6r6Hs/bJKrr6c\rSrSrSrSr\"SS/5r\"SS/5r\RS/5r \"/SQ5r Sr S r \SAS j5r\S 5r\SBS \S\R&\S\R*\R.S S 44Sjj5r\S\R2S\4Sj5r\S\R2S\4Sj5r\S\R2S\4Sj5r\S/S4Sj5r\SCSj5r\SDSj5r \S5r!\//SS S4S\S\R&\RD\S\R&\RF\RD\\RDS 4S!\S"\R&\S#\4 S$jj5r$\SES%j5r%\S&5r&\SBS'j5r'\SFS(j5r(\S)5r)\S*5r*S+r+S,r,SBS-jr-SBS.jr.\SBS/j5r/SGS0jr0\S15r1SBS2jr2SHS3jr3SBS4jr4\S55r5SIS6jr6\SBS7j5r7\S\S\4S8j5r8\S\S\4S9j5r9\S:\RF\:\;\4S;\4S<j5r<\S;\S\R&\=4S=j5r>\S>\S\R&\=4S?j5r?S@r@g )J _Organizationi~zThe :class:`Organization ` object. Please see GitHub's `Organization Documentation`_ for more information. .. _Organization Documentation: http://developer.github.com/v3/orgs/ 2fa_disabledr(adminr&)r direct_memberbilling_managercUSUlUSUlUSUlUSUlUSUlUSUlUSUlUSUl[US 5Ul US Ul US =Ul Ul S Ul g) N avatar_url description events_url hooks_urlr+ issues_urlloginr,public_members_url repos_urlr* Organization)rrrrr+rrr,rpublic_members_urltrr*r3type)rorgs rr _Organization._update_attributessl+}-l+[)d)l+\ }-#.s3G/H#I [)"5z)49" rcNSn[USS5nUbSU3nSRXS9$)Nrr-:z%<{s.class_name} [{s.login}{display}]>)r:display)getattrr;)r display_namer-s rr=_Organization._reprsA tVT*  tf:L6==>  rc RX R;a<[SRSR[ UR5555eSU0nUR S[ U5URS9nURURXCS9S5nUR[U5$)anAdd a member or update their role. :param str username: (required), user to add or update. :param str role: (optional), role to give to the user. Options are ``member``, ``admin``. Defaults to ``member``. :returns: the created or updated membership :rtype: :class:`~github3.orgs.Membership` :raises: ValueError if role is not a valid choice r@rArBrCrDrFrH) rIrJr;rKrLrMrr3rNrO_instance_or_null Membership)rrPrBrQr*rGs rrR&_Organization.add_or_update_memberships (( (*11IIfT%6%678  ~oo 3x=499 zz$))C)3S9%%j$77rc [U5S:agURS[UR5S[U5S[U55nUR UR U5SS5$)aAdd ``repository`` to ``team``. .. versionchanged:: 1.0 The second parameter used to be ``team`` but has been changed to ``team_id``. This parameter is now required to be an integer to improve performance of this method. :param str repository: (required), form: 'user/repo' :param int team_id: (required), team id :returns: True if successful, False otherwise :rtype: bool rF organizationsr7rUrWrX)r{rMrr+rYrOrrZteam_idr*s rr[_Organization.add_repositorys`& wC   D ::djjj8#>D/3+==rcURSURS9nXS.nURURX4[R S9S5nUR [U5$)aZCreate a project for this organization. If the client is authenticated and a member of the organization, this will create a new project in the organization. :param str name: (required), name of the project :param str body: (optional), the body of the project :returns: the new project :rtype: :class:`~github3.projects.Project` projectsrD)r-bodyrr)rMr3rNrr CUSTOM_HEADERSr)rr-rr*rQrGs rcreate_project_Organization.create_projectMs] ooj499o=+zz JJs'*@*@J A3 %%gt44rc URSURS9n UUUUUUU UU U S. n [U5S:aU RSU05 UR UR X5S5nUR [U5$)a=Create a repository for this organization. If the client is authenticated and a member of the organization, this will create a new repository in the organization. ``name`` should be no longer than 100 characters :param str name: (required), name of the repository .. warning:: this should be no longer than 100 characters :param str description: (optional) :param str homepage: (optional) :param bool private: (optional), If ``True``, create a private repository. API default: ``False`` :param bool has_issues: (optional), If ``True``, enable issues for this repository. API default: ``True`` :param bool has_wiki: (optional), If ``True``, enable the wiki for this repository. API default: ``True`` :param int team_id: (optional), id of the team that will be granted access to this repository :param bool auto_init: (optional), auto initialize the repository. :param str gitignore_template: (optional), name of the template; this is ignored if auto_int is False. :param str license_template: (optional), name of the license; this is ignored if auto_int is False. :param bool has_projects: (optional), If ``True``, enable projects for this repository. API default: ``True`` :returns: the created repository :rtype: :class:`~github3.repos.Repository` rUrD) r-rhomepageprivate has_issueshas_wikilicense_template auto_initgitignore_template has_projectsrrr)rMr3r{updaterNrrr )rr-rrrrrrrrrrr*rQrGs rcreate_repository_Organization.create_repositorydstoog o:& $ 0""4(   w: ;oog o:zz$**S/5%%dD11s B>Cc Sn UUUUUUUUU U S. n URU 5 U (a3URURUR[ U 5S9S5n U (aUR U 5 gg)arEdit this organization. :param str billing_email: (optional) Billing email address (private) :param str company: (optional) :param str email: (optional) Public email address :param str location: (optional) :param str name: (optional) :param str description: (optional) The description of the company. :param bool has_organization_projects: (optional) Toggles whether organization projects are enabled for the organization. :param bool has_repository_projects: (optional) Toggles whether repository projects are enabled for repositories that belong to the organization. :param string default_repository_permission: (optional) Default permission level members have for organization repositories: - ``read`` -- (default) can pull, but not push to or administer this repository. - ``write`` -- can pull and push, but not administer this repository. - ``admin`` -- can pull, push, and administer this repository. - ``none`` -- no permissions granted by default. :param bool members_can_create_repositories: (optional) Toggles ability of non-admin organization members to create repositories: - ``True`` -- (default) all organization members can create repositories. - ``False`` -- only admin members can create repositories. :returns: True if successful, False otherwise :rtype: bool N) billing_emailcompanyemaillocationr-rhas_organization_projectshas_repository_projectsdefault_repository_permissionmembers_can_create_repositoriesrVrHTF) _remove_nonerNrhr3rr) rrrrrr-rrrrrrGrQs rri_Organization.edits~p* &)B'>-J/N   $ ::dkk$))%+kFLD   # #D )rcSn[U5S:aEURS[U5URS9nUR UR U5S5nUR [U5$)zGet a single hook. :param int hook_id: (required), id of the hook :returns: the hook :rtype: :class:`~github3.orgs.OrganizationHook` NrrrDrH)r{rMrr3rNrmrr)rhook_idrGr*s rhook_Organization.hookKs] w8<HH&'jjoH U__dD0 1HH( 7enn 7 7 7 : :4 : : 7ENN 7t 7 706x>>855,I8I8V : :35  *.;2;2JJqzz#/;2ZZ GGAJJsOQZZ%?? @ ;2;2 3;2;2;2z "& $&*(,LL\>> II :I-8-8^ : :44 7 7>$>"    & P88"H 5 , : :K,BB  7 7 7 7:c:d::$GGJ<=82C2AJJt$422$ 2c 2ajj.> 2 2rrc0^\rSrSrSrSrU4SjrSrU=r$)riaObject for the full representation of a Organization. GitHub's API returns different amounts of information about orgs based upon how that information is retrieved. This object exists to represent the full amount of information returned for a specific org. For example, you would receive this class when calling :meth:`~github3.github.GitHub.organization`. To provide a clear distinction between the types of orgs, github3.py uses different classes with different sets of attributes. .. versionchanged:: 1.0.0 This object includes all attributes on :class:`~github3.orgs.ShortOrganization` as well as the following: .. attribute:: blog If set, the URL of this organization's blog. .. attribute:: company The name of the company that is associated with this organization. .. attribute:: created_at A :class:`~datetime.datetime` instance representing the time and date when this organization was created. .. attribute:: email The email address associated with this organization. .. attribute:: followers_count The number of users following this organization. Organizations no longer have followers so this number will always be 0. .. attribute:: following_count The number of users this organization follows. Organizations no longer follow users so this number will always be 0. .. attribute:: html_url The URL used to view this organization in a browser. .. attribute:: location The location of this organization, e.g., New York, NY. .. attribute:: name The display name of this organization. .. attribute:: public_repos_count The number of public repositories owned by thi sorganization. c>[TU]U5 URUS5UlUSUlUSUlUSUlUSUlURS5Ul URS5Ul URS5Ul URS 5Ul URS 5Ul g) Nr followers followinghtml_url public_reposblogrrrr-)rrrrfollowers_countfollowing_countrnpublic_repos_countr5rprrrr-)rrrs rrOrganization._update_attributes>s "3'..\):;";/";/J "%n"5GGFO wwy) WWW%  + GGFO r) rprrrrqrrrnrr-rsrr"s@rrrs9v J $ $rrc \rSrSrSrSr\rSrg)riNalObject for the shortened representation of an Organization. GitHub's API returns different amounts of information about orgs based upon how that information is retrieved. Often times, when iterating over several orgs, GitHub will return less information. To provide a clear distinction between the types of orgs, github3.py uses different classes with different sets of attributes. .. versionadded:: 1.0.0 .. attribute:: avatar_url The URL of the avatar image for this organization. .. attribute:: description The user-provided description of this organization. .. attribute:: events_url The URL to retrieve the events related to this organization. .. attribute:: hooks_url The URL for the resource to manage organization hooks. .. attribute:: id The unique identifier for this organization across GitHub. .. attribute:: issues_url The URL to retrieve the issues across this organization's repositories. .. attribute:: login The unique username of the organization. .. attribute:: members_url The URL to retrieve the members of this organization. .. attribute:: public_members_urlt A :class:`uritemplate.URITemplate` that can be expanded to either list the public members of this organization or verify a user is a public member. .. attribute:: repos_url The URL to retrieve the repositories in this organization. .. attribute:: url The URL to retrieve this organization from the GitHub API. .. attribute:: type .. deprecated:: 1.0.0 This will be removed in a future release. Previously returned by the API to indicate the type of the account. rN) rrrrrrrrr rrrrrNs@D%JKrrc4\rSrSrSrSrSr\S5rSr g)r%iaObject representing an invitation to an organization. .. attribute:: created_at A :class:`~datetime.datetime` instance representing the time and date when this invitation was created. .. attribute:: email The email address of the user invited to the organization. .. attribute:: id The unique identifier for this invitation. .. attribute:: invitation_team_url The API URL to retrieve the :class:`~github3.orgs.ShortTeam` objects associated with this invitation. .. attribute:: inviter A :class:`~github3.users.ShortUser` representing the user who invited the user identified by ``login``. .. attribute:: login The username of the user invited to the organization. .. attribute:: team_count The number of teams involved in this invitation. cURUS5UlUSUlUSUl[R "USU5UlUSUlURS5Ul URS5Ul g)Nrrr+inviterrinvitation_team_url team_count) rrrr+rr|rxrr5ryrz)rrGs rrInvitation._update_attributessr..l);<'] t*tI= '] $(88,A#B ((<0rcxSRURURURR5$)Nz")r;r+rrxr<s rr=Invitation._reprs.3:: GGTZZ!3!3  rcFURSUR[SS0S9$)zRetrieve the list of teams associated with this invite. :returns: generator of teams associated with this invitation :rtype: :class:`~github3.orgs.ShortTeam` rrsr"r)rzryr6r<s rr Invitation.teamss2zz   $ $ LM   r)rrr+ryrxrrzN) rrrrrrr=rr r rrrr%r%s& D 1     rr%c4\rSrSrSrSrSr\S5rSr g)riaObject describing a user's membership in teams and organizations. .. attribute:: organization A :class:`~github3.orgs.ShortOrganization` instance representing the organization this membership is part of. .. attribute:: organization_url The URL of the organization resource in the API that this membership is part of. .. attribute:: state The state of this membership, e.g., active or pending. .. attribute:: active .. warning:: This is a computed attribute, it is not returned by the API. A boolean attribute equivalent to ``self.state.lower() == 'active'``. .. attribute:: pending .. warning:: This is a computed attribute, it is not returned by the API. A boolean attribute equivalent to ``self.state.lower() == 'pending'``. c"SURS3$)Nz )rr<s rr=Membership._reprst00144rcUSUl[USU5UlUSUlUSUlUSUl[ R"USU5UlUR Ul UR(a"UR R5S:HUl UR Ul UR(a#UR R5S:HUl gg) Nr*rorganization_urlrBstateuserrpending) r3rrrrBrrr|rrlowerr)r memberships rrMembership._update_attributessu% - ~ & !++= >v& ( OOJv$6= jj ;;****,8DKzz <<::++-:DL rcSnU(aYUR5S:XaE[SUR505nURURURUS9S5nUbUR U5 gg)zEdit the user's membership. :param str state: (required), the state the membership should be in. Only accepts ``"active"``. :returns: True if successful, False otherwise :rtype: bool NrrrVrHTF)rrrNrhr3r)rrrGrQs rriMembership.editsi U[[]h.'5;;=12D::dkk$))$k?ED    # #D )r)r3rrrrrBrrN) rrrrrr=rrrir rrrrrs&B5;"rrcb\rSrSrSrS SjrSr\S5r\0/S4Sj5r \S 5r S r g) ri%a The representation of a hook on an organization. See also: https://developer.github.com/v3/orgs/hooks/ This object has the following attributes: .. attribute:: active A boolean attribute describing whether the hook is active or not. .. attribute:: config A dictionary containing the configuration for this hook. .. attribute:: created_at A :class:`~datetime.datetime` object representing the date and time when this hook was created. .. attribute:: events The list of events which trigger this hook. .. attribute:: id The unique identifier for this hook. .. attribute:: name The name provided to this hook. .. attribute:: updated_at A :class:`~datetime.datetime` object representing the date and time when this hook was updated. NcUSUlUSUlUSUlURUS5UlUSUlUSUlUSUlURUS5Ulg) Nr*rrrrr+r-r) r3rrrrrr+r-r)rrsessions rr#OrganizationHook._update_attributesKsnK 8n 8n ..l);<8n t*L ..l);<rc"SURS3$)NzrsG#%"??!/_/|:F  |:~+=5+=\33l 2F%% 2DK$=K$\D DNA ""A HI""IXc8v((c8r