_OgnSrSSKJr SSKJr SSKJr SSKJr SSKJ r SSK J r SS K J r SS KJr SS KJr "S S \R$5r"SS\5r"SS\5r"SS\R$5r"SS\R$5r"SS\5r"SS\5r"SS\R$5r"SS\R$5r"SS\R$5rg )!z?This module contains all the classes relating to pull requests.)dumps) URITemplate)models)users) requires_auth)Issue) IssueComment)commit)contentsc(\rSrSrSrSrSrSrSrg)PullDestinationa>The object that represents a pull request destination. This is the base class for the :class:`~github3.pulls.Head` and :class:`~github3.pulls.Base` objects. Each has identical attributes to this object. Please see GitHub's `Pull Request Documentation`_ for more information. .. _Pull Request Documentation: http://developer.github.com/v3/pulls/#get-a-single-pull-request .. attribute:: ref The full reference string for the git object .. attribute:: label The label for the destination (e.g., 'master', 'mybranch') .. attribute:: user If provided, a :class:`~github3.users.ShortUser` instance representing the owner of the destination .. attribute:: sha The SHA of the commit at the head of the destination .. attribute:: repository A :class:`~github3.repos.repo.ShortRepository` representing the repository containing this destination .. attribute:: repo A tuple containing the login and repository name, e.g., ('sigmavirus24', 'github3.py') This attribute is generated by github3.py and may be deprecated in the future. NcSSKJn USUlUSUlUR S5UlUR (a&[ R"UR U5UlUSUlSUl SUl UR S5nU(a0UR S 5Ul US S Ul U"X05Ul URUR4Ul g) Nr)ShortRepositoryreflabelusershareponameownerlogin) repos.reporrrgetrr ShortUserr _repo_name _repo_owner repositoryr)selfdestrrs R/Users/admin/workspace/ai/Jarvis/env/lib/python3.13/site-packages/github3/pulls.py_update_attributes"PullDestination._update_attributes<s/;'] HHV$ 99 48DI;xx "hhv.DO#G}W5D -d9DO%%t7 c<SURSURS3$)N) directionrr!s r#_reprPullDestination._reprNs 4>>""TZZL33r&)rrrrrr rr) __name__ __module__ __qualname____firstlineno____doc__r*r$r,__static_attributes__r&r#rrs(TI8$4r&rc\rSrSrSrSrSrg)HeadRz~An object representing the Head destination of a pull request. See :class:`~github3.pulls.PullDestination` for more details. r4Nr.r/r0r1r2 destinationr3r4r&r#r6r6R Kr&r6c\rSrSrSrSrSrg)Base[z~An object representing the Base destination of a pull request. See :class:`~github3.pulls.PullDestination` for more details. r4Nr8r4r&r#r<r<[r:r&r<c*\rSrSrSrSrSrSrSrg)PullFiledaThe object that represents a file in a pull request. Please see GitHub's `Pull Request Files Documentation`_ for more information. .. _Pull Request Files Documentation: http://developer.github.com/v3/pulls/#list-pull-requests-files .. attribute:: additions_count The number of additions made to this file .. attribute:: blob_url The API resource used to retrieve the blob for this file .. attribute:: changes_count The number of changes made to this file .. attribute:: contents_url The API resource to view the raw contents of this file .. attribute:: deletions_count The number of deletions made to this file .. attribute:: filename The name of this file .. attribute:: patch The patch generated by this .. note:: If the patch is larger than a specific size it may be missing from GitHub's response. The attribute will be set to ``None`` in this case. .. attribute:: raw_url The API resource to view the raw diff of this file .. attribute:: sha The SHA of the commit that this file belongs to .. attribute:: status The string with the status of the file, e.g., 'added' cUSUlUSUlUSUlUSUlUSUlUSUlUSUlUSUlURS 5Ul US Ul g) Nrfilenamestatus additions deletionschangesblob_urlraw_urlpatch contents_url) rrBrCadditions_countdeletions_count changes_countrGrHrrIrJ)r!pfiles r#r$PullFile._update_attributess<j) Ho $[1$[1"9-j) Y' YYw' !.1r&c"SURS3$)Nz>r&) rKrGrMrJrLrBrIrHrrCN) r.r/r0r1r2r$r,r r3r4r&r#r?r?ds5n 28 ?r&r?c.\rSrSrSrSrSrSr\S5r \S5r \S5r \SS j5r \SS j5r \SS j5rS rS rSrSSjrSSjrSSjr\SSj5rSr\S5rSSjrSrSSjr\SSj5rSrg) _PullRequestzThe :class:`PullRequest ` object. Please see GitHub's `PullRequests Documentation`_ for more information. .. _PullRequests Documentation: http://developer.github.com/v3/pulls/ cSSKJn USUlUSUlUSUlURb&[ R "URU5UlUSVs/sHn[ R "X05PM snUl[USU5Ul USUl US Ul US Ul URUS 5UlUS UlUS UlURUS5UlUSUl['USU5UlUSUlUSUlUSUlUSUlUSUlUSUlURUS5UlUSUlUSUlUR=S5UlUR=S/5nUVs/sHn[ R "XP5PM snUl UR=S/5nUVs/sHorRCXp5PM snUl"[GUS5Ul$USUl%SUl&UR(aURRLUl&USUl'US Ul(US!Ul)URUS"5Ul*[ R "US#U5Ul+gs snfs snfs snf)$Nrorgsurlactive_lock_reasonassignee assigneesbasebody body_html body_text closed_at comments_url commits_url created_atdiff_urlheadhtml_urlid issue_url_linkslockedmerge_commit_sha merged_atnumber patch_url rebaseablerequested_reviewersrequested_teamsreview_comment_urlreview_comments_urlstate statuses_urltitle updated_atr),rr`_apirbrcrrrdr<rerfrgrh _strptimerirjrkrlrmr6rnrorprqlinksrsrtrurvrwrrxry ShortTeamrzrreview_comment_urltr|r r}r~rrr)r!pullr`aryrrzts r#r$_PullRequest._update_attributessK "&';"<Z( == $!OODMM4@DM<@  99"ii22DO']  0'] ..l);<OODL$7 MO,$  s J92 J>0Kc<SURSURS3$)Nr(z [#r)) class_namervr+s r#r,_PullRequest._reprs 4??#3t{{m266r&cPURURURS5$)zmClose this Pull Request without merging. :returns: True if successful, False otherwise :rtype: bool closedupdaterrfr+s r#close_PullRequest.closes{{4::tyy(;;r&cURnSnU(a"URURUSU0S9S5nUR[U5$)zCreate a comment on this pull request's issue. :param str body: (required), comment body :returns: the comment that was created on the pull request :rtype: :class:`~github3.issues.comment.IssueComment` Nrfdata)rjrT_postrVr )r!rfrarYs r#create_comment_PullRequest.create_commentsK ::djjFD>jBCHD%%lD99r&cURSURS9nUUU[U5S.nURUR XVS9S5nUR [ U5$)aCreate a review comment on this pull request. .. note:: All parameters are required by the GitHub API. :param str body: The comment text itself :param str commit_id: The SHA of the commit to comment on :param str path: The relative path of the file to comment on :param int position: The line index in the diff to comment on. :returns: The created review comment. :rtype: :class:`~github3.pulls.ReviewComment` commentsbase_url)rf commit_idpathpositionrr) _build_urlrintrTrrV ReviewComment)r!rfrrrrarrYs r#create_review_comment"_PullRequest.create_review_commentsa*ooj499o="H   zz$**S*4c:%%mT::r&NcHURSURS9n0nUb!UVs/sHn[USU5PM snUS'Ub!UVs/sHn[USU5PM snUS'URUR X4S9S5nUR [ U5$s snfs snf) a"Ask for reviews on this pull request. :param list reviewers: The users to which request a review :param list team_reviewers: The teams to which request a review :returns: The pull request on which the reviews were requested :rtype: :class:`~github3.pulls.ShortPullRequest` ryrr reviewersslugteam_reviewersrr)rrgetattrrTrrVShortPullRequest)r!rrrarrrrYs r#create_review_requests#_PullRequest.create_review_requests0soo3diioH  AJ KAGQ!7 KD   %/=&/=!61%~&D! "zz$**S*4c:%%&6== !L&s BBcUc/nURSURS9nXS.nUbX&S'UbX6S'URURXVS9S5nUR [ U5$)aCreate a review comment on this pull request. .. warning:: If you do not specify ``event``, GitHub will default it to ``PENDING`` which means that your review will need to be submitted after creation. (See also :meth:`~github3.pulls.PullReview.submit`.) :param str body: The comment text itself, required when using COMMENT or REQUEST_CHANGES. :param str commit_id: The SHA of the commit to comment on :param str event: The review action you want to perform. Actions include APPROVE, REQUEST_CHANGES or COMMENT. By leaving this blank you set the action to PENDING and will need to submit the review. Leaving blank may result in a 422 error response which will need to be handled. :param list comments: Array of draft review comment objects. Please see Github's `Create a pull request review documentation`_ for details on review comment objects. At the time of writing these were a dictionary with 3 keys: `path`, `position` and `body`. .. _Create a pull request review documentation: https://developer.github.com/v3/pulls/reviews/#create-a-pull-request-review :returns: The created review. :rtype: :class:`~github3.pulls.PullReview` reviewsr)rfrreventrrS)rrrTrrV PullReview)r!rfrrrrarrYs r# create_review_PullRequest.create_reviewHswJ  Hooi$))o<3  )   !Mzz$**S*4c:%%j$77r&c2URSURS9n0nUb!UVs/sHn[USU5PM snUS'Ub!UVs/sHn[USU5PM snUS'URUR U[ U5S9SS 5$s snfs snf) aCancel review requests on this pull request. :param list reviewers: The users whose review is no longer requested :param list team_reviewers: The teams whose review is no longer requested :returns: True if successful, False otherwise :rtype: bool ryrrrrrrrS)rrr_boolean_deleter)r!rrrarrrs r#delete_review_requests#_PullRequest.delete_review_requestsxsoo3diioH  AJ KAGQ!7 KD   %/=&/=!61%~&D! "}}T\\#E$K\@#sKK !L&s BBcURURSS0S9nURUSS5(a UR$S$)zMReturn the diff. :returns: representation of the diff :rtype: bytes Acceptzapplication/vnd.github.diffheadersrSrr&rUrrcontentr!resps r#diff_PullRequest.diffsIyy II*GH  $}}T3<Iterate over the files associated with this pull request. :param int number: (optional), number of files to return. Default: -1 returns all available files. :param str etag: (optional), ETag from a previous request to the same endpoint :returns: generator of pull request files :rtype: :class:`~PullFile` filesrr)rrrrr?rs r#r_PullRequest.filess5oog o:zz#f+sH4z@@r&cURRS05nURS5nUR[U5U[US9$)aCIterate over the issue comments on this pull request. In this case, GitHub leaks implementation details. Pull Requests are really just Issues with a diff. As such, comments on a pull request that are not in-line with code, are technically issue comments. :param int number: (optional), number of comments to return. Default: -1 returns all available comments. :param str etag: (optional), ETag from a previous request to the same endpoint :returns: generator of non-review comments on this pull request :rtype: :class:`~github3.issues.comment.IssueComment` rhrefr)rrrrr )r!rvrrras r#issue_comments_PullRequest.issue_commentssA"::>>*b1ll6"zz#f+sLtzDDr&cSU0nU(aX%S'UbXS'UbXES'URSURS9nURURU[ U5S9S5nU(dg US $) aMerge this pull request. .. versionchanged:: 1.3.0 The ``commit_title`` parameter has been added to allow users to set the merge commit title. .. versionchanged:: 1.0.0 The boolean ``squash`` parameter has been replaced with ``merge_method`` which requires a string. :param str commit_message: (optional), message to be used for the merge commit :param str commit_title: (optional), message to be used for the merge commit title :param str sha: (optional), SHA that pull request head must match to merge. :param str merge_method: (optional), Change the merge method. Either 'merge', 'squash' or 'rebase'. Default is 'merge'. :returns: True if successful, False otherwise :rtype: bool :returns: bool merge_methodrcommit_message commit_titlerrrrSFmerged)rrrT_putr)r!rrrr parametersrarYs r#r_PullRequest.mergesD%l3  #u   %+9' (  #)5~ &oog o:zz$))CeJ.?)@#FH~r&cURURSS0S9nURUSS5(a UR$S$)zZReturn the patch. :returns: bytestring representation of the patch :rtype: bytes rzapplication/vnd.github.patchrrSrr&rrs r#rI_PullRequest.patchsIyy II*HI  $}}T3<>.-8-8^LL, F7 3L AE*  ,,\ F@@F <C   " ++r&r\c0^\rSrSrSrSrU4SjrSrU=r$) PullRequestiaObject for the full representation of a PullRequest. GitHub's API returns different amounts of information about prs based upon how that information is retrieved. This object exists to represent the full amount of information returned for a specific pr. For example, you would receive this class when calling :meth:`~github3.github.GitHub.pull_request`. To provide a clear distinction between the types of prs, github3.py uses different classes with different sets of attributes. .. versionchanged:: 1.0.0 This object has all of the same attributes as :class:`~github3.pulls.ShortPullRequest` as well as the following: .. attribute:: additions_count The number of lines of code added in this pull request. .. attribute:: deletions_count The number of lines of code deleted in this pull request. .. attribute:: comments_count The number of comments left on this pull request. .. attribute:: commits_count The number of commits included in this pull request. .. attribute:: mergeable A boolean attribute indicating whether GitHub deems this pull request is mergeable. .. attribute:: mergeable_state A string indicating whether this would be a 'clean' or 'dirty' merge. .. attribute:: merged A boolean attribute indicating whether the pull request has been merged or not. .. attribute:: merged_by An instance of :class:`~github3.users.ShortUser` to indicate the user who merged this pull request. If this hasn't been merged or if :attr:`mergeable` is still being decided by GitHub this will be ``None``. .. attribute:: review_comments_count The number of review comments on this pull request. z Pull Requestc>[TU]U5 USUlURSS5UlUSUlUSUlUSUlUSUlUSUl USUl US Ul US Ul US Ul URb&[R"URU5Ul US UlUS n/UlU(a,SSKJn UVs/sHoCR)X@5PM snUlUSn/UlU(a-UVs/sHn[R"X`5PM snUlggs snfs snf)NrD auto_mergeauthor_associationrrrEdraft mergeablemergeable_stater merged_byrrzrr_ry)superr$rKrrrcomments_count commits_countrLrrrrrrrreview_comments_countrzrr`rry)r!rrzr`teamryr __class__s r#r$PullRequest._update_attributessZ "4(#K0((<6"&';"<":.!)_#K0'] k*#$568n k* >> %"__T^^TBDN%)*;%<"01!  8G$7Ftt*$D ##89#% 8K(8K+8K(D $  $(s &E  E)rKrrrrrLrrrrrryrzr) r.r/r0r1r2rr$r3 __classcell__)rs@r#rrs7r Jr&rc \rSrSrSrSr\rSrg)riaNObject for the shortened representation of a PullRequest. GitHub's API returns different amounts of information about prs based upon how that information is retrieved. Often times, when iterating over several prs, GitHub will return less information. To provide a clear distinction between the types of Pull Requests, github3.py uses different classes with different sets of attributes. .. versionadded:: 1.0.0 The attributes available on this object are: .. attribute:: url The URL that describes this exact pull request. .. attribute:: assignee .. deprecated:: 1.0.0 Use :attr:`assignees` instead. The assignee of the pull request, if present, represented as an instance of :class:`~github3.users.ShortUser` .. attribute:: assignees .. versionadded:: 1.0.0 A list of the assignees of the pull request. If not empty, a list of instances of :class:`~github3.users.ShortUser`. .. attribute:: base A :class:`~github3.pulls.Base` object representing the base pull request destination. .. attribute:: body The Markdown formatted body of the pull request message. .. attribute:: body_html The HTML formatted body of the pull request mesage. .. attribute:: body_text The plain-text formatted body of the pull request message. .. attribute:: closed_at A :class:`~datetime.datetime` object representing the date and time when this pull request was closed. .. attribute:: comments_url The URL to retrieve the comments on this pull request from the API. .. attribute:: commits_url The URL to retrieve the commits in this pull request from the API. .. attribute:: created_at A :class:`~datetime.datetime` object representing the date and time when this pull request was created. .. attribute:: diff_url The URL to retrieve the diff for this pull request via the API. .. attribute:: head A :class:`~github3.pulls.Head` object representing the head pull request destination. .. attribute:: html_url The URL one would use to view this pull request in the browser. .. attribute:: id The unique ID of this pull request across all of GitHub. .. attribute:: issue_url The URL of the resource that represents this pull request as an issue. .. attribute:: links A dictionary provided by ``_links`` in the API response. .. versionadded:: 1.0.0 .. attribute:: merge_commit_sha If unmerged, holds the sha of the commit to test mergability. If merged, holds commit sha of the merge commit, squashed commit on the base branch or the commit that the base branch was updated to after rebasing the PR. .. attribute:: merged_at A :class:`~datetime.datetime` object representing the date and time this pull request was merged. If this pull request has not been merged then this attribute will be ``None``. .. attribute:: number The number of the pull request on the repository. .. attribute:: patch_url The URL to retrieve the patch for this pull request via the API. .. attribute:: rebaseable A boolean attribute indicating whether GitHub deems this pull request is rebaseable. None if not set. .. attribute:: repository A :class:`~github3.repos.repo.ShortRepository` from the :attr:`base` instance. .. attribute:: requested_reviewers A list of :class:`~github3.users.ShortUser` from which a review was requested. .. attribute:: requested_teams A list of :class:`~github3.orgs.ShortTeam` from which a review was requested. .. attribute:: review_comment_urlt A URITemplate instance that expands to provide the review comment URL provided a number. .. attribute:: review_comments_url The URl to retrieve all review comments on this pull request from the API. .. attribute:: state The current state of this pull request. .. attribute:: title The title of this pull request. .. attribute:: updated_at A :class:`~datetime.datetime` instance representing the date and time when this pull request was last updated. .. attribute:: user A :class:`~github3.users.ShortUser` instance representing who opened this pull request. zShort Pull Requestr4N) r.r/r0r1r2rr _refresh_tor3r4r&r#rrsbH&JKr&rc8\rSrSrSrSrSr\SSj5rSr g) ria Object representing a Pull Request Review returned by the API. Please see GitHub's `Pull Review Documentation`_ for more information. .. _PullReview Documentation: https://developer.github.com/v3/pulls/reviews/ .. attribute:: id The unique ID of this pull request review. .. attribute:: author_association .. versionadded:: 1.0.0 The relationship of this review's author to the project. .. attribute:: body The Markdown formatted body of this review. .. attribute:: body_html .. versionadded:: 1.0.0 The HTML formatted body of this review. .. attribute:: body_text .. versionadded:: 1.0.0 The plain-text formatted body of this review. .. attribute:: commit_id The SHA of the commit that the review was left on. .. note:: It is possible for the attribute to be set to ``None``, if the review references a commit that is no longer available in the pull request branch, such as after a force push. .. attribute:: html_url .. versionadded:: 1.0.0 The URL to view this pull request in a browser. .. attribute:: pull_request_url The URL to retrieve the pull request via the API. .. attribute:: state The state of this review, e.g., the option specified in the review dialog by the author. .. attribute:: submitted_at A :class:`~datetime.datetime` object representing the date and time this review was submitted. .. attribute:: user A :class:`~github3.users.ShortUser` instance representing the author of this review. cZUSUlUSUlUSUlUSUlUSUlUR SS5UlUSUl[R"USU5Ul US Ul URUR S 55Ul US Ulg) Nrprrfrgrhrrorr} submitted_atpull_request_url)rprrfrgrhrrrorrrr}rrr)r!reviews r#r$PullReview._update_attributess,"()=">6N  , , K6z* OOF6ND9 G_  NN6::n+EF &'9 :r&c"SURS3$)Nz"?FO  - - -..)>? - + X& ")*>"?!()?OOGFOT: r&c6SURRS3$)Nz)formatlenrr1r+s r#r,ReviewRequests._reprs*9@@  OS_  r&)r1rN)r.r/r0r1r2r$r,r3r4r&r#rrs K  r&rN)r2rYr uritemplaterrrr decoratorsrissuesr issues.commentr reposr rr GitHubCorerr6r<r?r\rrrrrr4r&r#r?sE#%($@4f''@4F??P?v  P?fR6$$Rj[,[|f|fRs""slT;F%%T;n V&& r&