python-cnb 0.8.0b1__tar.gz → 1.17.16__tar.gz

{python_cnb-0.8.0b1/python_cnb.egg-info → python_cnb-1.17.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-cnb
-Version: 0.8.0b1
+Version: 1.17.16
 Summary: CNB OpenAPI的Python SDK,方便与CNB平台进行交互
 Home-page: https://cnb.cool
 Author: Tencent Cloud
@@ -40,7 +40,7 @@ Dynamic: summary
 [![PyPI](https://img.shields.io/pypi/v/python-cnb.svg)](https://pypi.org/project/python-cnb/)
 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-<a href="https://yuanbao.tencent.com"><img src="https://img.shields.io/badge/AI-Code%20Assist-EB9FDA"></a>
+<a href="https://www.codebuddy.cn/"><img src="https://img.shields.io/badge/AI-Code%20Assist-EB9FDA"></a>
 
 CNB OpenAPI的Python SDK，方便与CNB平台进行交互。
 > 该 sdk 由 [cnb-sdk-generator](https://cnb.cool/cnb/sdk/cnb-sdk-generator) 生成

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/README.md

@@ -3,7 +3,7 @@
 [![PyPI](https://img.shields.io/pypi/v/python-cnb.svg)](https://pypi.org/project/python-cnb/)
 [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-<a href="https://yuanbao.tencent.com"><img src="https://img.shields.io/badge/AI-Code%20Assist-EB9FDA"></a>
+<a href="https://www.codebuddy.cn/"><img src="https://img.shields.io/badge/AI-Code%20Assist-EB9FDA"></a>
 
 CNB OpenAPI的Python SDK，方便与CNB平台进行交互。
 > 该 sdk 由 [cnb-sdk-generator](https://cnb.cool/cnb/sdk/cnb-sdk-generator) 生成

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/activities.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
@@ -46,4 +44,21 @@ class ActivitiesService:
 			)
 		return data
 		
+	# 获取仓库 top 活跃用户。List the top active users
+	def top_contributors(self,
+		repo: str,
+	    top: Optional[int] = None,
+		) -> list[dto.UsersResult]:
+		u = "/%s/-/top-activity-users" % (repo, )
+
+		query_params = {
+			"top": top,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return [dto.UsersResult.safe_parse(item) for item in data]
+		
 	

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/ai.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
@@ -23,18 +21,4 @@ class AiService:
 			)
 		return dto.AiAutoPrResult.safe_parse(data)
 		
-	# AI 对话，参数根据模型不同会有区别。AI chat completions, params may differ by model.
-	def ai_chat_completions(self,
-		repo: str,
-	    body_params: dto.AiChatCompletionsReq,
-		) -> dto.AiChatCompletionsResult:
-		u = "/%s/-/ai/chat/completions" % (repo, )
-
-		data = self._client.request(
-			method="POST", 
-			endpoint=u,
-			json=body_params.to_dict(),
-			)
-		return dto.AiChatCompletionsResult.safe_parse(data)
-		
 	

python_cnb-1.17.16/cnb/ai_ext.py

@@ -0,0 +1,103 @@
+# AI Service Extensions - Manual implementation for streaming and additional AI features
+# This file extends the AiService class with streaming support
+
+import json
+from typing import Generator, Union
+from .ai import AiService
+from .models import dto
+
+class AiService(AiService):
+    """
+    扩展的 AiService 类，添加流式输出支持
+    Extended AiService class with streaming support
+    """
+    
+    def request_stream(self, method: str, endpoint: str, **kwargs) -> Generator[str, None, None]:
+        """
+        发送流式请求并逐行返回数据
+        Send streaming request and yield data line by line
+        """
+        response = self._client.session.request(
+            method=method,
+            url=f"{self._client.base_url}{endpoint}",
+            stream=True,  # 启用流式响应
+            **kwargs
+        )
+        response.raise_for_status()
+        response.encoding = 'utf-8'  # 强制使用 UTF-8 解码
+        
+        # 逐行读取流式响应
+        for line in response.iter_lines(decode_unicode=True):
+            if line:
+                # 处理 Server-Sent Events 格式
+                if line.startswith('data: '):
+                    data = line[6:]  # 移除 'data: ' 前缀
+                    if data.strip() == '[DONE]':
+                        break
+                    yield data
+                elif line.strip():
+                    # 处理其他格式的流式数据
+                    yield line
+
+    # AI 对话。调用者需有代码写权限（CI 中使用 CNB_TOKEN 不检查写权限）。AI chat completions. Requires caller to have repo write permission (except when using CNB_TOKEN in CI).
+    def ai_chat_completions(self,
+                          repo: str,
+                          body_params: dto.AiChatCompletionsReq,
+                          ) -> Union[dto.AiChatCompletionsResult, Generator[str, None, None]]:
+        u = "/%s/-/ai/chat/completions" % (repo,)
+        
+        # 根据 stream 参数决定输出格式
+        if body_params.stream:
+            # 流式输出：返回生成器
+            return self.request_stream(
+                method="POST",
+                endpoint=u,
+                json=body_params.to_dict(),
+            )
+        else:
+            # 非流式输出：使用标准请求
+            data = self._client.request(
+                method="POST", 
+                endpoint=u,
+                json=body_params.to_dict(),
+            )
+            return dto.AiChatCompletionsResult.safe_parse(data)
+
+    def ai_chat_completions_stream(self,
+                                 repo: str,
+                                 body_params: dto.AiChatCompletionsReq,
+                                 ) -> Generator[str, None, None]:
+        # 强制启用流式输出
+        body_params.stream = True
+        
+        # 直接调用优化后的 ai_chat_completions 方法
+        return self.ai_chat_completions(repo, body_params)
+
+    def ai_chat_completions_stream_parsed(self,
+                                        repo: str,
+                                        body_params: dto.AiChatCompletionsReq,
+                                        ) -> Generator[dict, None, None]:
+        stream_generator = self.ai_chat_completions_stream(repo, body_params)
+        
+        for chunk in stream_generator:
+            try:
+                # 尝试解析 JSON 数据
+                parsed_data = json.loads(chunk)
+                yield parsed_data
+            except json.JSONDecodeError:
+                # 如果不是有效的 JSON，跳过或记录错误
+                continue
+
+    def ai_chat_completions_stream_content(self,
+                                       repo: str,
+                                       body_params: dto.AiChatCompletionsReq,
+                                       ) -> Generator[str, None, None]:
+        for parsed_data in self.ai_chat_completions_stream_parsed(repo, body_params):
+            # 提取 choices[0].delta.content 或类似字段
+            if isinstance(parsed_data, dict):
+                choices = parsed_data.get('choices', [])
+                if choices and len(choices) > 0:
+                    delta = choices[0].get('delta', {})
+                    content = delta.get('content')
+                    if content:
+                        yield content

python_cnb-1.17.16/cnb/assets.py

@@ -0,0 +1,42 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# source: https://api.cnb-dev.woa.com/swagger.json
+
+from typing import Optional
+from .models import dto
+class AssetsService:    
+	def __init__(self, client):
+		self._client = client
+
+	# 通过 asset 记录 id 删除一个 asset
+	def delete_asset(self,
+		repo: str,
+		assetID: str,
+	    ):
+		u = "/%s/-/assets/%s" % (repo, assetID, )
+
+		data = self._client.request(
+			method="DELETE", 
+			endpoint=u,
+			)
+		return 
+		
+	# 仓库的 asset 记录列表
+	def list_assets(self,
+		slug: str,
+	    page: Optional[int] = None,
+		page_size: Optional[int] = None,
+		) -> list[dto.AssetRecords]:
+		u = "/%s/-/list-assets" % (slug, )
+
+		query_params = {
+			"page": page,
+			"page_size": page_size,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return [dto.AssetRecords.safe_parse(item) for item in data]
+		
+	

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/badge.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/build.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
@@ -9,18 +7,31 @@ class BuildService:
 	def __init__(self, client):
 		self._client = client
 
+	# 同步仓库分支下的定时任务。 Synchronize the content under the repository branch.
+	def build_crontab_sync(self,
+		repo: str,
+		branch: str,
+	    ) -> dto.BuildCommonResult:
+		u = "/%s/-/build/crontab/sync/%s" % (repo, branch, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			)
+		return dto.BuildCommonResult.safe_parse(data)
+		
 	# 删除流水线日志内容。Delete pipeline logs content.
 	def build_logs_delete(self,
 		repo: str,
 		sn: str,
-	    ) -> dto.BuildLogsDeleteResult:
+	    ) -> dto.BuildCommonResult:
 		u = "/%s/-/build/logs/%s" % (repo, sn, )
 
 		data = self._client.request(
 			method="DELETE", 
 			endpoint=u,
 			)
-		return dto.BuildLogsDeleteResult.safe_parse(data)
+		return dto.BuildCommonResult.safe_parse(data)
 		
 	# 流水线runner日志下载。Pipeline runner log download.
 	def build_runner_download_log(self,
@@ -42,7 +53,7 @@ class BuildService:
 		endTime: Optional[str] = None,
 		event: Optional[str] = None,
 		page: Optional[int] = None,
-		pagesize: Optional[int] = None,
+		page_size: Optional[int] = None,
 		sha: Optional[str] = None,
 		sn: Optional[str] = None,
 		sourceRef: Optional[str] = None,
@@ -58,7 +69,7 @@ class BuildService:
 			"endTime": endTime,
 			"event": event,
 			"page": page,
-			"pagesize": pagesize,
+			"page_size": page_size,
 			"sha": sha,
 			"sn": sn,
 			"sourceRef": sourceRef,

python_cnb-1.17.16/cnb/charge.py

@@ -0,0 +1,22 @@
+# Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
+# source: https://api.cnb-dev.woa.com/swagger.json
+
+from typing import Optional
+from .models import dto
+class ChargeService:    
+	def __init__(self, client):
+		self._client = client
+
+	# 查看特权额度
+	def get_special_amount(self,
+		slug: str,
+	    ) -> dto.SpecialAmount:
+		u = "/%s/-/charge/special-amount" % (slug, )
+
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			)
+		return dto.SpecialAmount.safe_parse(data)
+		
+	

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/cnb.py

@@ -1,20 +1,18 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 from .activities import ActivitiesService
-from .ai import AiService
+from .ai_ext import AiService
 from .assets import AssetsService
 from .badge import BadgeService
 from .build import BuildService
-from .collaborators import CollaboratorsService
-from .contributors import ContributorsService
+from .charge import ChargeService
 from .event import EventService
 from .followers import FollowersService
 from .git import GitService
 from .gitsettings import GitsettingsService
 from .issues import IssuesService
 from .knowledgebase import KnowledgebaseService
+from .members import MembersService
 from .missions import MissionsService
 from .organizations import OrganizationsService
 from .pulls import PullsService
@@ -36,14 +34,14 @@ class CNBServices:
 		self.assets = AssetsService(client)
 		self.badge = BadgeService(client)
 		self.build = BuildService(client)
-		self.collaborators = CollaboratorsService(client)
-		self.contributors = ContributorsService(client)
+		self.charge = ChargeService(client)
 		self.event = EventService(client)
 		self.followers = FollowersService(client)
 		self.git = GitService(client)
 		self.gitsettings = GitsettingsService(client)
 		self.issues = IssuesService(client)
 		self.knowledgebase = KnowledgebaseService(client)
+		self.members = MembersService(client)
 		self.missions = MissionsService(client)
 		self.organizations = OrganizationsService(client)
 		self.pulls = PullsService(client)

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/event.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/followers.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/git.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
@@ -40,6 +38,19 @@ class GitService:
 			)
 		return 
 		
+	# 锁定分支
+	def create_branch_lock(self,
+		repo: str,
+		branch: str,
+	    ):
+		u = "/%s/-/git/branch-locks/%s" % (repo, branch, )
+
+		data = self._client.request(
+			method="POST", 
+			endpoint=u,
+			)
+		return 
+		
 	# 创建一个 tag。Create a tag.
 	def create_tag(self,
 		repo: str,
@@ -67,6 +78,19 @@ class GitService:
 			)
 		return 
 		
+	# 解除锁定分支
+	def delete_branch_lock(self,
+		repo: str,
+		branch: str,
+	    ):
+		u = "/%s/-/git/branch-locks/%s" % (repo, branch, )
+
+		data = self._client.request(
+			method="DELETE", 
+			endpoint=u,
+			)
+		return 
+		
 	# 删除指定 commit 的元数据。Delete commit annotation.
 	def delete_commit_annotation(self,
 		repo: str,
@@ -213,6 +237,25 @@ class GitService:
 			)
 		return [web.CommitAnnotationInBatch.safe_parse(item) for item in data]
 		
+	# 发起一个获取 commits 附件的请求， 302到有一定效期的下载地址。Get a request to fetch a commit assets and returns 302 redirect to the assets URL with specific valid time.
+	def get_commit_assets(self,
+		repo: str,
+		commit_id: str,
+		filename: str,
+	    share: Optional[bool] = None,
+		):
+		u = "/%s/-/commit-assets/download/%s/%s" % (repo, commit_id, filename, )
+
+		query_params = {
+			"share": share,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+		
 	# 查询指定 commit 的附件。List commit assets.
 	def get_commit_assets_by_sha(self,
 		repo: str,
@@ -299,6 +342,24 @@ class GitService:
 			)
 		return openapi.HeadRef.safe_parse(data)
 		
+	# 获取 git lfs 文件下载链接
+	def get_presigned_lfsdownload_link(self,
+		slug: str,
+		oid: str,
+	    name: Optional[str] = None,
+		):
+		u = "/%s/-/lfs/%s" % (slug, oid, )
+
+		query_params = {
+			"name": name,
+			}
+		data = self._client.request(
+			method="GET", 
+			endpoint=u,
+			params=query_params,
+			)
+		return 
+		
 	# 获得仓库指定文件内容
 	def get_raw(self,
 		repo: str,
@@ -416,12 +477,17 @@ class GitService:
 		sha1: str,
 		upload_token: str,
 		asset_path: str,
-	    ):
+	    ttl: Optional[int] = None,
+		):
 		u = "/%s/-/git/commit-assets/%s/asset-upload-confirmation/%s/%s" % (repo, sha1, upload_token, asset_path, )
 
+		query_params = {
+			"ttl": ttl,
+			}
 		data = self._client.request(
 			method="POST", 
 			endpoint=u,
+			params=query_params,
 			)
 		return 
 		

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/gitsettings.py

@@ -1,11 +1,8 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
 from .models import api
-from .models import web
 class GitsettingsService:    
 	def __init__(self, client):
 		self._client = client
@@ -116,7 +113,7 @@ class GitsettingsService:
 	# 更新仓库云原生构建设置。Update pipeline settings.
 	def put_pipeline_settings(self,
 		repo: str,
-	    body_params: web.PipelineSettings,
+	    body_params: api.PipelineSettings,
 		):
 		u = "/%s/-/settings/cloud-native-build" % (repo, )
 

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/issues.py

@@ -1,11 +1,10 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional
 from .models import api
 from .models import git_woa_com_cnb_monorepo_git_internal_app_vcs_service_bff_api
+from .models import openapi
 class IssuesService:    
 	def __init__(self, client):
 		self._client = client
@@ -124,12 +123,14 @@ class IssuesService:
 	def list_issue_comments(self,
 		repo: str,
 		number: str,
-	    page: Optional[int] = None,
+	    sort: Optional[str] = None,
+		page: Optional[int] = None,
 		page_size: Optional[int] = None,
 		) -> list[api.IssueComment]:
 		u = "/%s/-/issues/%s/comments" % (repo, number, )
 
 		query_params = {
+			"sort": sort,
 			"page": page,
 			"page_size": page_size,
 			}
@@ -169,6 +170,7 @@ class IssuesService:
 		keyword: Optional[str] = None,
 		priority: Optional[str] = None,
 		labels: Optional[str] = None,
+		labels_operator: Optional[str] = None,
 		authors: Optional[str] = None,
 		assignees: Optional[str] = None,
 		updated_time_begin: Optional[str] = None,
@@ -186,6 +188,7 @@ class IssuesService:
 			"keyword": keyword,
 			"priority": priority,
 			"labels": labels,
+			"labels_operator": labels_operator,
 			"authors": authors,
 			"assignees": assignees,
 			"updated_time_begin": updated_time_begin,
@@ -307,4 +310,19 @@ class IssuesService:
 			)
 		return api.IssueDetail.safe_parse(data)
 		
+	# 批量更新Issue自定义属性值
+	def update_issue_properties(self,
+		repo: str,
+		number: str,
+	    body_params: openapi.IssuePropertiesForm,
+		) -> api.IssuePropertyUpdateResult:
+		u = "/%s/-/issues/%s/property" % (repo, number, )
+
+		data = self._client.request(
+			method="PATCH", 
+			endpoint=u,
+			json=body_params.to_dict(),
+			)
+		return api.IssuePropertyUpdateResult.safe_parse(data)
+		
 	

{python_cnb-0.8.0b1 → python_cnb-1.17.16}/cnb/knowledgebase.py

@@ -1,6 +1,4 @@
 # Code generated by cnb.cool/cnb/sdk/cnb-sdk-generator. DO NOT EDIT.
-# versions:
-#    cnb-sdk-generator: 1.0.2
 # source: https://api.cnb-dev.woa.com/swagger.json
 
 from typing import Optional