fastssl 0.1.0__tar.gz

fastssl-0.1.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: fastssl
+Version: 0.1.0
+Summary: FastSSL - SSL证书管理SDK，支持申请、验证和获取SSL证书
+Author: FastSSL Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/fastssl
+Project-URL: Documentation, https://github.com/yourusername/fastssl
+Project-URL: Repository, https://github.com/yourusername/fastssl
+Keywords: ssl,certificate,ssl-certificate,zerossl,letsencrypt
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Security
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# FastSSL
+
+FastSSL 是一个用于管理SSL证书的Python SDK，支持申请、验证和获取SSL证书。
+
+签发密钥获取渠道：ssl.aa1.cn/user/
+## 安装
+
+```bash
+pip install fastssl
+```
+
+## 快速开始
+
+```python
+from fastssl import FastSSLClient
+
+# 初始化客户端
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请SSL证书
+result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl",  # 可选: zerossl, letsencrypt, google
+    validation_method="DNS"
+)
+
+# 验证域名
+verify_result = client.verify_domain(domain="example.com")
+
+# 获取证书信息
+cert_info = client.get_certificate_info(domain="example.com")
+
+# 一键申请并验证（便捷方法）
+full_result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+```
+
+## API 文档
+
+### FastSSLClient
+
+#### `__init__(api_key: str)`
+
+初始化FastSSL客户端。
+
+**参数:**
+- `api_key`: API密钥
+
+#### `create_certificate(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS")`
+
+申请SSL证书。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌，可选值: `zerossl`, `letsencrypt`, `google`
+- `validation_method`: 验证方式，默认为 `DNS`
+
+**返回:** 包含证书申请结果的字典
+
+#### `verify_domain(domain: str, max_retries: int = 10, retry_interval: int = 5)`
+
+验证域名并等待证书签发完成。如果验证成功但download_url为空，会自动重试。
+
+**参数:**
+- `domain`: 要验证的域名
+- `max_retries`: 最大重试次数（当download_url为空时）
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含验证结果的字典
+
+#### `get_certificate_info(domain: str)`
+
+获取证书信息，自动处理证书内容中的换行符。
+
+**参数:**
+- `domain`: 域名
+
+**返回:** 包含证书信息的字典
+
+#### `create_and_verify(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS", max_retries: int = 10, retry_interval: int = 5)`
+
+一键申请并验证证书的便捷方法。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌
+- `validation_method`: 验证方式
+- `max_retries`: 验证最大重试次数
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含完整流程结果的字典
+
+## 示例
+
+### 基本使用
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请证书
+create_result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+
+if create_result.get("success"):
+    print("证书申请成功！")
+    print(f"验证信息: {create_result.get('data', {}).get('verify_info')}")
+    
+    # 验证域名
+    verify_result = client.verify_domain("example.com")
+    
+    if verify_result.get("success"):
+        print("证书验证成功！")
+        print(f"下载地址: {verify_result.get('data', {}).get('download_url')}")
+        
+        # 获取证书信息
+        cert_info = client.get_certificate_info("example.com")
+        if cert_info.get("success"):
+            print("证书内容:")
+            print(cert_info.get("data", {}).get("crt_pem"))
+```
+
+### 一键申请并验证
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl",
+    max_retries=15,  # 最多重试15次
+    retry_interval=10  # 每次间隔10秒
+)
+
+if result.get("success"):
+    verify_data = result.get("verify_result", {}).get("data", {})
+    print(f"证书编号: {verify_data.get('certificate_no')}")
+    print(f"下载地址: {verify_data.get('download_url')}")
+```
+
+## 许可证
+
+MIT License
+
+## 支持
+
+如有问题或建议，请提交Issue。

fastssl-0.1.0/README.md

@@ -0,0 +1,154 @@
+# FastSSL
+
+FastSSL 是一个用于管理SSL证书的Python SDK，支持申请、验证和获取SSL证书。
+
+签发密钥获取渠道：ssl.aa1.cn/user/
+## 安装
+
+```bash
+pip install fastssl
+```
+
+## 快速开始
+
+```python
+from fastssl import FastSSLClient
+
+# 初始化客户端
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请SSL证书
+result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl",  # 可选: zerossl, letsencrypt, google
+    validation_method="DNS"
+)
+
+# 验证域名
+verify_result = client.verify_domain(domain="example.com")
+
+# 获取证书信息
+cert_info = client.get_certificate_info(domain="example.com")
+
+# 一键申请并验证（便捷方法）
+full_result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+```
+
+## API 文档
+
+### FastSSLClient
+
+#### `__init__(api_key: str)`
+
+初始化FastSSL客户端。
+
+**参数:**
+- `api_key`: API密钥
+
+#### `create_certificate(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS")`
+
+申请SSL证书。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌，可选值: `zerossl`, `letsencrypt`, `google`
+- `validation_method`: 验证方式，默认为 `DNS`
+
+**返回:** 包含证书申请结果的字典
+
+#### `verify_domain(domain: str, max_retries: int = 10, retry_interval: int = 5)`
+
+验证域名并等待证书签发完成。如果验证成功但download_url为空，会自动重试。
+
+**参数:**
+- `domain`: 要验证的域名
+- `max_retries`: 最大重试次数（当download_url为空时）
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含验证结果的字典
+
+#### `get_certificate_info(domain: str)`
+
+获取证书信息，自动处理证书内容中的换行符。
+
+**参数:**
+- `domain`: 域名
+
+**返回:** 包含证书信息的字典
+
+#### `create_and_verify(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS", max_retries: int = 10, retry_interval: int = 5)`
+
+一键申请并验证证书的便捷方法。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌
+- `validation_method`: 验证方式
+- `max_retries`: 验证最大重试次数
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含完整流程结果的字典
+
+## 示例
+
+### 基本使用
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请证书
+create_result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+
+if create_result.get("success"):
+    print("证书申请成功！")
+    print(f"验证信息: {create_result.get('data', {}).get('verify_info')}")
+    
+    # 验证域名
+    verify_result = client.verify_domain("example.com")
+    
+    if verify_result.get("success"):
+        print("证书验证成功！")
+        print(f"下载地址: {verify_result.get('data', {}).get('download_url')}")
+        
+        # 获取证书信息
+        cert_info = client.get_certificate_info("example.com")
+        if cert_info.get("success"):
+            print("证书内容:")
+            print(cert_info.get("data", {}).get("crt_pem"))
+```
+
+### 一键申请并验证
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl",
+    max_retries=15,  # 最多重试15次
+    retry_interval=10  # 每次间隔10秒
+)
+
+if result.get("success"):
+    verify_data = result.get("verify_result", {}).get("data", {})
+    print(f"证书编号: {verify_data.get('certificate_no')}")
+    print(f"下载地址: {verify_data.get('download_url')}")
+```
+
+## 许可证
+
+MIT License
+
+## 支持
+
+如有问题或建议，请提交Issue。

fastssl-0.1.0/fastssl/__init__.py

@@ -0,0 +1,8 @@
+"""
+FastSSL - SSL证书管理SDK
+"""
+
+from .client import FastSSLClient
+
+__version__ = "0.1.0"
+__all__ = ["FastSSLClient"]

fastssl-0.1.0/fastssl/client.py

@@ -0,0 +1,191 @@
+"""
+FastSSL客户端 - 用于与SSL证书API交互
+"""
+
+import requests
+import time
+from typing import Dict, Optional, Literal
+
+
+class FastSSLClient:
+    """FastSSL客户端类，用于管理SSL证书的申请、验证和获取"""
+    
+    BASE_URL = "https://ssl.aa1.cn/api/v1"
+    
+    def __init__(self, api_key: str):
+        """
+        初始化FastSSL客户端
+        
+        Args:
+            api_key: API密钥
+        """
+        self.api_key = api_key
+        self.session = requests.Session()
+    
+    def create_certificate(
+        self,
+        certificate_domain: str,
+        channel_type: Literal["zerossl", "letsencrypt", "google"] = "zerossl",
+        validation_method: str = "DNS"
+    ) -> Dict:
+        """
+        申请SSL证书
+        
+        Args:
+            certificate_domain: 需要验证的域名
+            channel_type: 证书品牌，可选值: zerossl, letsencrypt, google
+            validation_method: 验证方式，默认为DNS
+        
+        Returns:
+            包含证书申请结果的字典
+        """
+        url = f"{self.BASE_URL}/create"
+        
+        params = {
+            "api_key": self.api_key
+        }
+        
+        data = {
+            "channel_type": channel_type,
+            "certificate_domain": certificate_domain,
+            "validation_method": validation_method
+        }
+        
+        try:
+            # 使用 multipart/form-data 格式
+            # 传入空的 files 参数以强制使用 multipart/form-data
+            response = self.session.post(url, params=params, data=data, files={})
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.RequestException as e:
+            return {
+                "success": False,
+                "message": f"请求失败: {str(e)}",
+                "error": str(e)
+            }
+    
+    def verify_domain(
+        self,
+        domain: str,
+        max_retries: int = 10,
+        retry_interval: int = 5
+    ) -> Dict:
+        """
+        验证域名并等待证书签发完成
+        
+        Args:
+            domain: 要验证的域名
+            max_retries: 最大重试次数（当download_url为空时）
+            retry_interval: 重试间隔（秒）
+        
+        Returns:
+            包含验证结果的字典
+        """
+        url = f"{self.BASE_URL}/verify"
+        
+        params = {
+            "api_key": self.api_key,
+            "domain": domain
+        }
+        
+        try:
+            response = self.session.get(url, params=params)
+            response.raise_for_status()
+            result = response.json()
+            
+            # 如果验证成功但download_url为空，需要重试
+            if (result.get("success") and 
+                result.get("data", {}).get("download_url") == "" and
+                max_retries > 0):
+                time.sleep(retry_interval)
+                return self.verify_domain(domain, max_retries - 1, retry_interval)
+            
+            return result
+        except requests.exceptions.RequestException as e:
+            return {
+                "success": False,
+                "message": f"请求失败: {str(e)}",
+                "error": str(e)
+            }
+    
+    def get_certificate_info(self, domain: str) -> Dict:
+        """
+        获取证书信息
+        
+        Args:
+            domain: 域名
+        
+        Returns:
+            包含证书信息的字典，证书内容中的\n会被自动删除
+        """
+        url = f"{self.BASE_URL}/get_info"
+        
+        params = {
+            "api_key": self.api_key,
+            "domain": domain
+        }
+        
+        try:
+            response = self.session.get(url, params=params)
+            response.raise_for_status()
+            result = response.json()
+            
+            # 移除证书内容中的\n（包括转义的\n和实际的换行符）
+            if result.get("success") and "data" in result:
+                data = result["data"]
+                for key in ["crt_pem", "crt_key", "crt_bundle"]:
+                    if key in data and isinstance(data[key], str):
+                        # 删除转义的\n和实际的换行符
+                        data[key] = data[key].replace("\\n", "").replace("\n", "")
+            
+            return result
+        except requests.exceptions.RequestException as e:
+            return {
+                "success": False,
+                "message": f"请求失败: {str(e)}",
+                "error": str(e)
+            }
+    
+    def create_and_verify(
+        self,
+        certificate_domain: str,
+        channel_type: Literal["zerossl", "letsencrypt", "google"] = "zerossl",
+        validation_method: str = "DNS",
+        max_retries: int = 10,
+        retry_interval: int = 5
+    ) -> Dict:
+        """
+        一键申请并验证证书（便捷方法）
+        
+        Args:
+            certificate_domain: 需要验证的域名
+            channel_type: 证书品牌
+            validation_method: 验证方式
+            max_retries: 验证最大重试次数
+            retry_interval: 重试间隔（秒）
+        
+        Returns:
+            包含完整流程结果的字典
+        """
+        # 第一步：申请证书
+        create_result = self.create_certificate(
+            certificate_domain=certificate_domain,
+            channel_type=channel_type,
+            validation_method=validation_method
+        )
+        
+        if not create_result.get("success"):
+            return create_result
+        
+        # 第二步：验证域名
+        verify_result = self.verify_domain(
+            domain=certificate_domain,
+            max_retries=max_retries,
+            retry_interval=retry_interval
+        )
+        
+        return {
+            "create_result": create_result,
+            "verify_result": verify_result,
+            "success": verify_result.get("success", False)
+        }

fastssl-0.1.0/fastssl.egg-info/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: fastssl
+Version: 0.1.0
+Summary: FastSSL - SSL证书管理SDK，支持申请、验证和获取SSL证书
+Author: FastSSL Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/fastssl
+Project-URL: Documentation, https://github.com/yourusername/fastssl
+Project-URL: Repository, https://github.com/yourusername/fastssl
+Keywords: ssl,certificate,ssl-certificate,zerossl,letsencrypt
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Security
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+
+# FastSSL
+
+FastSSL 是一个用于管理SSL证书的Python SDK，支持申请、验证和获取SSL证书。
+
+签发密钥获取渠道：ssl.aa1.cn/user/
+## 安装
+
+```bash
+pip install fastssl
+```
+
+## 快速开始
+
+```python
+from fastssl import FastSSLClient
+
+# 初始化客户端
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请SSL证书
+result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl",  # 可选: zerossl, letsencrypt, google
+    validation_method="DNS"
+)
+
+# 验证域名
+verify_result = client.verify_domain(domain="example.com")
+
+# 获取证书信息
+cert_info = client.get_certificate_info(domain="example.com")
+
+# 一键申请并验证（便捷方法）
+full_result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+```
+
+## API 文档
+
+### FastSSLClient
+
+#### `__init__(api_key: str)`
+
+初始化FastSSL客户端。
+
+**参数:**
+- `api_key`: API密钥
+
+#### `create_certificate(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS")`
+
+申请SSL证书。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌，可选值: `zerossl`, `letsencrypt`, `google`
+- `validation_method`: 验证方式，默认为 `DNS`
+
+**返回:** 包含证书申请结果的字典
+
+#### `verify_domain(domain: str, max_retries: int = 10, retry_interval: int = 5)`
+
+验证域名并等待证书签发完成。如果验证成功但download_url为空，会自动重试。
+
+**参数:**
+- `domain`: 要验证的域名
+- `max_retries`: 最大重试次数（当download_url为空时）
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含验证结果的字典
+
+#### `get_certificate_info(domain: str)`
+
+获取证书信息，自动处理证书内容中的换行符。
+
+**参数:**
+- `domain`: 域名
+
+**返回:** 包含证书信息的字典
+
+#### `create_and_verify(certificate_domain: str, channel_type: str = "zerossl", validation_method: str = "DNS", max_retries: int = 10, retry_interval: int = 5)`
+
+一键申请并验证证书的便捷方法。
+
+**参数:**
+- `certificate_domain`: 需要验证的域名
+- `channel_type`: 证书品牌
+- `validation_method`: 验证方式
+- `max_retries`: 验证最大重试次数
+- `retry_interval`: 重试间隔（秒）
+
+**返回:** 包含完整流程结果的字典
+
+## 示例
+
+### 基本使用
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+# 申请证书
+create_result = client.create_certificate(
+    certificate_domain="example.com",
+    channel_type="zerossl"
+)
+
+if create_result.get("success"):
+    print("证书申请成功！")
+    print(f"验证信息: {create_result.get('data', {}).get('verify_info')}")
+    
+    # 验证域名
+    verify_result = client.verify_domain("example.com")
+    
+    if verify_result.get("success"):
+        print("证书验证成功！")
+        print(f"下载地址: {verify_result.get('data', {}).get('download_url')}")
+        
+        # 获取证书信息
+        cert_info = client.get_certificate_info("example.com")
+        if cert_info.get("success"):
+            print("证书内容:")
+            print(cert_info.get("data", {}).get("crt_pem"))
+```
+
+### 一键申请并验证
+
+```python
+from fastssl import FastSSLClient
+
+client = FastSSLClient(api_key="your_api_key")
+
+result = client.create_and_verify(
+    certificate_domain="example.com",
+    channel_type="zerossl",
+    max_retries=15,  # 最多重试15次
+    retry_interval=10  # 每次间隔10秒
+)
+
+if result.get("success"):
+    verify_data = result.get("verify_result", {}).get("data", {})
+    print(f"证书编号: {verify_data.get('certificate_no')}")
+    print(f"下载地址: {verify_data.get('download_url')}")
+```
+
+## 许可证
+
+MIT License
+
+## 支持
+
+如有问题或建议，请提交Issue。

fastssl-0.1.0/fastssl.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+fastssl/__init__.py
+fastssl/client.py
+fastssl.egg-info/PKG-INFO
+fastssl.egg-info/SOURCES.txt
+fastssl.egg-info/dependency_links.txt
+fastssl.egg-info/requires.txt
+fastssl.egg-info/top_level.txt

fastssl-0.1.0/fastssl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fastssl-0.1.0/fastssl.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.31.0

fastssl-0.1.0/fastssl.egg-info/top_level.txt

@@ -0,0 +1 @@
+fastssl

fastssl-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fastssl"
+version = "0.1.0"
+description = "FastSSL - SSL证书管理SDK，支持申请、验证和获取SSL证书"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+authors = [
+    {name = "FastSSL Team"}
+]
+keywords = ["ssl", "certificate", "ssl-certificate", "zerossl", "letsencrypt"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Security",
+]
+
+dependencies = [
+    "requests>=2.31.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/fastssl"
+Documentation = "https://github.com/yourusername/fastssl"
+Repository = "https://github.com/yourusername/fastssl"
+
+[tool.setuptools]
+packages = ["fastssl"]
+
+[tool.setuptools.package-data]
+fastssl = ["py.typed"]

fastssl-0.1.0/setup.cfg

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