ctyun-cli 0.1.0a1__tar.gz

ctyun_cli-0.1.0a1/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: ctyun-cli
+Version: 0.1.0a1
+Summary: 天翼云CLI工具 - 基于终端的云资源管理平台
+Author: Your Name
+Author-email: your.email@example.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.31.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: tabulate>=0.9.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

ctyun_cli-0.1.0a1/README.md

@@ -0,0 +1,62 @@
+# 天翼云CLI工具
+
+基于终端的天翼云API操作平台，提供完整的云资源管理功能。
+
+## 功能特性
+
+- 🔐 **安全认证**: 基于AK/SK的签名认证机制
+- 🖥️ **ECS管理**: 云服务器生命周期管理
+- 💾 **存储管理**: 对象存储、云硬盘管理
+- 🌐 **网络管理**: VPC、弹性IP、安全组配置
+- 📊 **监控查询**: 资源监控和日志查询
+- ⚡ **批量操作**: 支持批量资源管理
+- 📝 **配置管理**: 灵活的配置文件支持
+
+## 项目结构
+
+```
+ctyun-cli/
+├── src/
+│   ├── auth/           # 认证模块
+│   ├── ecs/            # 云服务器管理
+│   ├── storage/        # 存储管理
+│   ├── network/        # 网络管理
+│   ├── monitor/        # 监控查询
+│   ├── cli/            # 命令行界面
+│   ├── config/         # 配置管理
+│   └── utils/          # 工具函数
+├── tests/              # 测试文件
+├── docs/               # 文档
+├── examples/           # 示例代码
+├── requirements.txt    # Python依赖
+├── setup.py           # 安装脚本
+└── README.md          # 项目说明
+```
+
+## 快速开始
+
+```bash
+# 安装依赖
+pip install -r requirements.txt
+
+# 配置认证信息
+python setup_config.py
+
+# 查看帮助
+python -m ctyun-cli --help
+
+# 列出所有云服务器
+python -m ctyun-cli ecs list
+
+# 创建云服务器
+python -m ctyun-cli ecs create --instance-type "s6.small" --image "img-ubuntu20"
+```
+
+## 技术栈
+
+- **语言**: Python 3.8+
+- **HTTP客户端**: requests
+- **CLI框架**: click
+- **配置管理**: configparser
+- **日志**: logging
+- **测试**: pytest

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.4
+Name: ctyun-cli
+Version: 0.1.0a1
+Summary: 天翼云CLI工具 - 基于终端的云资源管理平台
+Author: Your Name
+Author-email: your.email@example.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.31.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: tabulate>=0.9.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/SOURCES.txt

@@ -0,0 +1,30 @@
+README.md
+setup.py
+ctyun_cli.egg-info/PKG-INFO
+ctyun_cli.egg-info/SOURCES.txt
+ctyun_cli.egg-info/dependency_links.txt
+ctyun_cli.egg-info/entry_points.txt
+ctyun_cli.egg-info/requires.txt
+ctyun_cli.egg-info/top_level.txt
+src/__init__.py
+src/client.py
+src/auth/__init__.py
+src/auth/eop_signature.py
+src/auth/signature.py
+src/billing/__init__.py
+src/billing/client.py
+src/billing/commands.py
+src/cli/__init__.py
+src/cli/main.py
+src/config/__init__.py
+src/config/settings.py
+src/ecs/__init__.py
+src/ecs/client.py
+src/ecs/commands.py
+src/security/__init__.py
+src/security/client.py
+src/security/commands.py
+src/utils/__init__.py
+src/utils/cache.py
+src/utils/helpers.py
+tests/test_basic.py

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ctyun-cli = ctyun_cli:main

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/requires.txt

@@ -0,0 +1,10 @@
+requests>=2.31.0
+click>=8.1.0
+cryptography>=41.0.0
+colorama>=0.4.6
+tabulate>=0.9.0
+pyyaml>=6.0
+
+[dev]
+pytest>=7.4.0
+pytest-cov>=4.1.0

ctyun_cli-0.1.0a1/ctyun_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+ctyun_cli

ctyun_cli-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ctyun_cli-0.1.0a1/setup.py

@@ -0,0 +1,41 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="ctyun-cli",
+    version="0.1.0a1",
+    description="天翼云CLI工具 - 基于终端的云资源管理平台",
+    author="Your Name",
+    author_email="your.email@example.com",
+    packages=["ctyun_cli"] + ["ctyun_cli." + p for p in find_packages(where="src")],
+    package_dir={"ctyun_cli": "src"},
+    install_requires=[
+        "requests>=2.31.0",
+        "click>=8.1.0",
+        "cryptography>=41.0.0",
+        "colorama>=0.4.6",
+        "tabulate>=0.9.0",
+        "pyyaml>=6.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=7.4.0",
+            "pytest-cov>=4.1.0",
+        ]
+    },
+    entry_points={
+        "console_scripts": [
+            "ctyun-cli=ctyun_cli:main",
+        ],
+    },
+    python_requires=">=3.8",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+    ],
+)

ctyun_cli-0.1.0a1/src/__init__.py

@@ -0,0 +1,22 @@
+"""
+天翼云CLI工具
+"""
+
+__version__ = "1.0.0"
+__author__ = "Your Name"
+__email__ = "your.email@example.com"
+
+from .client import CTYUNClient, CTYUNAPIError
+from .config.settings import ConfigManager, config
+
+__all__ = [
+    'CTYUNClient',
+    'CTYUNAPIError',
+    'ConfigManager',
+    'config'
+]
+
+def main():
+    """CLI主入口函数"""
+    from .cli.main import cli
+    cli()

ctyun_cli-0.1.0a1/src/auth/__init__.py

@@ -0,0 +1,5 @@
+"""认证模块"""
+
+from .signature import CTYUNAuth
+
+__all__ = ['CTYUNAuth']

ctyun_cli-0.1.0a1/src/auth/eop_signature.py

@@ -0,0 +1,235 @@
+"""
+天翼云EOP签名认证模块
+实现基于EOP规范的AK/SK签名认证机制
+"""
+
+import hashlib
+import hmac
+import base64
+import uuid
+from datetime import datetime
+from urllib.parse import quote
+from typing import Dict, Any, Optional
+
+
+class CTYUNEOPAuth:
+    """天翼云EOP签名认证类"""
+
+    def __init__(self, access_key: str, secret_key: str):
+        """
+        初始化认证器
+
+        Args:
+            access_key: 访问密钥（AK）
+            secret_key: 密钥（SK）
+        """
+        self.access_key = access_key
+        self.secret_key = secret_key
+
+    def sign_request(self, method: str, url: str, query_params: Optional[Dict[str, Any]] = None,
+                    body: Optional[str] = None, extra_headers: Optional[Dict[str, str]] = None) -> Dict[str, str]:
+        """
+        对请求进行签名，返回完整的请求头
+
+        Args:
+            method: HTTP方法
+            url: 请求URL
+            query_params: 查询参数
+            body: 请求体
+            extra_headers: 额外的请求头
+
+        Returns:
+            包含签名的请求头字典
+        """
+        # 生成必需的请求头
+        request_id = str(uuid.uuid4())
+        eop_date = self._get_eop_date()
+
+        # 构建基础请求头
+        headers = {
+            'Content-Type': 'application/json',
+            'ctyun-eop-request-id': request_id,
+            'Eop-date': eop_date
+        }
+
+        # 添加额外的请求头
+        if extra_headers:
+            headers.update(extra_headers)
+
+        # 步骤一：构造待签名字符串 signature
+        signature_string = self._build_signature_string(
+            headers, query_params, body
+        )
+
+        # 步骤二：构造动态密钥 kdate
+        kdate = self._build_kdate(eop_date)
+
+        # 步骤三：构造 signature
+        signature = self._build_signature(signature_string, kdate)
+
+        # 步骤四：构造 Eop-Authorization
+        eop_authorization = self._build_eop_authorization(signature, headers)
+
+        # 添加认证头
+        headers['Eop-Authorization'] = eop_authorization
+
+        return headers
+
+    def _get_eop_date(self) -> str:
+        """
+        获取EOP格式的日期时间
+        格式：yyyyMMdd'T'HHmmss'Z'
+        注意：实际传时间为北京东八区UTC+8时间，TZ仅为格式，非UTC时间
+
+        Returns:
+            EOP格式的日期时间字符串
+        """
+        # 获取当前北京时间（UTC+8）
+        now = datetime.now()
+        return now.strftime('%Y%m%dT%H%M%SZ')
+
+    def _build_signature_string(self, headers: Dict[str, str],
+                                query_params: Optional[Dict[str, Any]] = None,
+                                body: Optional[str] = None) -> str:
+        """
+        构造待签名字符串
+        sigture = 需要进行签名的Header排序后的组合列表 + "\n" + encode的query + "\n" + toHex(sha256(原封的body))
+
+        Args:
+            headers: 请求头字典
+            query_params: 查询参数
+            body: 请求体
+
+        Returns:
+            待签名字符串
+        """
+        # 1. 构造需要签名的Header排序后的组合列表
+        # EOP强制要求 ctyun-eop-request-id、eop-date 必须进行签名
+        signed_header_names = ['ctyun-eop-request-id', 'eop-date']
+        
+        # 按字母顺序排序
+        signed_header_names.sort()
+        
+        # 构造 header_name:header_value\n 格式
+        header_list = []
+        for header_name in signed_header_names:
+            # 注意：查找header时不区分大小写，但构造签名字符串时必须用小写
+            header_value = None
+            for k, v in headers.items():
+                if k.lower() == header_name.lower():
+                    header_value = v
+                    break
+            
+            if header_value:
+                header_list.append(f"{header_name.lower()}:{header_value}\n")
+        
+        header_string = ''.join(header_list)
+
+        # 2. 构造编码后的query字符串
+        query_string = ''
+        if query_params:
+            # 对参数按key排序
+            sorted_params = sorted(query_params.items())
+            encoded_params = []
+            for key, value in sorted_params:
+                # 值需要进行URL编码
+                encoded_value = quote(str(value), safe='')
+                encoded_params.append(f"{key}={encoded_value}")
+            query_string = '&'.join(encoded_params)
+
+        # 3. 对body进行SHA256摘要并转十六进制
+        if body is None or body == '':
+            body = ''
+        body_hash = hashlib.sha256(body.encode('utf-8')).hexdigest()
+
+        # 拼接最终的待签名字符串
+        # 格式：header_string + "\n" + query_string + "\n" + body_hash
+        signature_string = f"{header_string}\n{query_string}\n{body_hash}"
+
+        return signature_string
+
+    def _build_kdate(self, eop_date: str) -> bytes:
+        """
+        构造动态密钥 kdate
+
+        步骤：
+        1. ktime = hmacSHA256(eop_date, sk)
+        2. kAk = hmacSHA256(ak, ktime)
+        3. kdate = hmacSHA256(eop_date的年月日值, kAk)
+
+        Args:
+            eop_date: EOP格式的日期时间
+
+        Returns:
+            动态密钥 kdate
+        """
+        # 1. 使用eop_date作为数据，sk作为密钥，算出ktime
+        ktime = hmac.new(
+            self.secret_key.encode('utf-8'),
+            eop_date.encode('utf-8'),
+            hashlib.sha256
+        ).digest()
+
+        # 2. 使用ak作为数据，ktime作为密钥，算出kAk
+        kAk = hmac.new(
+            ktime,
+            self.access_key.encode('utf-8'),
+            hashlib.sha256
+        ).digest()
+
+        # 3. 使用eop_date的年月日值作为数据，kAk作为密钥，算出kdate
+        # eop_date格式：20221107T093029Z，提取年月日：20221107
+        date_part = eop_date.split('T')[0]
+        kdate = hmac.new(
+            kAk,
+            date_part.encode('utf-8'),
+            hashlib.sha256
+        ).digest()
+
+        return kdate
+
+    def _build_signature(self, signature_string: str, kdate: bytes) -> str:
+        """
+        构造 signature
+        使用kdate作为密钥、signature_string作为数据，进行HMAC-SHA256，然后Base64编码
+
+        Args:
+            signature_string: 待签名字符串
+            kdate: 动态密钥
+
+        Returns:
+            Base64编码的签名
+        """
+        signature_bytes = hmac.new(
+            kdate,
+            signature_string.encode('utf-8'),
+            hashlib.sha256
+        ).digest()
+
+        # Base64编码
+        signature = base64.b64encode(signature_bytes).decode('utf-8')
+
+        return signature
+
+    def _build_eop_authorization(self, signature: str, headers: Dict[str, str]) -> str:
+        """
+        构造 Eop-Authorization 请求头
+        格式：ak Headers=header1;header2 Signature=xxx
+
+        Args:
+            signature: 签名
+            headers: 请求头字典
+
+        Returns:
+            Eop-Authorization 字符串
+        """
+        # 构造 Headers 部分（需要签名的header，按字母排序，用分号分隔）
+        signed_header_names = ['ctyun-eop-request-id', 'eop-date']
+        signed_header_names.sort()
+        headers_part = ';'.join(signed_header_names)
+
+        # 构造完整的 Eop-Authorization
+        # 格式：ak Headers=xxx Signature=xxx
+        eop_authorization = f"{self.access_key} Headers={headers_part} Signature={signature}"
+
+        return eop_authorization