fly-common 0.1.0__tar.gz

fly_common-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fly_common-0.1.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: fly-common
+Version: 0.1.0
+Summary: 通用模块
+Author-email: fly <fzkf117@163.com>
+License: MIT
+Keywords: utils,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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 :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: annotated-types==0.7.0
+Requires-Dist: cffi==2.0.0
+Requires-Dist: cryptography==46.0.5
+Requires-Dist: ecdsa==0.19.1
+Requires-Dist: passlib==1.7.4
+Requires-Dist: pyasn1==0.6.3
+Requires-Dist: pycparser==2.23
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: pydantic-core==2.41.5
+Requires-Dist: python-jose==3.5.0
+Requires-Dist: rsa==4.9.1
+Requires-Dist: six==1.17.0
+Requires-Dist: typing-extensions==4.15.0
+Requires-Dist: typing-inspection==0.4.2
+Dynamic: license-file
+
+# fly-common
+
+> 一个轻量级的 Python 公共工具库，专注于安全认证和常用工具函数
+
+## 📖 介绍
+
+fly-common 是一个功能精简但实用的 Python 公共库，主要提供以下核心功能：
+
+- **JWT Token 管理**：支持对称加密（HS256）和非对称加密（RS256）的 JWT Token 生成、验证和刷新
+- **密码加密**：提供 MD5、PBKDF2 等多种加密方式
+- **工具函数**：提供单例模式、随机字符串生成等实用工具
+
+## ✨ 功能特性
+
+### 安全模块 (safety)
+
+#### JWT Token
+- 支持对称加密（HS256）和非对称加密（RS256）
+- 提供 Access Token 和 Refresh Token 的生成
+- Token 验证与刷新机制
+- 支持自定义过期时间、签发者（issuer）和受众（audience）
+- 单例模式实现，确保全局唯一实例
+
+#### 密码加密
+- MD5 加密
+- PBKDF2 加密（推荐用于密码存储）
+- 密码验证功能
+- 随机字符串生成
+- 数字验证码生成
+
+### 工具模块 (tools)
+
+- 线程安全的单例模式装饰器
+
+## 📦 安装
+
+### 环境要求
+
+- Python >= 3.9
+
+### 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+## 🚀 使用说明
+
+### JWT Token 使用示例
+
+#### 对称加密（HS256）
+
+```python
+from fly_common.safety.jwt_token import JWTSymmetry
+
+# 初始化（单例模式）
+jwt_sym = JWTSymmetry(
+    secret_key="your-secret-key",
+    access_token_expire_seconds=86400,  # 24小时
+    refresh_token_expire_seconds=604800,  # 7天
+    issuer="your-app",
+    audience="your-users"
+)
+
+# 生成 Token
+result = jwt_sym.create_at_rf_token(payload={"sub": "user123"})
+if result.ok:
+    access_token = result.data["access_token"]
+    refresh_token = result.data["refresh_token"]
+
+# 验证 Token
+verify_result = jwt_sym.verify_token(access_token)
+if verify_result.ok:
+    print("Token 有效:", verify_result.data)
+
+# 刷新 Token
+refresh_result = jwt_sym.refresh_token(access_token, refresh_token)
+if refresh_result.ok:
+    new_tokens = refresh_result.data
+```
+
+#### 非对称加密（RS256）
+
+```python
+from fly_common.safety.jwt_token import JWTAsymmetry
+
+# 初始化（单例模式）
+jwt_asym = JWTAsymmetry(
+    private_key="your-private-key",
+    public_key="your-public-key",
+    algorithm="RS256"
+)
+
+# 使用方式与对称加密相同
+result = jwt_asym.create_at_rf_token(payload={"sub": "user123"})
+```
+
+### 密码加密使用示例
+
+```python
+from fly_common.safety.md5 import md5, en_password, check_password, code_number
+
+# MD5 加密
+hashed = md5("your-string")
+
+# 密码加密（PBKDF2）
+password_hash = en_password("user-password")
+
+# 验证密码
+is_valid = check_password("user-password", password_hash)
+
+# 生成验证码
+code = code_number(6)  # 生成6位数字验证码
+```
+
+### 单例模式使用示例
+
+```python
+from fly_common.tools.single import Singleton
+
+@Singleton
+class MyService:
+    def __init__(self):
+        self.data = []
+
+# 获取实例
+service1 = MyService()
+service2 = MyService()
+
+# service1 和 service2 是同一个实例
+assert service1 is service2
+```
+
+## 📁 项目结构
+
+```
+fly-common/
+├── safety/           # 安全模块
+│   ├── jwt_token.py  # JWT Token 管理
+│   └── md5.py        # 密码加密工具
+├── tools/            # 工具模块
+│   └── single.py     # 单例模式
+└── __init__.py
+```
+
+## 🤝 参与贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 新建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 提交 Pull Request
+
+## 📄 许可证
+
+本项目采用 MIT 许可证

fly_common-0.1.0/README.md

@@ -0,0 +1,158 @@
+# fly-common
+
+> 一个轻量级的 Python 公共工具库，专注于安全认证和常用工具函数
+
+## 📖 介绍
+
+fly-common 是一个功能精简但实用的 Python 公共库，主要提供以下核心功能：
+
+- **JWT Token 管理**：支持对称加密（HS256）和非对称加密（RS256）的 JWT Token 生成、验证和刷新
+- **密码加密**：提供 MD5、PBKDF2 等多种加密方式
+- **工具函数**：提供单例模式、随机字符串生成等实用工具
+
+## ✨ 功能特性
+
+### 安全模块 (safety)
+
+#### JWT Token
+- 支持对称加密（HS256）和非对称加密（RS256）
+- 提供 Access Token 和 Refresh Token 的生成
+- Token 验证与刷新机制
+- 支持自定义过期时间、签发者（issuer）和受众（audience）
+- 单例模式实现，确保全局唯一实例
+
+#### 密码加密
+- MD5 加密
+- PBKDF2 加密（推荐用于密码存储）
+- 密码验证功能
+- 随机字符串生成
+- 数字验证码生成
+
+### 工具模块 (tools)
+
+- 线程安全的单例模式装饰器
+
+## 📦 安装
+
+### 环境要求
+
+- Python >= 3.9
+
+### 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+## 🚀 使用说明
+
+### JWT Token 使用示例
+
+#### 对称加密（HS256）
+
+```python
+from fly_common.safety.jwt_token import JWTSymmetry
+
+# 初始化（单例模式）
+jwt_sym = JWTSymmetry(
+    secret_key="your-secret-key",
+    access_token_expire_seconds=86400,  # 24小时
+    refresh_token_expire_seconds=604800,  # 7天
+    issuer="your-app",
+    audience="your-users"
+)
+
+# 生成 Token
+result = jwt_sym.create_at_rf_token(payload={"sub": "user123"})
+if result.ok:
+    access_token = result.data["access_token"]
+    refresh_token = result.data["refresh_token"]
+
+# 验证 Token
+verify_result = jwt_sym.verify_token(access_token)
+if verify_result.ok:
+    print("Token 有效:", verify_result.data)
+
+# 刷新 Token
+refresh_result = jwt_sym.refresh_token(access_token, refresh_token)
+if refresh_result.ok:
+    new_tokens = refresh_result.data
+```
+
+#### 非对称加密（RS256）
+
+```python
+from fly_common.safety.jwt_token import JWTAsymmetry
+
+# 初始化（单例模式）
+jwt_asym = JWTAsymmetry(
+    private_key="your-private-key",
+    public_key="your-public-key",
+    algorithm="RS256"
+)
+
+# 使用方式与对称加密相同
+result = jwt_asym.create_at_rf_token(payload={"sub": "user123"})
+```
+
+### 密码加密使用示例
+
+```python
+from fly_common.safety.md5 import md5, en_password, check_password, code_number
+
+# MD5 加密
+hashed = md5("your-string")
+
+# 密码加密（PBKDF2）
+password_hash = en_password("user-password")
+
+# 验证密码
+is_valid = check_password("user-password", password_hash)
+
+# 生成验证码
+code = code_number(6)  # 生成6位数字验证码
+```
+
+### 单例模式使用示例
+
+```python
+from fly_common.tools.single import Singleton
+
+@Singleton
+class MyService:
+    def __init__(self):
+        self.data = []
+
+# 获取实例
+service1 = MyService()
+service2 = MyService()
+
+# service1 和 service2 是同一个实例
+assert service1 is service2
+```
+
+## 📁 项目结构
+
+```
+fly-common/
+├── safety/           # 安全模块
+│   ├── jwt_token.py  # JWT Token 管理
+│   └── md5.py        # 密码加密工具
+├── tools/            # 工具模块
+│   └── single.py     # 单例模式
+└── __init__.py
+```
+
+## 🤝 参与贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 新建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 提交 Pull Request
+
+## 📄 许可证
+
+本项目采用 MIT 许可证

fly_common-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fly-common"  # 项目名称
+version = "0.1.0"   # 项目版本号
+description = "通用模块"   # 项目备注
+readme = "README.md"
+requires-python = ">=3.9"   # 最低python版本支持
+authors = [
+    { name = "fly", email = "fzkf117@163.com" }
+]
+license = { text = "MIT" }
+
+dependencies = [
+    "annotated-types==0.7.0",
+    "cffi==2.0.0",
+    "cryptography==46.0.5",
+    "ecdsa==0.19.1",
+    "passlib==1.7.4",
+    "pyasn1==0.6.3",
+    "pycparser==2.23",
+    "pydantic==2.12.5",
+    "pydantic-core==2.41.5",
+    "python-jose==3.5.0",
+    "rsa==4.9.1",
+    "six==1.17.0",
+    "typing-extensions==4.15.0",
+    "typing-inspection==0.4.2",
+]
+
+keywords = ["utils", "tools"]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["fly_common*"] # 需要打包的项目

fly_common-0.1.0/setup.cfg

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

fly_common-0.1.0/src/fly_common/safety/jwt_token.py

@@ -0,0 +1,290 @@
+import uuid
+from datetime import datetime, timedelta, UTC
+from typing import Union, Dict, Any, List
+from pydantic import BaseModel
+from jose import jwt, JWTError, ExpiredSignatureError
+from ..tools.single import Singleton
+
+
+class Response(BaseModel):
+    ok: bool
+    msg: str = ""
+    data: Union[Dict[str, Any], List[Dict[str, Any]], None] = None
+
+
+class BaseJWT:
+    """
+    JWT 基类（模板类）
+    子类只需要实现：
+    - _encode
+    - _decode
+    """
+
+    def __init__(
+            self,
+            access_token_expire_seconds: int = 86400,
+            refresh_token_expire_seconds: int = 604800,
+            issuer: str = None,
+            audience: str = None
+    ):
+        self.access_token_expire_seconds = access_token_expire_seconds
+        self.refresh_token_expire_seconds = refresh_token_expire_seconds
+        self.issuer = issuer
+        self.audience = audience
+
+    # =========================
+    # 子类必须实现
+    # =========================
+    def _encode(self, payload: dict) -> str:
+        raise NotImplementedError
+
+    def _decode(self, token: str, verify_exp: bool = True) -> dict:
+        raise NotImplementedError
+
+    # ==========================================================
+    # 创建 Access + Refresh Token
+    # ==========================================================
+    def create_at_rf_token(self, payload: dict) -> Response:
+        """
+        payload 建议：
+        {
+            "sub": user_id   # 标准字段（用户唯一标识）
+        }
+        """
+
+        now = datetime.now(UTC)
+        jti = uuid.uuid4().hex  # token 唯一ID
+
+        base_payload = {
+            **payload,
+            "jti": jti,
+        }
+
+        # 可选字段（只有配置才加）
+        if self.issuer:
+            base_payload["iss"] = self.issuer
+
+        if self.audience:
+            base_payload["aud"] = self.audience
+
+        # Access Token
+        access_payload = {
+            **base_payload,
+            "token_type": "access",
+            "iat": now,
+            "exp": now + timedelta(seconds=self.access_token_expire_seconds),
+        }
+
+        # Refresh Token
+        refresh_payload = {
+            **base_payload,
+            "token_type": "refresh",
+            "iat": now,
+            "exp": now + timedelta(seconds=self.refresh_token_expire_seconds),
+        }
+
+        return Response(
+            ok=True,
+            msg="生成成功",
+            data={
+                "access_token": self._encode(access_payload),
+                "refresh_token": self._encode(refresh_payload),
+            })
+
+    # ==========================================================
+    # 验证 Token（严格校验）
+    # ==========================================================
+    def verify_token(self, token: str) -> Response:
+        try:
+            payload = self._decode(token, verify_exp=True)
+            return Response(ok=True, msg="验证成功", data=payload)
+
+        except ExpiredSignatureError:
+            return Response(ok=False, msg="Token 过期")
+
+        except JWTError:
+            return Response(ok=False, msg="Token 非法")
+
+        except Exception as e:
+            return Response(ok=False, msg=str(e))
+
+    # ==========================================================
+    # 解析 Token（允许过期）
+    # ==========================================================
+    def parse_token(self, token: str) -> Response:
+        """
+        用于 refresh 场景
+        """
+        try:
+            payload = self._decode(token, verify_exp=False)
+            return Response(ok=True, msg="解析成功", data=payload)
+
+        except JWTError:
+            return Response(ok=False, msg="Token 非法")
+
+        except Exception as e:
+            return Response(ok=False, msg=str(e))
+
+    # ==========================================================
+    # 刷新 Token（仅基础逻辑）
+    # ==========================================================
+    def refresh_token(self, access_token: str, refresh_token: str) -> Response:
+        """
+        ⚠️ 注意：
+        ✔ 不做黑名单
+        ✔ 不做真正“轮换控制”
+        ✔ 只负责生成新 token
+        """
+
+        # 1. 校验 refresh_token
+        rf_res = self.verify_token(refresh_token)
+        if not rf_res.ok:
+            return rf_res
+
+        rf_payload = rf_res.data
+
+        if rf_payload.get("token_type") != "refresh":
+            return Response(ok=False, msg="RefreshToken 非法")
+
+        # 2. 解析 access_token（允许过期）
+        at_res = self.parse_token(access_token)
+        if not at_res.ok:
+            return at_res
+
+        at_payload = at_res.data
+
+        # 3. 校验 jti 一致
+        if at_payload.get("jti") != rf_payload.get("jti"):
+            return Response(ok=False, msg="Token 不一致")
+
+        # 4. 提取业务 payload（去掉系统字段）
+        base_payload = {
+            k: v for k, v in at_payload.items()
+            if k not in ["exp", "iat", "token_type"]
+        }
+
+        # 5. 生成新 token（⚠️这里只是“重新签发”，不是完整轮换策略）
+        return Response(ok=True, msg="刷新成功", data=self.create_at_rf_token(base_payload).data)
+
+
+@Singleton
+class JWTSymmetry(BaseJWT):
+    """
+    对称 JWT（HS256）
+
+    ✔ 支持 issuer / audience 可选（None 不校验）
+    ✔ 标准 JWT 字段（sub / jti / token_type）
+    ✔ 只负责 token 处理（不包含黑名单、轮换策略）
+    """
+
+    def __init__(self, secret_key: str, algorithm="HS256", **kwargs):
+        super().__init__(**kwargs)
+        self.secret_key = secret_key
+        self.algorithm = algorithm
+
+    # ==========================================================
+    # 内部：编码
+    # ==========================================================
+    def _encode(self, payload: dict) -> str:
+        return jwt.encode(payload, self.secret_key, algorithm=self.algorithm)
+
+    # ==========================================================
+    # 内部：解码（关键：动态校验 issuer / audience）
+    # ==========================================================
+    def _decode(self, token: str, verify_exp: bool = True) -> dict:
+        """
+        支持 issuer / audience 为 None 时自动关闭校验
+        """
+
+        options = {
+            "verify_exp": verify_exp,
+            "verify_aud": self.audience is not None,
+            "verify_iss": self.issuer is not None,
+        }
+
+        decode_kwargs = {
+            "key": self.secret_key,
+            "algorithms": [self.algorithm],
+            "options": options,
+        }
+
+        # 只有配置了才传（否则会报错）
+        if self.audience is not None:
+            decode_kwargs["audience"] = self.audience
+
+        if self.issuer is not None:
+            decode_kwargs["issuer"] = self.issuer
+
+        return jwt.decode(token, **decode_kwargs)
+
+    def create_at_rf_token(self, payload: dict) -> Response:
+        return super().create_at_rf_token(payload)
+
+    def verify_token(self, token: str) -> Response:
+        # 直接调用父类实现
+        return super().verify_token(token)
+
+    def parse_token(self, token: str) -> Response:
+        return super().parse_token(token)
+
+    def refresh_token(self, access_token: str, refresh_token: str) -> Response:
+        return super().refresh_token(access_token, refresh_token)
+
+
+@Singleton
+class JWTAsymmetry(BaseJWT):
+
+    def __init__(self, private_key: str, public_key: str, algorithm="RS256", **kwargs):
+        super().__init__(**kwargs)
+        self.private_key = private_key
+        self.public_key = public_key
+        self.algorithm = algorithm
+
+    # ==========================================================
+    # 内部：编码（用私钥签名）
+    # ==========================================================
+    def _encode(self, payload: dict) -> str:
+        return jwt.encode(payload, self.private_key, algorithm=self.algorithm)
+
+    # ==========================================================
+    # 内部：解码（用公钥验证 + 动态校验 iss / aud）
+    # ==========================================================
+    def _decode(self, token: str, verify_exp: bool = True) -> dict:
+        """
+        ✔ 使用公钥验证签名
+        ✔ 支持 issuer / audience 为 None 时不校验
+        """
+
+        options = {
+            "verify_exp": verify_exp,
+            "verify_aud": self.audience is not None,
+            "verify_iss": self.issuer is not None,
+        }
+
+        decode_kwargs = {
+            "key": self.public_key,
+            "algorithms": [self.algorithm],
+            "options": options,
+        }
+
+        # 只有配置了才传，否则会报错
+        if self.audience is not None:
+            decode_kwargs["audience"] = self.audience
+
+        if self.issuer is not None:
+            decode_kwargs["issuer"] = self.issuer
+
+        return jwt.decode(token, **decode_kwargs)
+
+    def create_at_rf_token(self, payload: dict) -> Response:
+        return super().create_at_rf_token(payload)
+
+    def verify_token(self, token: str) -> Response:
+        # 直接调用父类实现
+        return super().verify_token(token)
+
+    def parse_token(self, token: str) -> Response:
+        return super().parse_token(token)
+
+    def refresh_token(self, access_token: str, refresh_token: str) -> Response:
+        return super().refresh_token(access_token, refresh_token)

fly_common-0.1.0/src/fly_common/safety/md5.py

@@ -0,0 +1,40 @@
+import hashlib
+import random
+import uuid
+from passlib.handlers.pbkdf2 import pbkdf2_sha256
+
+
+def md5(s: str) -> str:
+    """返回字符串的 MD5 值"""
+    return hashlib.md5(s.encode('utf-8')).hexdigest()
+
+
+def random_str() -> str:
+    """返回唯一随机字符串（基于 UUID + MD5）"""
+    return hashlib.md5(uuid.uuid1().bytes).hexdigest()
+
+
+def en_password(psw: str) -> str:
+    """使用 PBKDF2 进行加密"""
+    return pbkdf2_sha256.hash(psw)
+
+
+def check_password(password: str, hashed: str) -> bool:
+    """验证密码"""
+    try:
+        return pbkdf2_sha256.verify(password, hashed)
+    except Exception as e:
+        return False
+
+
+def code_number(length: int) -> str:
+    """生成指定长度的纯数字验证码"""
+    return ''.join(random.choices('0123456789', k=length))
+
+
+
+if __name__ == '__main__':
+    password = "25d55ad283aa400af464c76d713c07ad" # "12345678"
+    other = en_password(md5(password))
+    print(other)
+    print(check_password(md5(password), other))

fly_common-0.1.0/src/fly_common/tools/single.py

@@ -0,0 +1,14 @@
+from threading import Lock
+
+class Singleton:
+    def __init__(self, cls):
+        self._cls = cls
+        self._instance = None
+        self._lock = Lock()
+
+    def __call__(self, *args, **kwargs):
+        if self._instance is None:
+            with self._lock:
+                if self._instance is None:
+                    self._instance = self._cls(*args, **kwargs)
+        return self._instance

fly_common-0.1.0/src/fly_common.egg-info/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: fly-common
+Version: 0.1.0
+Summary: 通用模块
+Author-email: fly <fzkf117@163.com>
+License: MIT
+Keywords: utils,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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 :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: annotated-types==0.7.0
+Requires-Dist: cffi==2.0.0
+Requires-Dist: cryptography==46.0.5
+Requires-Dist: ecdsa==0.19.1
+Requires-Dist: passlib==1.7.4
+Requires-Dist: pyasn1==0.6.3
+Requires-Dist: pycparser==2.23
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: pydantic-core==2.41.5
+Requires-Dist: python-jose==3.5.0
+Requires-Dist: rsa==4.9.1
+Requires-Dist: six==1.17.0
+Requires-Dist: typing-extensions==4.15.0
+Requires-Dist: typing-inspection==0.4.2
+Dynamic: license-file
+
+# fly-common
+
+> 一个轻量级的 Python 公共工具库，专注于安全认证和常用工具函数
+
+## 📖 介绍
+
+fly-common 是一个功能精简但实用的 Python 公共库，主要提供以下核心功能：
+
+- **JWT Token 管理**：支持对称加密（HS256）和非对称加密（RS256）的 JWT Token 生成、验证和刷新
+- **密码加密**：提供 MD5、PBKDF2 等多种加密方式
+- **工具函数**：提供单例模式、随机字符串生成等实用工具
+
+## ✨ 功能特性
+
+### 安全模块 (safety)
+
+#### JWT Token
+- 支持对称加密（HS256）和非对称加密（RS256）
+- 提供 Access Token 和 Refresh Token 的生成
+- Token 验证与刷新机制
+- 支持自定义过期时间、签发者（issuer）和受众（audience）
+- 单例模式实现，确保全局唯一实例
+
+#### 密码加密
+- MD5 加密
+- PBKDF2 加密（推荐用于密码存储）
+- 密码验证功能
+- 随机字符串生成
+- 数字验证码生成
+
+### 工具模块 (tools)
+
+- 线程安全的单例模式装饰器
+
+## 📦 安装
+
+### 环境要求
+
+- Python >= 3.9
+
+### 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+## 🚀 使用说明
+
+### JWT Token 使用示例
+
+#### 对称加密（HS256）
+
+```python
+from fly_common.safety.jwt_token import JWTSymmetry
+
+# 初始化（单例模式）
+jwt_sym = JWTSymmetry(
+    secret_key="your-secret-key",
+    access_token_expire_seconds=86400,  # 24小时
+    refresh_token_expire_seconds=604800,  # 7天
+    issuer="your-app",
+    audience="your-users"
+)
+
+# 生成 Token
+result = jwt_sym.create_at_rf_token(payload={"sub": "user123"})
+if result.ok:
+    access_token = result.data["access_token"]
+    refresh_token = result.data["refresh_token"]
+
+# 验证 Token
+verify_result = jwt_sym.verify_token(access_token)
+if verify_result.ok:
+    print("Token 有效:", verify_result.data)
+
+# 刷新 Token
+refresh_result = jwt_sym.refresh_token(access_token, refresh_token)
+if refresh_result.ok:
+    new_tokens = refresh_result.data
+```
+
+#### 非对称加密（RS256）
+
+```python
+from fly_common.safety.jwt_token import JWTAsymmetry
+
+# 初始化（单例模式）
+jwt_asym = JWTAsymmetry(
+    private_key="your-private-key",
+    public_key="your-public-key",
+    algorithm="RS256"
+)
+
+# 使用方式与对称加密相同
+result = jwt_asym.create_at_rf_token(payload={"sub": "user123"})
+```
+
+### 密码加密使用示例
+
+```python
+from fly_common.safety.md5 import md5, en_password, check_password, code_number
+
+# MD5 加密
+hashed = md5("your-string")
+
+# 密码加密（PBKDF2）
+password_hash = en_password("user-password")
+
+# 验证密码
+is_valid = check_password("user-password", password_hash)
+
+# 生成验证码
+code = code_number(6)  # 生成6位数字验证码
+```
+
+### 单例模式使用示例
+
+```python
+from fly_common.tools.single import Singleton
+
+@Singleton
+class MyService:
+    def __init__(self):
+        self.data = []
+
+# 获取实例
+service1 = MyService()
+service2 = MyService()
+
+# service1 和 service2 是同一个实例
+assert service1 is service2
+```
+
+## 📁 项目结构
+
+```
+fly-common/
+├── safety/           # 安全模块
+│   ├── jwt_token.py  # JWT Token 管理
+│   └── md5.py        # 密码加密工具
+├── tools/            # 工具模块
+│   └── single.py     # 单例模式
+└── __init__.py
+```
+
+## 🤝 参与贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+1. Fork 本仓库
+2. 新建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 提交 Pull Request
+
+## 📄 许可证
+
+本项目采用 MIT 许可证

fly_common-0.1.0/src/fly_common.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/fly_common/__init__.py
+src/fly_common.egg-info/PKG-INFO
+src/fly_common.egg-info/SOURCES.txt
+src/fly_common.egg-info/dependency_links.txt
+src/fly_common.egg-info/requires.txt
+src/fly_common.egg-info/top_level.txt
+src/fly_common/safety/__init__.py
+src/fly_common/safety/jwt_token.py
+src/fly_common/safety/md5.py
+src/fly_common/tools/__init__.py
+src/fly_common/tools/single.py

fly_common-0.1.0/src/fly_common.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fly_common-0.1.0/src/fly_common.egg-info/requires.txt

@@ -0,0 +1,14 @@
+annotated-types==0.7.0
+cffi==2.0.0
+cryptography==46.0.5
+ecdsa==0.19.1
+passlib==1.7.4
+pyasn1==0.6.3
+pycparser==2.23
+pydantic==2.12.5
+pydantic-core==2.41.5
+python-jose==3.5.0
+rsa==4.9.1
+six==1.17.0
+typing-extensions==4.15.0
+typing-inspection==0.4.2

fly_common-0.1.0/src/fly_common.egg-info/top_level.txt

@@ -0,0 +1 @@
+fly_common