python-cnb 0.1.0__py3-none-any.whl

cnb/__init__.py

@@ -0,0 +1,7 @@
+from .client import CNBClient
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "CNBClient",
+]

cnb/artifactory.py

@@ -0,0 +1,205 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# versions:
+#    cnb-sdk-generator: 1.0.2
+# source: https://api.cnb.cool/swagger.json
+
+from typing import Optional
+from .models import dto
+class ArtifactoryService:    
+	def __init__(self, client):
+		self._client = client
+
+	# 删除制品标签。 Delete the specific tag under specific package
+	def delete_package_tag(self,
+		slug: str,
+		t: str,
+		name: str,
+		tag: str,
+	    ):
+		u = "/%s/-/packages/%s/%s/-/tag/%s" % (slug, t, name, tag, )
+
+		data = self._client.request(
+			method="DELETE", 
+			endpoint=u,
+			)
+		return 
+
+	# 删除制品仓库。Delete the artifact repository.
+	def delete_registry(self,
+		registry: str,
+	    ):
+		u = "/%s" % (registry, )
+
+		data = self._client.request(
+			method="DELETE", 
+			endpoint=u,
+			)
+		return 
+
+	# 下载制品配额信息。 Download registry quota details.
+	def download_quotas_by_project_name(self,
+		slug: str,
+		t: str,
+	    page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		ordering: Optional[str] = None,
+		) -> list[dto.QuotaRsp]:
+		u = "/%s/-/packages/%s/-/quotas/download" % (slug, t, )
+
+		query_params = {
+			"page": page,
+			"page_size": page_size,
+			"ordering": ordering,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return [dto.QuotaRsp.safe_parse(item) for item in data]
+
+	# 获取某一制品的详细信息。 Get the package detail.
+	def get_package(self,
+		slug: str,
+		t: str,
+		name: str,
+	    ) -> dto.PackageDetail:
+		u = "/%s/-/packages/%s/%s" % (slug, t, name, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return dto.PackageDetail.safe_parse(data)
+
+	# 获取制品标签详情。 Get the specific tag under specific package.
+	def get_package_tag_detail(self,
+		slug: str,
+		t: str,
+		name: str,
+		tag: str,
+	    sha256: Optional[str] = None,
+		) -> dto.TagDetail:
+		u = "/%s/-/packages/%s/%s/-/tag/%s" % (slug, t, name, tag, )
+
+		query_params = {
+			"sha256": sha256,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return dto.TagDetail.safe_parse(data)
+
+	# 查询制品配额。 Get quota of specific registry.
+	def get_quota_by_project_name(self,
+		slug: str,
+		t: str,
+	    ) -> dto.QuotaRsp:
+		u = "/%s/-/packages/%s/-/quota" % (slug, t, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return dto.QuotaRsp.safe_parse(data)
+
+	# 查询全部制品配额。 Get quotas of packages under one registry.
+	def get_quotas_by_project_name(self,
+		slug: str,
+		t: str,
+	    page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		ordering: Optional[str] = None,
+		) -> list[dto.QuotaRsp]:
+		u = "/%s/-/packages/%s/-/quotas" % (slug, t, )
+
+		query_params = {
+			"page": page,
+			"page_size": page_size,
+			"ordering": ordering,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return [dto.QuotaRsp.safe_parse(item) for item in data]
+
+	# 查询制品数量。 Head all packages.
+	def head_packages(self,
+		slug: str,
+	    type: Optional[str] = None,
+		page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		ordering: Optional[str] = None,
+		name: Optional[str] = None,
+		):
+		u = "/%s/-/packages" % (slug, )
+
+		query_params = {
+			"type": type,
+			"page": page,
+			"page_size": page_size,
+			"ordering": ordering,
+			"name": name,
+			}
+		data = self._client.request(
+			method="HEAD", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+
+	# 查询制品标签列表。 List all tags under specific package.
+	def list_package_tags(self,
+		slug: str,
+		t: str,
+		pkgname: str,
+	    page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		ordering: Optional[str] = None,
+		name: Optional[str] = None,
+		) -> dto.Tag:
+		u = "/%s/-/packages/%s/%s/-/tags" % (slug, t, pkgname, )
+
+		query_params = {
+			"page": page,
+			"page_size": page_size,
+			"ordering": ordering,
+			"name": name,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return dto.Tag.safe_parse(data)
+
+	# 查询制品列表。 List all packages.
+	def list_packages(self,
+		slug: str,
+	    type: Optional[str] = None,
+		page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		ordering: Optional[str] = None,
+		name: Optional[str] = None,
+		) -> list[dto.Package]:
+		u = "/%s/-/packages" % (slug, )
+
+		query_params = {
+			"type": type,
+			"page": page,
+			"page_size": page_size,
+			"ordering": ordering,
+			"name": name,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return [dto.Package.safe_parse(item) for item in data]
+
+	

cnb/assets.py

@@ -0,0 +1,219 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# versions:
+#    cnb-sdk-generator: 1.0.2
+# source: https://api.cnb.cool/swagger.json
+
+from typing import Optional
+from .models import dto
+class AssetsService:    
+	def __init__(self, client):
+		self._client = client
+
+	# 发起一个获取 commits 附件的请求，返回内容或者 302 到某个地址。Get a request to fetch a commit assets and returns the content directly or a 302 redirect to the assets URL.
+	def get_commit_assets(self,
+		repo: str,
+		fileName: str,
+	    ):
+		u = "/%s/-/commit-assets/download/%s" % (repo, fileName, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个获取 files 的请求，返回内容或者 302 到某个地址。Initiate a request to retrieve files, returns content or 302 redirect.
+	def get_files(self,
+		repo: str,
+		userIdKey: str,
+		randomUUID: str,
+		fileName: str,
+	    ):
+		u = "/%s/-/files/%s/%s/%s" % (repo, userIdKey, randomUUID, fileName, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个获取 imgs 的请求，返回内容或者 302 到某个地址。Initiate a request to get images, returns content or 302 redirect.
+	def get_imgs(self,
+		repo: str,
+		userIdKey: str,
+		fileName: str,
+	    ):
+		u = "/%s/-/imgs/%s/%s" % (repo, userIdKey, fileName, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个获取 latest release 附件的请求，返回内容或者 302 到某个地址。Initiate a request to get latest release attachments, returns content or 302 redirect.
+	def get_latest_releases_asset(self,
+		repo: str,
+		fileName: str,
+	    ):
+		u = "/%s/-/releases/latest/download/%s" % (repo, fileName, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个获取 logo 的请求，返回内容或者 302 到某个地址。Post a request to fetch a logo and returns the content directly or a 302 redirect to the logo URL.
+	def get_logos(self,
+		group: str,
+		size: str,
+	    ):
+		u = "/%s/-/logos/%s" % (group, size, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个获取 release 附件的请求，返回内容或者 302 到某个地址。Initiate a request to get release attachments, returns content or 302 redirect.
+	def get_releases_asset(self,
+		repo: str,
+		fileName: str,
+	    ):
+		u = "/%s/-/releases/download/%s" % (repo, fileName, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 获取指定用户的用户头像。Get the user's avatar.
+	def get_user_avatar(self,
+		username: str,
+		size: str,
+	    ):
+		u = "/users/%s/avatar/%s" % (username, size, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return 
+
+	# 发起一个确认 files 的请求，上传的图片要调用此接口才能生效。Initiate a request to confirm files, uploaded images need to call this API to take effect.
+	def put_files(self,
+		repo: str,
+		userIdKey: str,
+		randomUUID: str,
+		fileName: str,
+	    token: Optional[str] = None,
+		):
+		u = "/%s/-/files/%s/%s/%s" % (repo, userIdKey, randomUUID, fileName, )
+
+		query_params = {
+			"token": token,
+			}
+		data = self._client.request(
+			method="PUT", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+
+	# 发起一个确认 imgs 的请求，上传的图片要调用此接口才能生效。Initiate a request to confirm images, uploaded images need to call this API to take effect.
+	def put_imgs(self,
+		repo: str,
+		userIdKey: str,
+		fileName: str,
+	    token: Optional[str] = None,
+		):
+		u = "/%s/-/imgs/%s/%s" % (repo, userIdKey, fileName, )
+
+		query_params = {
+			"token": token,
+			}
+		data = self._client.request(
+			method="PUT", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+
+	# 确认上传的logo。Confirms the uploaded logo.
+	def put_logos(self,
+		group: str,
+	    token: Optional[str] = None,
+		):
+		u = "/%s/-/logos" % (group, )
+
+		query_params = {
+			"token": token,
+			}
+		data = self._client.request(
+			method="PUT", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+
+	# 发起一个上传 files 的请求，返回上传 cos 的 url 和 form 内容。Initiate a request to upload files,returns COS upload URL and form data.
+	def upload_files(self,
+		repo: str,
+	    body_params: dto.UploadRequestParams,
+		) -> dto.UploadAssetsResponse:
+		u = "/%s/-/upload/files" % (repo, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return dto.UploadAssetsResponse.safe_parse(data)
+
+	# 发起一个上传 imgs 的请求，返回上传 cos 的 url 和 form 内容。发起一个上传 imgs 的请求，返回上传 cos 的 url 和 form 内容.
+	def upload_imgs(self,
+		repo: str,
+	    body_params: dto.UploadRequestParams,
+		) -> dto.UploadAssetsResponse:
+		u = "/%s/-/upload/imgs" % (repo, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return dto.UploadAssetsResponse.safe_parse(data)
+
+	# 发起一个上传 logo 的请求，返回上传 cos 的 url 和 form 内容。Post a request to upload a logo.
+	def upload_logos(self,
+		group: str,
+	    body_params: dto.UploadRequestParams,
+		) -> dto.UploadAssetsResponse:
+		u = "/%s/-/upload/logos" % (group, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return dto.UploadAssetsResponse.safe_parse(data)
+
+	# 发起一个上传 release 附件的请求，返回上传 cos 的 url 和 form 内容。Initiate a request to upload release attachments, returns COS upload URL and form data.
+	def upload_releases(self,
+		repo: str,
+		tagName: str,
+	    body_params: dto.UploadRequestParams,
+		) -> dto.UploadAssetsResponse:
+		u = "/%s/-/upload/releases/%s" % (repo, tagName, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return dto.UploadAssetsResponse.safe_parse(data)
+
+	

cnb/build.py

@@ -0,0 +1,91 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# versions:
+#    cnb-sdk-generator: 1.0.2
+# source: https://api.cnb.cool/swagger.json
+
+from typing import Optional
+from .models import dto
+class BuildService:    
+	def __init__(self, client):
+		self._client = client
+
+	# 查询流水线构建列表。List pipeline builds.
+	def get_build_logs(self,
+		repo: str,
+	    createTime: Optional[str] = None,
+		endTime: Optional[str] = None,
+		event: Optional[str] = None,
+		page: Optional[int] = None,
+		pagesize: Optional[int] = None,
+		sha: Optional[str] = None,
+		sn: Optional[str] = None,
+		sourceRef: Optional[str] = None,
+		status: Optional[str] = None,
+		targetRef: Optional[str] = None,
+		userId: Optional[str] = None,
+		userName: Optional[str] = None,
+		) -> dto.BuildLogsResult:
+		u = "/%s/-/build/logs" % (repo, )
+
+		query_params = {
+			"createTime": createTime,
+			"endTime": endTime,
+			"event": event,
+			"page": page,
+			"pagesize": pagesize,
+			"sha": sha,
+			"sn": sn,
+			"sourceRef": sourceRef,
+			"status": status,
+			"targetRef": targetRef,
+			"userId": userId,
+			"userName": userName,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return dto.BuildLogsResult.safe_parse(data)
+
+	# 查询流水线构建状态。Get pipeline build status.
+	def get_build_status(self,
+		repo: str,
+		sn: str,
+	    ) -> dto.BuildStatusResult:
+		u = "/%s/-/build/status/%s" % (repo, sn, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return dto.BuildStatusResult.safe_parse(data)
+
+	# 开始一个构建。Start a build.
+	def start_build(self,
+		repo: str,
+	    body_params: dto.StartBuildReq,
+		) -> list[dto.BuildResult]:
+		u = "/%s/-/build/start" % (repo, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return [dto.BuildResult.safe_parse(item) for item in data]
+
+	# 停止一个构建。 Stop a build.
+	def stop_build(self,
+		repo: str,
+		sn: str,
+	    ) -> list[dto.BuildResult]:
+		u = "/%s/-/build/stop/%s" % (repo, sn, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			)
+		return [dto.BuildResult.safe_parse(item) for item in data]
+
+	

cnb/client.py

@@ -0,0 +1,79 @@
+import requests
+from typing import Any, Dict, Optional
+from .exceptions import CNBAPIError
+from .cnb import CNBServices
+
+class CNBClient():
+    """CNB OpenAPI 客户端"""
+    
+    def __init__(
+        self,
+        base_url: str = "https://api.cnb.cool",
+        api_key: Optional[str] = None,
+        timeout: int = 30,
+        max_retries: int = 3,
+    ):
+        """
+        初始化客户端
+        
+        :param base_url: API基础URL
+        :param api_key: API密钥
+        :param timeout: 请求超时时间(秒)
+        :param max_retries: 最大重试次数
+        """
+        self.base_url = base_url.rstrip('/')
+        self.api_key = api_key
+        self.timeout = timeout
+        self.max_retries = max_retries
+        self.session = requests.Session()
+        
+        # 配置默认请求头
+        self.session.headers.update({
+            "Accept": "application/vnd.cnb.api+json",
+            "Content-Type": "application/json",
+            "User-Agent": "python-cnb/1.0"
+        })
+        
+        if api_key:
+            self.session.headers["Authorization"] = f"Bearer {api_key}"
+        
+        self.cnb = CNBServices(self)
+
+    def request(
+        self,
+        method: str,
+        endpoint: str,
+        **kwargs
+    ) -> Dict[str, Any]:
+        """
+        发送API请求
+        
+        :param method: HTTP方法(GET, POST等)
+        :param endpoint: API端点路径
+        :param kwargs: 其他请求参数
+        :return: 响应数据
+        :raises: CNBAPIError 当API请求失败时
+        """
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+        
+        # 设置默认超时
+        if 'timeout' not in kwargs:
+            kwargs['timeout'] = self.timeout
+            
+        try:
+            response = self.session.request(
+                method,
+                url,
+                **kwargs
+            )
+            response.raise_for_status()
+            return response.json()
+            
+        except requests.exceptions.HTTPError as e:
+            status_code = e.response.status_code
+            raise CNBAPIError(
+                detail=e.response.text,
+                status_code=status_code
+            ) from e
+        except requests.exceptions.RequestException as e:
+            raise CNBAPIError(f"Request failed: {str(e)}") from e

cnb/cnb.py

@@ -0,0 +1,46 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# versions:
+#    cnb-sdk-generator: 1.0.2
+# source: https://api.cnb.cool/swagger.json
+from .artifactory import ArtifactoryService
+from .assets import AssetsService
+from .build import BuildService
+from .collaborators import CollaboratorsService
+from .contributors import ContributorsService
+from .followers import FollowersService
+from .git import GitService
+from .gitsettings import GitsettingsService
+from .issues import IssuesService
+from .missions import MissionsService
+from .organizations import OrganizationsService
+from .pulls import PullsService
+from .releases import ReleasesService
+from .repocontributor import RepocontributorService
+from .repolabels import RepolabelsService
+from .repositories import RepositoriesService
+from .starring import StarringService
+from .users import UsersService
+from .workspace import WorkspaceService
+
+class CNBServices:
+	def __init__(self, client):
+		self.client = client
+		self.artifactory = ArtifactoryService(client)
+		self.assets = AssetsService(client)
+		self.build = BuildService(client)
+		self.collaborators = CollaboratorsService(client)
+		self.contributors = ContributorsService(client)
+		self.followers = FollowersService(client)
+		self.git = GitService(client)
+		self.gitsettings = GitsettingsService(client)
+		self.issues = IssuesService(client)
+		self.missions = MissionsService(client)
+		self.organizations = OrganizationsService(client)
+		self.pulls = PullsService(client)
+		self.releases = ReleasesService(client)
+		self.repocontributor = RepocontributorService(client)
+		self.repolabels = RepolabelsService(client)
+		self.repositories = RepositoriesService(client)
+		self.starring = StarringService(client)
+		self.users = UsersService(client)
+		self.workspace = WorkspaceService(client)