bge-python-sdk 0.7.0__tar.gz → 2.0.0__tar.gz

{bge-python-sdk-0.7.0 → bge_python_sdk-2.0.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 teambge
+Copyright (c) 2026 teambge
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

bge_python_sdk-2.0.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include pytest.ini
+recursive-include completions *
+include bgesdk/py.typed
+
+# 排除编译产物
+global-exclude *.pyc
+global-exclude *.pyo
+recursive-exclude * __pycache__

bge_python_sdk-2.0.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: bge-python-sdk
+Version: 2.0.0
+Summary: 可用于调用 BGE 开放平台的相关接口。
+Author-email: leafcoder <leafcoder@gmail.com>, xiangji1204 <xiangji1204@genomics.cn>
+Maintainer-email: leafcoder <leafcoder@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/teambge/bge-python-sdk
+Keywords: bge-python-sdk,bge,bgesdk,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: oss2>=2.15.0
+Requires-Dist: requests_toolbelt>=1.0.0
+Requires-Dist: aliyun-python-sdk-core>=2.13.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: rich_argparse>=1.4.0
+Requires-Dist: argcomplete>=2.0.0
+Requires-Dist: python-minifier>=2.4.0
+Requires-Dist: qprompt>=0.16.0
+Requires-Dist: cython>=0.29.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: requests-mock>=1.9.0; extra == "test"
+
+
+<div align="center">
+
+# BGE 开放平台 SDK - Python 版
+
+
+<p>
+    <!-- Place this tag where you want the button to render. -->
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk/subscription" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Watch teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/watchers/teambge/bge-python-sdk?style=social">
+    </a>
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Star teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/stars/teambge/bge-python-sdk?style=social">
+    </a>
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk/fork" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Fork teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/forks/teambge/bge-python-sdk?style=social">
+    </a>
+</p>
+
+<p>
+    <img src="https://img.shields.io/github/v/release/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/v/release/teambge/bge-python-sdk" alt="GitHub release (latest by date)">
+    <img src="https://img.shields.io/github/languages/top/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/languages/top/teambge/bge-python-sdk" alt="GitHub top language">
+    <img src="https://img.shields.io/github/languages/code-size/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/languages/code-size/teambge/bge-python-sdk" alt="GitHub code size in bytes">
+    <img src="https://img.shields.io/github/commit-activity/w/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/commit-activity/w/teambge/bge-python-sdk" alt="GitHub commit activity">
+    <img src="https://static.pepy.tech/personalized-badge/bge-python-sdk?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" data-origin="https://static.pepy.tech/personalized-badge/bge-python-sdk?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" alt="PyPI - Downloads">
+</p>
+
+<pre>
+    ____  ____________   ______  __________  ______  _   __   _____ ____  __ __
+   / __ )/ ____/ ____/  / __ \ \/ /_  __/ / / / __ \/ | / /  / ___// __ \/ //_/
+  / __  / / __/ __/    / /_/ /\  / / / / /_/ / / / /  |/ /   \__ \/ / / / ,<   
+ / /_/ / /_/ / /___   / ____/ / / / / / __  / /_/ / /|  /   ___/ / /_/ / /| |  
+/_____/\____/_____/  /_/     /_/ /_/ /_/ /_/\____/_/ |_/   /____/_____/_/ |_| 
+</pre>
+
+</div>
+
+BGE 开放平台 是一个跨越多级数据的（多）组学数据平台，开发者在获得用户授权后，将可以通过开放平台提供的 API 访问关联用户的（多）组学数据，甚至写入数据。
+
+基于开放平台 API，开发者可避免重复开发采样、提取、测序和生信分析等繁复的流程，直接使用清洁的结构化数据。
+
+开发者可以通过开放平台提供的 API 创建极具创意性的（多）组学应用，如：
+
+* 包含药物代谢或药物服用建议的应用
+* 包含体检数据和营养代谢基因的餐饮应用
+* 包含肠道菌群数据和痛风相关基因的痛风管理应用
+* 基于祖源成分的社交网络应用，等等
+
+BGE 开放平台 API 基于 OAuth 2.0 开发，并使用 SSL/TLS 加密传输，确保用户数据正确无误地授权，并安全地传输到第三方应用，确保用户数据不会被未经授权的应用获得。
+
+# 安装
+
+推荐使用 pip 进行安装。
+
+```shell
+$ pip install -U bge-python-sdk
+```
+
+或者
+
+```shell
+$ make install
+```
+
+再或者
+
+```shell
+$ pip install .
+```
+
+# SDK 文档
+
+更加详细的 SDK 文档请查看 [SDK Documents](https://api.bge.genomics.cn/doc/#/sdk/README)。
+
+# 快速开始
+
+BGE 开放平台支持 OAuth2 的两种模式，分别是用户授权模式、客户端模式。
+
+详情请参考开放平台文档 [https://api.bge.genomics.cn/doc](https://api.bge.genomics.cn/doc) 。
+
+## ENDPOINTS
+
+BGE 开放平台提供了如下可用的 `endpoint`。
+
+| endpoint                    | 解释                                                        |
+| --------------------------- | ----------------------------------------------------------- |
+| https://api.bge.genomics.cn | **线上环境** 主域名地址                                     |
+| https://api.bge.omgut.com   | **线上环境** 副域名地址，主域名地址不可用时可替换此域名地址 |
+
+## 授权码模式
+
+```python
+from bgesdk import OAuth2, API
+
+code = '???????'  # 用户确认授权后平台返回的授权码
+client_id = 'demo'
+client_secret = 'demo'
+redirect_uri = 'http://test.cn'
+oauth2 = OAuth2(
+    client_id, client_secret,
+    endpoint='https://api.bge.genomics.cn', max_retries=3, timeout=16,
+    verbose=False)
+token = oauth2.exchange_authorization_code(code, redirect_uri)
+
+api = oauth2.get_api(token.access_token)
+print(api.get_user())
+
+api = API(token.access_token)
+print(api.get_user())
+```
+
+## 客户端模式
+
+```python
+from bgesdk import OAuth2, API
+
+client_id = 'demo'
+client_secret = 'demo'
+oauth2 = OAuth2(
+    client_id, client_secret,
+    endpoint='https://api.bge.genomics.cn', max_retries=3, timeout=16,
+    verbose=False)
+token = oauth2.get_credentials_token()
+
+api = oauth2.get_api(token.access_token)
+print(api.get_variants('E-B1243433', 'rs333'))
+
+api = API(token.access_token)
+print(api.get_variants('E-B1243433', 'rs333'))
+```
+
+# Contributors
+
+* xiangji1204's [github](https://github.com/xiangji1204)
+* leafcoder(leafcoder@gmail.com)'s [github](https://github.com/leafcoder)

{bge-python-sdk-0.7.0 → bge_python_sdk-2.0.0}/README.md

@@ -65,7 +65,7 @@ $ make install
 再或者
 
 ```shell
-$ python setup.py install
+$ pip install .
 ```
 
 # SDK 文档

bge_python_sdk-2.0.0/bge_python_sdk.egg-info/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: bge-python-sdk
+Version: 2.0.0
+Summary: 可用于调用 BGE 开放平台的相关接口。
+Author-email: leafcoder <leafcoder@gmail.com>, xiangji1204 <xiangji1204@genomics.cn>
+Maintainer-email: leafcoder <leafcoder@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/teambge/bge-python-sdk
+Keywords: bge-python-sdk,bge,bgesdk,sdk
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Requires-Dist: oss2>=2.15.0
+Requires-Dist: requests_toolbelt>=1.0.0
+Requires-Dist: aliyun-python-sdk-core>=2.13.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: rich_argparse>=1.4.0
+Requires-Dist: argcomplete>=2.0.0
+Requires-Dist: python-minifier>=2.4.0
+Requires-Dist: qprompt>=0.16.0
+Requires-Dist: cython>=0.29.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: requests-mock>=1.9.0; extra == "test"
+
+
+<div align="center">
+
+# BGE 开放平台 SDK - Python 版
+
+
+<p>
+    <!-- Place this tag where you want the button to render. -->
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk/subscription" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Watch teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/watchers/teambge/bge-python-sdk?style=social">
+    </a>
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Star teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/stars/teambge/bge-python-sdk?style=social">
+    </a>
+    <a class="github-button" href="https://github.com/teambge/bge-python-sdk/fork" data-color-scheme="no-preference: light; light: light; dark: dark;" data-show-count="true" aria-label="Fork teambge/bge-python-sdk on GitHub">
+        <img alt="GitHub forks" src="https://img.shields.io/github/forks/teambge/bge-python-sdk?style=social">
+    </a>
+</p>
+
+<p>
+    <img src="https://img.shields.io/github/v/release/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/v/release/teambge/bge-python-sdk" alt="GitHub release (latest by date)">
+    <img src="https://img.shields.io/github/languages/top/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/languages/top/teambge/bge-python-sdk" alt="GitHub top language">
+    <img src="https://img.shields.io/github/languages/code-size/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/languages/code-size/teambge/bge-python-sdk" alt="GitHub code size in bytes">
+    <img src="https://img.shields.io/github/commit-activity/w/teambge/bge-python-sdk" data-origin="https://img.shields.io/github/commit-activity/w/teambge/bge-python-sdk" alt="GitHub commit activity">
+    <img src="https://static.pepy.tech/personalized-badge/bge-python-sdk?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" data-origin="https://static.pepy.tech/personalized-badge/bge-python-sdk?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" alt="PyPI - Downloads">
+</p>
+
+<pre>
+    ____  ____________   ______  __________  ______  _   __   _____ ____  __ __
+   / __ )/ ____/ ____/  / __ \ \/ /_  __/ / / / __ \/ | / /  / ___// __ \/ //_/
+  / __  / / __/ __/    / /_/ /\  / / / / /_/ / / / /  |/ /   \__ \/ / / / ,<   
+ / /_/ / /_/ / /___   / ____/ / / / / / __  / /_/ / /|  /   ___/ / /_/ / /| |  
+/_____/\____/_____/  /_/     /_/ /_/ /_/ /_/\____/_/ |_/   /____/_____/_/ |_| 
+</pre>
+
+</div>
+
+BGE 开放平台 是一个跨越多级数据的（多）组学数据平台，开发者在获得用户授权后，将可以通过开放平台提供的 API 访问关联用户的（多）组学数据，甚至写入数据。
+
+基于开放平台 API，开发者可避免重复开发采样、提取、测序和生信分析等繁复的流程，直接使用清洁的结构化数据。
+
+开发者可以通过开放平台提供的 API 创建极具创意性的（多）组学应用，如：
+
+* 包含药物代谢或药物服用建议的应用
+* 包含体检数据和营养代谢基因的餐饮应用
+* 包含肠道菌群数据和痛风相关基因的痛风管理应用
+* 基于祖源成分的社交网络应用，等等
+
+BGE 开放平台 API 基于 OAuth 2.0 开发，并使用 SSL/TLS 加密传输，确保用户数据正确无误地授权，并安全地传输到第三方应用，确保用户数据不会被未经授权的应用获得。
+
+# 安装
+
+推荐使用 pip 进行安装。
+
+```shell
+$ pip install -U bge-python-sdk
+```
+
+或者
+
+```shell
+$ make install
+```
+
+再或者
+
+```shell
+$ pip install .
+```
+
+# SDK 文档
+
+更加详细的 SDK 文档请查看 [SDK Documents](https://api.bge.genomics.cn/doc/#/sdk/README)。
+
+# 快速开始
+
+BGE 开放平台支持 OAuth2 的两种模式，分别是用户授权模式、客户端模式。
+
+详情请参考开放平台文档 [https://api.bge.genomics.cn/doc](https://api.bge.genomics.cn/doc) 。
+
+## ENDPOINTS
+
+BGE 开放平台提供了如下可用的 `endpoint`。
+
+| endpoint                    | 解释                                                        |
+| --------------------------- | ----------------------------------------------------------- |
+| https://api.bge.genomics.cn | **线上环境** 主域名地址                                     |
+| https://api.bge.omgut.com   | **线上环境** 副域名地址，主域名地址不可用时可替换此域名地址 |
+
+## 授权码模式
+
+```python
+from bgesdk import OAuth2, API
+
+code = '???????'  # 用户确认授权后平台返回的授权码
+client_id = 'demo'
+client_secret = 'demo'
+redirect_uri = 'http://test.cn'
+oauth2 = OAuth2(
+    client_id, client_secret,
+    endpoint='https://api.bge.genomics.cn', max_retries=3, timeout=16,
+    verbose=False)
+token = oauth2.exchange_authorization_code(code, redirect_uri)
+
+api = oauth2.get_api(token.access_token)
+print(api.get_user())
+
+api = API(token.access_token)
+print(api.get_user())
+```
+
+## 客户端模式
+
+```python
+from bgesdk import OAuth2, API
+
+client_id = 'demo'
+client_secret = 'demo'
+oauth2 = OAuth2(
+    client_id, client_secret,
+    endpoint='https://api.bge.genomics.cn', max_retries=3, timeout=16,
+    verbose=False)
+token = oauth2.get_credentials_token()
+
+api = oauth2.get_api(token.access_token)
+print(api.get_variants('E-B1243433', 'rs333'))
+
+api = API(token.access_token)
+print(api.get_variants('E-B1243433', 'rs333'))
+```
+
+# Contributors
+
+* xiangji1204's [github](https://github.com/xiangji1204)
+* leafcoder(leafcoder@gmail.com)'s [github](https://github.com/leafcoder)

{bge-python-sdk-0.7.0 → bge_python_sdk-2.0.0}/bge_python_sdk.egg-info/SOURCES.txt

@@ -1,10 +1,8 @@
 LICENSE
 MANIFEST.in
 README.md
+pyproject.toml
 pytest.ini
-requirements.txt
-setup.cfg
-setup.py
 bge_python_sdk.egg-info/PKG-INFO
 bge_python_sdk.egg-info/SOURCES.txt
 bge_python_sdk.egg-info/dependency_links.txt
@@ -19,18 +17,27 @@ bgesdk/error.py
 bgesdk/fs.py
 bgesdk/http.py
 bgesdk/models.py
+bgesdk/py.typed
 bgesdk/utils.py
 bgesdk/version.py
+bgesdk/api/__init__.py
+bgesdk/api/api.py
+bgesdk/api/base.py
+bgesdk/api/file.py
+bgesdk/api/microbiome.py
+bgesdk/api/misc.py
+bgesdk/api/model.py
+bgesdk/api/samples.py
+bgesdk/api/stream.py
+bgesdk/api/variants.py
 bgesdk/management/__init__.py
 bgesdk/management/command.py
 bgesdk/management/constants.py
 bgesdk/management/utils.py
-bgesdk/management/validate.py
 bgesdk/management/commands/__init__.py
 bgesdk/management/commands/config.py
 bgesdk/management/commands/login.py
 bgesdk/management/commands/model.py
-bgesdk/management/commands/model_doc.py
 bgesdk/management/commands/token.py
 bgesdk/management/commands/workon.py
 bgesdk/management/commands/api/__init__.py
@@ -53,14 +60,42 @@ bgesdk/management/commands/api/commands/id_meta.py
 bgesdk/management/commands/api/commands/task.py
 bgesdk/management/commands/api/commands/upload.py
 bgesdk/management/commands/api/commands/upload_dir.py
+bgesdk/management/model_runtime/__init__.py
+bgesdk/management/model_runtime/model_runtime.py
+bgesdk/management/model_runtime/server/model_license.py
+bgesdk/management/model_runtime/server/secure.py
+bgesdk/management/model_runtime/server/setup.py
+bgesdk/management/model_runtime/server/bge_model_server/__init__.py
+bgesdk/management/model_runtime/server/bge_model_server/app/__init__.py
+bgesdk/management/model_runtime/server/bge_model_server/app/__main__.py
+bgesdk/management/model_runtime/server/bge_model_server/app/app_fastapi.py
+bgesdk/management/model_runtime/server/bge_model_server/app/app_tornado.py
+bgesdk/management/model_runtime/server/bge_model_server/app/logging_conf.py
+bgesdk/management/model_runtime/server/build/lib/model_license.py
+bgesdk/management/model_runtime/server/build/lib/secure.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/__init__.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/__init__.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/__main__.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/app_fastapi.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/app_tornado.py
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/logging_conf.py
+bgesdk/management/model_runtime/server/wheels/bge_model_server-0.1.0-py3-none-any.whl
+completions/_bge
+completions/bge.bash
 tests/__init__.py
 tests/conftest.py
 tests/test_abundance.py
+tests/test_api_offline.py
+tests/test_api_structure.py
+tests/test_error.py
 tests/test_fs.py
 tests/test_model.py
 tests/test_models.py
+tests/test_models_offline.py
 tests/test_oauth2.py
 tests/test_phenotype.py
 tests/test_samples.py
+tests/test_token.py
 tests/test_user.py
-tests/test_variants.py
+tests/test_variants.py
+tests/test_wgs.py

{bge-python-sdk-0.7.0 → bge_python_sdk-2.0.0}/bge_python_sdk.egg-info/entry_points.txt

@@ -1,3 +1,2 @@
 [console_scripts]
 bge = bgesdk.__main__:main
-

bge_python_sdk-2.0.0/bge_python_sdk.egg-info/requires.txt

@@ -0,0 +1,15 @@
+requests>=2.25.0
+oss2>=2.15.0
+requests_toolbelt>=1.0.0
+aliyun-python-sdk-core>=2.13.0
+rich>=10.0.0
+rich_argparse>=1.4.0
+argcomplete>=2.0.0
+python-minifier>=2.4.0
+qprompt>=0.16.0
+cython>=0.29.0
+
+[test]
+pytest>=7.0
+pytest-cov>=4.0
+requests-mock>=1.9.0

bge_python_sdk-2.0.0/bge_python_sdk.egg-info/top_level.txt

@@ -0,0 +1,6 @@
+bgesdk
+completions
+dist
+docs
+htmlcov
+tests

bge_python_sdk-2.0.0/bgesdk/__init__.py

@@ -0,0 +1,5 @@
+from .client import API, OAuth2, endpoints
+from .fs import FileItem
+from .version import __version__
+
+__all__ = ['API', 'OAuth2', 'endpoints', 'FileItem', '__version__']

bge_python_sdk-2.0.0/bgesdk/__main__.py

@@ -0,0 +1,66 @@
+from . import version
+from .management import commands as commands_package
+from .management.command import CommandError, GroupedRichHelpFormatter
+from .management.utils import discover_commands, output
+
+from typing import Any
+
+import argparse
+import sys
+
+argcomplete: Any = None  # 提供 shell 自动补全（可选依赖），未安装时为 None
+try:
+    import argcomplete  # type: ignore[no-redef]
+except ImportError:
+    pass
+
+try:
+    import readline  # noqa: F401  # 启用交互式历史/补全等副作用
+except ImportError:
+    pass
+
+
+def init_parser():
+    parser = argparse.ArgumentParser(
+        description=(
+            'BGE 开放平台 SDK 命令行工具提供了初始化模型脚手架、部署模型、'
+            '初始化模型文档配置文件、上传图片、部署模型文档等命令。'
+        ),
+        formatter_class=GroupedRichHelpFormatter,
+    )
+    parser.add_argument(
+        '-V',
+        '--version',
+        action='version',
+        help='显示当前 BGE 开放平台 Python SDK 版本号。',
+        version=f'version {version.__version__}',
+    )
+    subparsers = parser.add_subparsers(
+        dest='command', help='SDK 命令行工具可选子命令。', required=False
+    )
+    discover_commands(commands_package, subparsers)
+    return parser
+
+
+def main():
+    parser = init_parser()
+    if argcomplete is not None:
+        argcomplete.autocomplete(parser)
+    if len(sys.argv) < 2:
+        parser.print_help(sys.stderr)
+        sys.exit(1)
+    input_args = sys.argv[1:]
+    args = parser.parse_args(input_args)
+    try:
+        args.method(args)
+    except KeyboardInterrupt:
+        sys.exit(1)
+    except CommandError as exc:
+        sys.exit(exc.code)
+    except Exception as exc:  # noqa: BLE001  统一兜底，避免原始堆栈泄露
+        output(f'[red]命令执行出错：{exc}[/red]')
+        sys.exit(2)
+
+
+if __name__ == '__main__':
+    main()

bge_python_sdk-2.0.0/bgesdk/api/__init__.py

@@ -0,0 +1,5 @@
+"""按域拆分的 API 子模块包。"""
+
+from .api import API
+
+__all__ = ['API']

bge_python_sdk-2.0.0/bgesdk/api/api.py

@@ -0,0 +1,29 @@
+"""API 客户端聚合层。
+
+按域将能力拆分为多个 Mixin（Samples / Variants / Microbiome / File / Model /
+Stream / Misc），由本模块聚合为 ``API`` 类。对外公开接口与历史 ``client.API``
+保持一致，调用方无需变更（``api.get_samples(...)`` 等照常可用）。
+"""
+
+from .file import FileMixin
+from .microbiome import MicrobiomeMixin
+from .misc import MiscMixin
+from .model import ModelMixin
+from .samples import SamplesMixin
+from .stream import StreamMixin
+from .variants import VariantsMixin
+
+
+class API(
+    SamplesMixin,
+    VariantsMixin,
+    MicrobiomeMixin,
+    FileMixin,
+    ModelMixin,
+    StreamMixin,
+    MiscMixin,
+):
+    """BGE 开放平台接口调用客户端。
+
+    基础设施与账户域由 ``APIBase`` 经各 Mixin 间接继承提供，其余按业务域分散于各 Mixin。
+    """