_Og5SrSSKrSSKJr SSKJr SSKJr SSKJr SSKJ r SS K J r "S S \R5r "S S \R5rg)z!Release logic for the GitHub API.N) URITemplate)models)users)utils) requires_auth) error_forc\rSrSrSrSrSrS SjrSrSSjr \ S 5r \ SS j5r \ SS j5r S rg)Release aRepresentation of a GitHub release. It holds the information GitHub returns about a release from a :class:`Repository `. Please see GitHub's `Releases Documentation`_ for more information. This object has the following attributes: .. attribute:: original_assets A list of :class:`~github3.repos.release.Asset` objects representing the assets uploaded for this relesae. .. attribute:: assets_url The URL to retrieve the assets from the API. .. attribute:: author A :class:`~github3.users.ShortUser` representing the creator of this release. .. attribute:: body The description of this release as written by the release creator. .. attribute:: created_at A :class:`~datetime.datetime` object representing the date and time when this release was created. .. attribute:: draft A boolean attribute describing whether this release is a draft. .. attribute:: html_url The URL to view this release in a browser. .. attribute:: id The unique identifier of this release. .. attribute:: name The name given to this release by the :attr:`author`. .. attribute:: prerelease A boolean attribute indicating whether the release is a pre-release. .. attribute:: published_at A :class:`~datetime.datetime` object representing the date and time when this release was publisehd. .. attribute:: tag_name The name of the tag associated with this release. .. attribute:: tarball_url The URL to retrieve a GitHub generated tarball for this release from the API. .. attribute:: target_commitish The reference (usually a commit) that is targetted by this release. .. attribute:: upload_urlt A :class:`~uritemplate.URITemplate` object that expands to form the URL to upload assets to. .. attribute:: zipball_url The URL to retrieve a GitHub generated zipball for this release from the API. .. _Releases Documentation: https://developer.github.com/v3/repos/releases/ cUS=UlUlUSVs/sHn[X 5PM snUlUSUl[ R "USU5UlUSUlURUS5Ul USUl USUl US Ul US UlUS UlURUS 5UlUS UlUSUlUSUl[)US5UlUSUlgs snf)Nurlassets assets_urlauthorbody created_atdrafthtml_urlidname prerelease published_attag_name tarball_urltarget_commitish upload_url zipball_url)_apirAssetoriginal_assetsrr ShortUserrr _strptimerrrrrrrrrrr upload_urltr)selfreleaseis Z/Users/admin/workspace/ai/Jarvis/env/lib/python3.13/site-packages/github3/repos/release.py_update_attributesRelease._update_attributesbs&u~- DH8?8IJ8I1a8IJ!,/oogh&7> FO ..)>?W%  + $-FO !,/ NN7>+BC + "=1 '(: ;&w|'<="=1 KsD c"SURS3$)Nz rr%s r(_repr Release._reprusDII;b))c&SnUS;aSURSURRS5nURXRUS9nUR USSS9nU(a/UR USS5(a[ R"X25 gg ) aGet the tarball or zipball archive for this release. :param str format: (required), accepted values: ('tarball', 'zipball') :param path: (optional), path where the file should be saved to, default is the filename provided in the headers and will be written in the current directory. It can take a file-like object as well :type path: str, file :returns: True if successful, False otherwise :rtype: bool N)tarballzipballz /releasesbase_urlT)allow_redirectsstreamF)rrfind _build_urlr_get_booleanrstream_response_to_file)r%formatpathresprepo_urlrs r(archiveRelease.archivexs  + +yy!?499??;#?@H//&--(/KC99S$t9DD DMM$S11  ) )$ 5r1cSn[U5S:acURRS5nURS[ U5URSUS9nUR UR U5S5nUR[U5$)zRetrieve the asset from this release with ``asset_id``. :param int asset_id: ID of the Asset to retrieve :returns: the specified asset, if it exists :rtype: :class:`~github3.repos.release.Asset` Nr/rr5r9) intrr;r<str_jsonr=_instance_or_nullr )r%asset_idjsonr'rs r(asset Release.assets| x=1  $A//#h-$))BQ-"C::diinc2D%%eT22r1Nc`URSURS9nURX[US9$)aIterate over the assets available for this release. :param int number: (optional), Number of assets to return :param str etag: (optional), last ETag header sent :returns: generator of asset objects :rtype: :class:`~github3.repos.release.Asset` rr5)etag)r<r_iterr )r%numberrQrs r(rRelease.assetss/ooho;zz&u4z88r1c^URnURURU5SS5$)zDelete this release. Only users with push access to the repository can delete a release. :returns: True if successful; False if not successful :rtype: bool r:rr>_deleter%rs r(deleteRelease.deletes)ii}}T\\#.S99r1c URnUUUUUUS.nURU5 URRU[R "U5S9n UR U SS5n U (aURU R 55 U $)aEdit this release. Only users with push access to the repository can edit a release. If the edit is successful, this object will update itself. :param str tag_name: (optional), Name of the tag to use :param str target_commitish: (optional), The "commitish" value that determines where the Git tag is created from. Defaults to the repository's default branch. :param str name: (optional), Name of the release :param str body: (optional), Description of the release :param boolean draft: (optional), True => Release is a draft :param boolean prerelease: (optional), True => Release is a prerelease :returns: True if successful; False if not successful :rtype: bool )rrrrrrdatar9r:)r _remove_nonesessionpatchrMdumpsr>r)) r%rrrrrrrr^r successfuls r(edit Release.editsDii 0$   $ LL  sD)9  :]]1c3/   # #AFFH -r1cSU0nX$S.nURU5 URRU5nURXsSUS9nURS;a[ UR 5U5$[U5e)aUpload an asset to this release. .. note:: All parameters are required. :param str content_type: The content type of the asset. Wikipedia has a list of common media types :param str name: The name of the file :param asset: The file or bytes object to upload. :param label: (optional), An alternate short description of the asset. :returns: the created asset :rtype: :class:`~github3.repos.release.Asset` Content-TyperlabelF)r^rMheaders))r_r$expand_post status_coder rMr ) r% content_typerrNrjrkparamsrrcs r( upload_assetRelease.upload_assetsw("<0/ &!%%f- JJsUGJ D ==J &4( (lr1)rrrrrrrrrr!rrrrrr$rr)N)NNNNNNN)__name__ __module__ __qualname____firstlineno____doc__r)r/rDrNrrrZrers__static_attributes__r1r(r r ssRh2&*63& 9 : :  33jr1r cH\rSrSrSrSrSrS Sjr\S5r S Sjr S r g) r iaRepresentation of an asset in a release. .. seealso:: `List Assets`_, :meth:`~github3.repos.release.Release.assets` Documentation around listing assets of a release `Upload Assets`_, :meth:`~github3.repos.release.Release.upload_asset` Documentation around uploading assets to a release `Get a Single Asset`_, :meth:`~github3.repos.release.Release.asset` Documentation around retrieving an asset `Edit an Asset`_, :meth:`~github3.repos.release.Asset.edit` Documentation around editing an asset `Delete an Asset`_, :meth:`~github3.repos.release.Asset.delete` Documentation around deleting an asset This object has the following attributes: .. attribute:: browser_download_url The user-friendly URL to download this asset via a browser. .. attribute:: content_type The Content-Type provided by the uploader when this asset was created. .. attribute:: created_at A :class:`~datetime.datetime` object representing the date and time when this asset was created. .. attribute:: download_count The number of times this asset has been downloaded. .. attribute:: download_url The URL to retrieve this uploaded asset via the API, e.g., tarball, zipball, etc. .. attribute:: id The unique identifier of this asset. .. attribute:: label The short description of this asset. .. attribute:: name The name provided to this asset. .. attribute:: size The file size of this asset. .. attribute:: state The state of this asset, e.g., ``'uploaded'``. .. attribute:: updated_at A :class:`~datetime.datetime` object representing the date and time when this asset was most recently updated. .. _List Assets: https://developer.github.com/v3/repos/releases/#list-assets-for-a-release .. _Upload Assets: https://developer.github.com/v3/repos/releases/#upload-a-release-asset .. _Get a Single Asset: https://developer.github.com/v3/repos/releases/#get-a-single-release-asset .. _Edit an Asset: https://developer.github.com/v3/repos/releases/#edit-a-release-asset .. _Delete an Asset: https://developer.github.com/v3/repos/releases/#delete-a-release-asset c>USUlUSUlUSUlURUS5UlUSUlURUlUSUlUSUlUSUl US Ul US Ul URUS 5Ul g) Nrbrowser_download_urlrqrdownload_countrrjrsizestate updated_at) rrrqr#rr download_urlrrjrrrr)r%rNs r(r)Asset._update_attributesds%L $)*@$A!!.1..|)<=#$45 II+7^ &M &M 7^ ..|)<=r1c"SURS3$)Nzrr?)r%rArkrBs r(downloadAsset.downloadus78yy IIuT7    s " NNND1 2%%'yyLL,T7!( ==sC ( (00< <('s B44 Cc^URnURURU5SS5$)z{Delete this asset if the user has push access. :returns: True if successful; False if not successful :rtype: bool rVr:rWrYs r(rZ Asset.deletes)ii}}T\\#.S99r1NcU(dgXS.nURU5 URUR[R"U5S9nUR USS5nU(aUR UR55 U$)zEdit this asset. :param str name: (required), The file name of the asset :param str label: (optional), An alternate description of the asset :returns: True if successful, False otherwise :rtype: bool Frir]r9r:)r__patchrrMrbr>r))r%rrj edit_datarcrds r(re Asset.editsn!2  )$ KK  9(=K >]]1c3/   # #AFFH -r1) rrrqrrrrrjrrrrrurx) ryrzr{r|r}r)r/rrrZrer~rr1r(r r s2JX >(@ : :r1r )r}rM uritemplaterrvrrr decoratorsr exceptionsr GitHubCorer r rr1r(rsF' #&"GfGT_F  _r1