############################ Copyrights and license ############################ # # # Copyright 2015 Ed Holland # # Copyright 2016 Benjamin Whitney # # Copyright 2016 Jannis Gebauer # # Copyright 2016 Peter Buckley # # Copyright 2017 Chris McBride # # Copyright 2017 Simon # # Copyright 2018 Daniel Kesler # # Copyright 2018 Kuba # # Copyright 2018 Maarten Fonville # # Copyright 2018 Shinichi TAMURA # # Copyright 2018 Wan Liuyang # # Copyright 2018 edquist # # Copyright 2018 nurupo # # Copyright 2018 sfdye # # # # This file is part of PyGithub. # # http://pygithub.readthedocs.io/ # # # # PyGithub is free software: you can redistribute it and/or modify it under # # the terms of the GNU Lesser General Public License as published by the Free # # Software Foundation, either version 3 of the License, or (at your option) # # any later version. # # # # PyGithub is distributed in the hope that it will be useful, but WITHOUT ANY # # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS # # FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more # # details. # # # # You should have received a copy of the GNU Lesser General Public License # # along with PyGithub. If not, see . # # # ################################################################################ from os.path import basename from typing import Any, Dict import github.GithubObject import github.GitReleaseAsset import github.NamedUser from . import Consts class GitRelease(github.GithubObject.CompletableGithubObject): """ This class represents GitReleases. The reference can be found here https://docs.github.com/en/rest/reference/repos#releases """ def __repr__(self) -> str: return self.get__repr__({"title": self._title.value}) @property def id(self): """ :type: integer """ self._completeIfNotSet(self._id) return self._id.value @property def body(self): """ :type: string """ self._completeIfNotSet(self._body) return self._body.value @property def title(self): """ :type: string """ self._completeIfNotSet(self._title) return self._title.value @property def tag_name(self): """ :type: string """ self._completeIfNotSet(self._tag_name) return self._tag_name.value @property def target_commitish(self): """ :type: string """ self._completeIfNotSet(self._target_commitish) return self._target_commitish.value @property def draft(self): """ :type: bool """ self._completeIfNotSet(self._draft) return self._draft.value @property def prerelease(self): """ :type: bool """ self._completeIfNotSet(self._prerelease) return self._prerelease.value @property def author(self): """ :type: :class:`github.NamedUser.NamedUser` """ self._completeIfNotSet(self._author) return self._author.value @property def created_at(self): """ :type: datetime.datetime """ self._completeIfNotSet(self._created_at) return self._created_at.value @property def published_at(self): """ :type: datetime.datetime """ self._completeIfNotSet(self._published_at) return self._published_at.value @property def url(self): """ :type: string """ self._completeIfNotSet(self._url) return self._url.value @property def upload_url(self): """ :type: string """ self._completeIfNotSet(self._upload_url) return self._upload_url.value @property def html_url(self): """ :type: string """ self._completeIfNotSet(self._html_url) return self._html_url.value @property def tarball_url(self): """ :type: string """ self._completeIfNotSet(self._tarball_url) return self._tarball_url.value @property def zipball_url(self): """ :type: string """ self._completeIfNotSet(self._zipball_url) return self._zipball_url.value @property def assets(self): """ :type: list of :class:`github.GitReleaseAsset.GitReleaseAsset` """ self._completeIfNotSet(self._assets) return self._assets.value def delete_release(self): """ :calls: `DELETE /repos/{owner}/{repo}/releases/{release_id} `_ :rtype: None """ headers, data = self._requester.requestJsonAndCheck("DELETE", self.url) def update_release( self, name, message, draft=False, prerelease=False, tag_name=github.GithubObject.NotSet, target_commitish=github.GithubObject.NotSet, ): """ :calls: `PATCH /repos/{owner}/{repo}/releases/{release_id} `_ :param name: string :param message: string :param draft: bool :param prerelease: bool :param tag_name: string :param target_commitish: string :rtype: :class:`github.GitRelease.GitRelease` """ assert tag_name is github.GithubObject.NotSet or isinstance( tag_name, str ), "tag_name must be a str/unicode object" assert target_commitish is github.GithubObject.NotSet or isinstance( target_commitish, str ), "target_commitish must be a str/unicode object" assert isinstance(name, str), name assert isinstance(message, str), message assert isinstance(draft, bool), draft assert isinstance(prerelease, bool), prerelease if tag_name is github.GithubObject.NotSet: tag_name = self.tag_name post_parameters = { "tag_name": tag_name, "name": name, "body": message, "draft": draft, "prerelease": prerelease, } # Do not set target_commitish to self.target_commitish when omitted, just don't send it # altogether in that case, in order to match the Github API behaviour. Only send it when set. if target_commitish is not github.GithubObject.NotSet: post_parameters["target_commitish"] = target_commitish headers, data = self._requester.requestJsonAndCheck("PATCH", self.url, input=post_parameters) return github.GitRelease.GitRelease(self._requester, headers, data, completed=True) def upload_asset( self, path, label="", content_type=github.GithubObject.NotSet, name=github.GithubObject.NotSet, ): """ :calls: `POST https:///repos/{owner}/{repo}/releases/{release_id}/assets `_ :param path: string :param label: string :param content_type: string :param name: string :rtype: :class:`github.GitReleaseAsset.GitReleaseAsset` """ assert isinstance(path, str), path assert isinstance(label, str), label assert name is github.GithubObject.NotSet or isinstance(name, str), name post_parameters = {"label": label} if name is github.GithubObject.NotSet: post_parameters["name"] = basename(path) else: post_parameters["name"] = name headers = {} if content_type is not github.GithubObject.NotSet: headers["Content-Type"] = content_type resp_headers, data = self._requester.requestBlobAndCheck( "POST", self.upload_url.split("{?")[0], parameters=post_parameters, headers=headers, input=path, ) return github.GitReleaseAsset.GitReleaseAsset(self._requester, resp_headers, data, completed=True) def upload_asset_from_memory( self, file_like, file_size, name, content_type=github.GithubObject.NotSet, label="", ): """Uploads an asset. Unlike ``upload_asset()`` this method allows you to pass in a file-like object to upload. Note that this method is more strict and requires you to specify the ``name``, since there's no file name to infer these from. :calls: `POST https:///repos/{owner}/{repo}/releases/{release_id}/assets `_ :param file_like: binary file-like object, such as those returned by ``open("file_name", "rb")``. At the very minimum, this object must implement ``read()``. :param file_size: int, size in bytes of ``file_like`` :param content_type: string :param name: string :param label: string :rtype: :class:`github.GitReleaseAsset.GitReleaseAsset` """ assert isinstance(name, str), name assert isinstance(file_size, int), file_size assert isinstance(label, str), label post_parameters = {"label": label, "name": name} content_type = content_type if content_type is not github.GithubObject.NotSet else Consts.defaultMediaType headers = {"Content-Type": content_type, "Content-Length": str(file_size)} resp_headers, data = self._requester.requestMemoryBlobAndCheck( "POST", self.upload_url.split("{?")[0], parameters=post_parameters, headers=headers, file_like=file_like, ) return github.GitReleaseAsset.GitReleaseAsset(self._requester, resp_headers, data, completed=True) def get_assets(self): """ :calls: `GET /repos/{owner}/{repo}/releases/{release_id}/assets `_ :rtype: :class:`github.PaginatedList.PaginatedList` """ return github.PaginatedList.PaginatedList( github.GitReleaseAsset.GitReleaseAsset, self._requester, f"{self.url}/assets", None, ) def _initAttributes(self) -> None: self._id = github.GithubObject.NotSet self._body = github.GithubObject.NotSet self._title = github.GithubObject.NotSet self._tag_name = github.GithubObject.NotSet self._target_commitish = github.GithubObject.NotSet self._draft = github.GithubObject.NotSet self._prerelease = github.GithubObject.NotSet self._generate_release_notes = github.GithubObject.NotSet self._author = github.GithubObject.NotSet self._url = github.GithubObject.NotSet self._upload_url = github.GithubObject.NotSet self._html_url = github.GithubObject.NotSet self._created_at = github.GithubObject.NotSet self._published_at = github.GithubObject.NotSet self._tarball_url = github.GithubObject.NotSet self._zipball_url = github.GithubObject.NotSet self._assets = github.GithubObject.NotSet def _useAttributes(self, attributes: Dict[str, Any]) -> None: if "id" in attributes: self._id = self._makeIntAttribute(attributes["id"]) if "body" in attributes: self._body = self._makeStringAttribute(attributes["body"]) if "name" in attributes: self._title = self._makeStringAttribute(attributes["name"]) if "tag_name" in attributes: self._tag_name = self._makeStringAttribute(attributes["tag_name"]) if "target_commitish" in attributes: self._target_commitish = self._makeStringAttribute(attributes["target_commitish"]) if "draft" in attributes: self._draft = self._makeBoolAttribute(attributes["draft"]) if "prerelease" in attributes: self._prerelease = self._makeBoolAttribute(attributes["prerelease"]) if "generate_release_notes" in attributes: self._generate_release_notes = self._makeBoolAttribute(attributes["generate_release_notes"]) if "author" in attributes: self._author = self._makeClassAttribute(github.NamedUser.NamedUser, attributes["author"]) if "url" in attributes: self._url = self._makeStringAttribute(attributes["url"]) if "upload_url" in attributes: self._upload_url = self._makeStringAttribute(attributes["upload_url"]) if "html_url" in attributes: self._html_url = self._makeStringAttribute(attributes["html_url"]) if "created_at" in attributes: self._created_at = self._makeDatetimeAttribute(attributes["created_at"]) if "published_at" in attributes: self._published_at = self._makeDatetimeAttribute(attributes["published_at"]) if "tarball_url" in attributes: self._tarball_url = self._makeStringAttribute(attributes["tarball_url"]) if "zipball_url" in attributes: self._zipball_url = self._makeStringAttribute(attributes["zipball_url"]) if "assets" in attributes: self._assets = self._makeListOfClassesAttribute( github.GitReleaseAsset.GitReleaseAsset, attributes["assets"] )