raytoolsbox 1.1.0__py3-none-any.whl → 1.1.2__py3-none-any.whl

raytoolsbox/security/__init__.py

@@ -1,5 +1,10 @@
+"""
+RayToolsbox 安全模块
+包含加密管理器、PIN管理器和身份验证器
+"""
+
 from .crypto_manager import CryptoManager
 from .pin_manager import PinManager
 from .authenticator import Authenticator
 
-__all__ = ["CryptoManager", "PinManager", "Authenticator"]
+__all__ = ["CryptoManager", "PinManager", "Authenticator"]

raytoolsbox/security/authenticator.py

@@ -1,7 +1,8 @@
 import time,json,os,stat,keyring,pyotp,qrcode
 class Authenticator:
     """
-    基于 RFC 6238 的 TOTP 验证器。
+    基于 RFC 6238 的 TOTP 验证器
+    
     功能：
     - 生成及验证 TOTP（基于时间的一次性验证码）
     - 使用系统安全存储（keyring）保存密钥，文件存储作为兜底
@@ -9,15 +10,17 @@ class Authenticator:
     - 支持终端展示绑定二维码（ASCII）
     
     说明：
-    TOTP 本质上需要一个“secret 秘钥”来生成验证码。
+    TOTP 本质上需要一个"secret 秘钥"来生成验证码。
     此类负责安全地保存 secret，并提供验证与绑定机制。
     """
 
-    def __init__(self, service_name: str="", account: str = ""):
+    def __init__(self, service_name: str = "", account: str = ""):
         """
-        初始化 Authenticator 对象。
-        - service_name：你的应用名称，如 "testApp"
-        - account：区分不同账户的标识（多个账号时很重要）
+        初始化 Authenticator 对象
+        
+        参数：
+            service_name: 应用名称，如 "testApp"
+            account: 区分不同账户的标识（多个账号时很重要）
         """
         self.service_name = service_name
         self.account = account
@@ -31,34 +34,39 @@ class Authenticator:
         # 临时 secret（仅在 get_secret → verify_and_bind 期间使用）
         self._pending_secret = None
 
-
         try:
             self._load_secret()
             self._if_bind = True
             print("✅ 已存在绑定的 Authenticator。")
-
         except RuntimeError:
             self._if_bind = False
             print("🔐 未绑定，请使用 .get_secret()初始化...")
 
     def exist(self):
+        """
+        检查是否已绑定 Authenticator
+        
+        返回：
+            bool: True 表示已绑定，False 表示未绑定
+        """
         return self._if_bind
+
     # ============================================================
     #                     绑定 / 初始化（不立即保存）
     # ============================================================
     def get_secret(self):
         """
-        生成新的 TOTP secret，但不立即永久保存。
-
+        生成新的 TOTP secret，但不立即永久保存
+        
         功能：
-        - 账户尚未绑定时，调用此方法会生成一个新的临时密钥（secret）。
-          需配合 verify() 输入首次验证码验证成功后永久保存。
-
+        - 账户尚未绑定时，调用此方法会生成一个新的临时密钥（secret）
+        - 需配合 verify() 输入首次验证码验证成功后永久保存
+        
         返回：
-        - dict: 包含以下键值：
-            - "uri"：TOTP 绑定用的 otpauth URI，可用于生成二维码。
-            - "secret"：此次生成的临时密钥。
-          如果当前账户已绑定，则返回错误说明字符串。
+            dict: 包含以下键值：
+                - "uri": TOTP 绑定用的 otpauth URI，可用于生成二维码
+                - "secret": 此次生成的临时密钥
+            如果当前账户已绑定，则返回错误说明字符串
         """
         if not self._if_bind:
             # 随机生成 TOTP 的 Base32 秘钥
@@ -90,21 +98,19 @@ class Authenticator:
 
             return {"uri": uri, "secret": self._pending_secret}
         else:
-            msg="已存在对应账户和应用的Authenticator,请先删除"
+            msg = "已存在对应账户和应用的Authenticator,请先删除"
             print(msg)
             return msg
-        
+
     # ============================================================
     #                     删除现有绑定（解绑）
     # ============================================================
-
     def delete(self) -> bool:
         """
-        删除当前账户的 TOTP 绑定。
-
+        删除当前账户的 TOTP 绑定
+        
         返回：
-        - True：至少有一个存储被删除
-        - False：两个地方都没有数据（或删除失败）
+            bool: True 表示至少有一个存储被删除，False 表示两个地方都没有数据（或删除失败）
         """
         removed = False
         try:
@@ -123,26 +129,23 @@ class Authenticator:
                 pass
         self._if_bind = False
         return removed
-    
+
     # ============================================================
     #                     验证验证码
     # ============================================================
-
     def verify(self, code: str, window: int = 1) -> bool:
         """
-        验证已绑定账户的 TOTP 验证码。
+        验证已绑定账户的 TOTP 验证码
         
         参数：
-        - code: 用户输入的 6 位数字字符串
-        - window: 时间容差（默认 1）
-            window=0：只接受当前30秒（最严格）
-            window=1：接受前/当前/后 共 90 秒（推荐，防手机时间误差）
-
+            code: 用户输入的 6 位数字字符串
+            window: 时间容差（默认 1）
+                window=0：只接受当前30秒（最严格）
+                window=1：接受前/当前/后 共 90 秒（推荐，防手机时间误差）
+        
         返回：
-        - True  验证成功
-        - False 验证失败
+            bool: True 表示验证成功，False 表示验证失败
         """
-        
         if self._if_bind:
             totp = pyotp.TOTP(self._load_secret())          # 根据存储密钥，创建 TOTP 验证器
             return totp.verify(code, valid_window=window)   # 验证输入的验证码
@@ -178,11 +181,15 @@ class Authenticator:
     # ============================================================
     #                     存储层
     # ============================================================
-
     def _save_keyring(self, data: dict) -> bool:
         """
         尝试将 secret 保存到系统安全存储（keyring）
-        写入失败返回 False。
+        
+        参数：
+            data: 包含 secret 等信息的数据字典
+        
+        返回：
+            bool: True 表示保存成功，False 表示保存失败
         """
         try:
             keyring.set_password(self.service_name, self._key, json.dumps(data))
@@ -192,10 +199,16 @@ class Authenticator:
 
     def _load_secret(self) -> str:
         """
-        加载已绑定的 secret。
-        优先从 keyring 获取。
-        如果 keyring 不可用，则回退读取文件。
-        如果都不存在 → 表示尚未绑定。
+        加载已绑定的 secret
+        
+        优先从 keyring 获取，如果 keyring 不可用，则回退读取文件。
+        如果都不存在则表示尚未绑定。
+        
+        返回：
+            str: Base32 编码的 secret
+        
+        异常：
+            RuntimeError: 如果 Authenticator 尚未绑定
         """
         # 尝试从 keyring 获取
         try:
@@ -214,8 +227,13 @@ class Authenticator:
 
     def _save_file(self, data: dict):
         """
-        将 secret 写入文件（兜底方案）。
-        写入后将文件权限设置为 600（仅当前用户可读写）。
+        将 secret 写入文件（兜底方案）
+        
+        参数：
+            data: 包含 secret 等信息的数据字典
+        
+        说明：
+            写入后将文件权限设置为 600（仅当前用户可读写）
         """
         with open(self._file_path, "w") as f:
             json.dump(data, f)

raytoolsbox/security/crypto_manager.py

@@ -11,23 +11,32 @@ from pathlib import Path
 
 class CryptoManager:
     """
-    ✅ 现代化 ECC 加密管理器（无签名版）
-
+    现代化 ECC 加密管理器（无签名版）
+    
+    功能：
     - 使用 X25519 进行密钥交换
     - 使用 ChaCha20-Poly1305 进行对称加密
-    - 原始数据支持 str / bytes / 文件，加密或签名后返回二进制数据包
+    - 支持文本、字节和文件的加密解密
+    - 支持数字签名和验签功能（Ed25519）
     """
+
+    # 常量定义
     _SIGN_LEN = 64  # Ed25519 固定长度
-    # 数据类型信息
-    _TYPE_TEXT = b"\x01"
-    _TYPE_BYTES = b"\x02"
-    # 二进制格式数据包指纹
-    _MAGIC = b"ECC1"
-    _VERSION = b"\x01"
-    _SIGN_MAGIC = b"SIGN"
-    _SIGN_VERSION = b"\x01"
+    _TYPE_TEXT = b"\x01"  # 文本数据标识
+    _TYPE_BYTES = b"\x02"  # 字节数据标识
+    _MAGIC = b"ECC1"  # 二进制格式数据包指纹
+    _VERSION = b"\x01"  # 版本标识
+    _SIGN_MAGIC = b"SIGN"  # 签名数据包标识
+    _SIGN_VERSION = b"\x01"  # 签名版本标识
 
     def __init__(self, key_dir=None, PIN="toolsbox"):
+        """
+        初始化加密管理器
+        
+        参数：
+            key_dir: 密钥目录路径（可选）
+            PIN: 密钥保护密码，默认为"toolsbox"
+        """
         self._PIN = PIN
         self._key_dir = None
 
@@ -36,7 +45,10 @@ class CryptoManager:
 
     def set_key_dir(self, key_dir):
         """
-        切换 / 设置密钥目录
+        切换/设置密钥目录
+        
+        参数：
+            key_dir: 密钥目录路径
         """
         self._key_dir = Path(key_dir)
         self._key_dir.mkdir(parents=True, exist_ok=True)
@@ -50,8 +62,16 @@ class CryptoManager:
     #      密钥生成 / 保存 / 加载
     # -----------------------------------------
     def generate_keys(self):
-
-        """ X25519与Ed25519公私钥对生成 """
+        """
+        生成 X25519 与 Ed25519 公私钥对
+        
+        返回：
+            tuple: (crypt_key, crypt_pub, sign_key, sign_pub)
+                - crypt_key: X25519 私钥
+                - crypt_pub: X25519 公钥
+                - sign_key: Ed25519 私钥
+                - sign_pub: Ed25519 公钥
+        """
         crypt_key = x25519.X25519PrivateKey.generate()
         crypt_pub = crypt_key.public_key()
         # Ed25519公私钥对生成 
@@ -63,8 +83,15 @@ class CryptoManager:
 
     # -----------------------------------------
     def _save_keypair(self, crypt_key, crypt_pub, sign_key, sign_pub):
-        """保存密钥对为 PEM 文件"""
-
+        """
+        保存密钥对为 PEM 文件
+        
+        参数：
+            crypt_key: X25519 私钥
+            crypt_pub: X25519 公钥
+            sign_key: Ed25519 私钥
+            sign_pub: Ed25519 公钥
+        """
         pin = self._PIN
         enc = (
             serialization.BestAvailableEncryption(pin.encode())
@@ -95,7 +122,12 @@ class CryptoManager:
 
     # -----------------------------------------
     def _load_keypair(self):
-        """加载私钥和公钥"""
+        """
+        加载私钥和公钥
+        
+        返回：
+            tuple: (crypt_key, crypt_pub, sign_key, sign_pub) 或 (None, None, None, None)
+        """
         if not all(p.exists() for p in (
                 self._crypt_key_path,
                 self._crypt_pub_path,
@@ -125,16 +157,21 @@ class CryptoManager:
     #  text → 加密 → dict
     # ============================================
 
-    def encrypt(self, data=None, pubkey=None,data_path=None,save="off") -> bytes:
+    def encrypt(self, data=None, pubkey=None, data_path=None, save="off") -> bytes:
         """
+        使用 X25519 公钥加密数据
+        
         参数：
-            data: str | bytes | data_path
-            pubkey: 公钥（X25519）
-            data_path: 数据文件路径（可选）
-            save: 为空时不保存。否则保存到data_path同名.enc文件或者指定文件路径
-
+            data: 要加密的数据（str 或 bytes）
+            pubkey: X25519 公钥对象
+            data_path: 数据文件路径（可选，如果提供则从文件读取数据）
+            save: 保存选项
+                - "off": 不保存（默认）
+                - "on": 保存到 data_path 同名.enc 文件
+                - 其他字符串：保存到指定路径
+        
         返回：
-            bytes: 二进制数据包
+            bytes: 加密后的二进制数据包
         """
 
         if pubkey is None and self._key_dir is not None:
@@ -218,13 +255,19 @@ class CryptoManager:
     #  解密流程：ECC → AEAD → text
     def decrypt(self, packet: bytes = None, privkey=None, enc_data_path=None, save="off"):
         """
+        使用 X25519 私钥解密数据
+        
         参数：
-            packet (bytes): get_encrypt() 返回的数据
-            privkey: 私钥（X25519）
-            enc_data_path: .enc 文件路径（可选）
-            save: 保存文件名（不含后缀）；若 enc_data_path 存在则自动去掉 .enc
+            packet: 加密后的数据包（bytes）
+            privkey: X25519 私钥对象
+            enc_data_path: 加密文件路径（可选，如果提供则从文件读取数据包）
+            save: 保存选项
+                - "off": 不保存（默认）
+                - "on": 保存到 enc_data_path 同名文件（去掉.enc后缀）
+                - 其他字符串：保存到指定路径
+        
         返回：
-            str | bytes
+            str | bytes: 解密后的原始数据
         """
         if privkey is None and self._key_dir is not None:
             privkey, _, _, _ = self._load_keypair()
@@ -326,20 +369,19 @@ class CryptoManager:
     # ============================================
     def sign(self, data=None, sign_key=None, data_path=None, save="off"):
         """
-        使用 Ed25519 对数据进行数字签名，并生成自描述的签名数据包。
-
+        使用 Ed25519 对数据进行数字签名
+        
         参数：
-            data (str | bytes | None): 待签名的数据内容。
-
-            sign_key (ed25519.Ed25519PrivateKey | None): 可选密钥
-
-            data_path (str | Path | None): 可选待签名文件的路径（覆盖data）
-
-            save (str): 控制是否将签名数据包保存为文件。"off"（默认）
-
+            data: 要签名的数据（str 或 bytes）
+            sign_key: Ed25519 私钥对象
+            data_path: 数据文件路径（可选，如果提供则从文件读取数据）
+            save: 保存选项
+                - "off": 不保存（默认）
+                - "on": 保存到 data_path 同名.signed 文件
+                - 其他字符串：保存到指定路径
+        
         返回：
-            bytes: 签名数据包（二进制格式），结构如下：
-
+            bytes: 签名数据包（二进制格式）
         """
         if sign_key is None and self._key_dir is not None:
             _, _, sign_key, _ = self._load_keypair()
@@ -404,18 +446,18 @@ class CryptoManager:
     def verify(self, signed_data=None, verify_key=None, signed_data_path=None, save="off"):
         """
         验证 Ed25519 签名
-
-        参数:
-            signed_data:
-                - bytes            : 签名数据包
-                - str (base64)     : 签名数据包
-            signed_data_path:
-                - None             : 从签名包验签
-                - 文件路径(str)    : 对指定文件验签
-
+        
+        参数：
+            signed_data: 签名数据包（bytes 或 base64 编码的 str）
+            verify_key: Ed25519 公钥对象
+            signed_data_path: 签名文件路径（可选，如果提供则从文件读取签名数据包）
+            save: 保存选项
+                - "off": 不保存（默认）
+                - "on": 保存到 signed_data_path 同名.verify 文件
+                - 其他字符串：保存到指定路径
+        
         返回：
-            - str          : 验签成功并还原文本数据
-            - None         : 验签失败
+            str | None: 验签成功返回原始数据，失败返回 None
         """
         if verify_key is None and self._key_dir is not None:
             _, _, _, verify_key = self._load_keypair()

raytoolsbox/security/pin_manager.py

@@ -3,19 +3,37 @@ import json
 
 class PinManager:
     """
-    只负责 PIN 的生成、验证、修改。
-    使用操作系统安全存储 (keyring) 保存哈希，提高安全性。
+    PIN 管理器
+    
+    功能：
+    - 生成和验证 PIN 码
+    - 使用操作系统安全存储 (keyring) 保存哈希
+    - 支持修改 PIN 码
     """
 
     def __init__(self, service_name):
-        # service_name 用来区分你的程序名称
+        """
+        初始化 PIN 管理器
+        
+        参数：
+            service_name: 服务名称，用于区分不同的应用程序
+        """
         self.service_name = service_name
 
     # ============================================================
     #                     PIN 生成 / 保存
     # ============================================================
     def set_pin(self, pin: str, iterations: int = 200_000):
-        """生成新的 PIN 哈希并保存到系统安全存储"""
+        """
+        生成新的 PIN 哈希并保存到系统安全存储
+        
+        参数：
+            pin: 要设置的 PIN 码
+            iterations: PBKDF2 迭代次数，默认 200,000
+        
+        返回：
+            dict: 包含 salt、hash 和 iterations 的数据字典
+        """
         salt = os.urandom(16)
         hash_bytes = hashlib.pbkdf2_hmac(
             "sha256", pin.encode("utf-8"), salt, iterations
@@ -34,8 +52,16 @@ class PinManager:
     # ============================================================
     #                     PIN 验证
     # ============================================================
-    def verify_pin(self, pin: str)-> str:
-        """从系统安全存储读取哈希验证输入的 PIN"""
+    def verify_pin(self, pin: str) -> str:
+        """
+        从系统安全存储读取哈希验证输入的 PIN
+        
+        参数：
+            pin: 要验证的 PIN 码
+        
+        返回：
+            str: "OK" 表示验证成功，"FAIL" 表示验证失败，"not_set" 表示未设置 PIN
+        """
         stored_json = keyring.get_password(self.service_name, "pin_data")
         if not stored_json:
             print("没有检测到保存的 PIN，已经使用默认 PIN。")
@@ -56,7 +82,16 @@ class PinManager:
     #                     修改 PIN
     # ============================================================
     def change_pin(self, old_pin: str, new_pin: str):
-        """验证旧 PIN 并更新新的 PIN"""
+        """
+        验证旧 PIN 并更新新的 PIN
+        
+        参数：
+            old_pin: 旧的 PIN 码
+            new_pin: 新的 PIN 码
+        
+        返回：
+            dict: 新 PIN 的数据字典，如果旧 PIN 验证失败则返回 None
+        """
         if self.verify_pin(old_pin) == "OK":
             return self.set_pin(new_pin)
 

raytoolsbox/utils/__init__.py

@@ -1,2 +1,9 @@
-# from .useful_func import get_resource_path, center_window, make_timer, list_github_repos
-# __all__ = ["get_resource_path", "center_window", "make_timer", "list_github_repos"]
+"""
+RayToolsbox 工具模块
+包含常用的辅助函数
+"""
+
+from .useful_func import get_resource_path, center_window, make_timer, list_github_repos
+from .mailToPhone import send_email
+
+__all__ = ["get_resource_path", "center_window", "make_timer", "list_github_repos", "send_email"]

raytoolsbox/utils/mailToPhone.py

@@ -32,17 +32,23 @@ def _load_email_config(provider: str)-> bool:
 
 
 def send_email(
-        subject: str='HelloWorld', 
-        content: str='这是一个测试邮件', 
-        to_addr: str='',
-        serverName: str='',
-        use_smtp:str='qq') -> None:
+        subject: str = 'HelloWorld',
+        content: str = '这是一个测试邮件',
+        to_addr: str = '',
+        serverName: str = '',
+        use_smtp: str = 'qq') -> bool:
     """
-    :param subject: 邮件主题 
-    :param content: 邮件内容
-    :param to_addr: 接收邮箱地址
-    :param serverName: 服务器名称
-    :param use_smtp: 使用的SMTP服务提供商
+    发送一封电子邮件（支持 HTML 内容）
+    
+    参数：
+        subject: 邮件主题，默认 'HelloWorld'
+        content: 邮件正文内容（HTML 格式），默认 '这是一个测试邮件'
+        to_addr: 收件人邮箱地址，若为空则默认发送给发件人自己
+        serverName: 发件人昵称（显示在邮件"发件人"处）
+        use_smtp: SMTP 服务类型标识，用于加载对应配置，例如：'qq'、'gmail' 等
+    
+    返回：
+        bool: True 表示邮件发送成功，False 表示邮件发送失败（配置加载失败或发送异常）
     """
     try:
         config = _load_email_config(use_smtp)

raytoolsbox/utils/useful_func.py

@@ -1,14 +1,12 @@
 """
-===============================================
-📦 raytoolsbox.utils.common_tools
-常用辅助函数模块
------------------------------------------------
+RayToolsbox 工具模块
+包含常用的辅助函数
+
 功能包含：
 - 获取资源路径（兼容 PyInstaller）
 - Tk 窗口居中显示
 - 简易性能计时器 make_timer()
 - 获取指定 GitHub 用户的仓库列表
-===============================================
 """
 
 import os,sys,time,requests
@@ -18,16 +16,15 @@ from pathlib import Path
 # ============================================================
 def make_timer():
     """
-    创建一个简单的性能计时函数。
-
+    创建一个简单的性能计时函数
+    
     功能：
-    - 返回一个内部函数，可多次调用自动计算时间间隔。
-    - 输出调用次数与耗时（毫秒）。
-
+    - 返回一个内部函数，可多次调用自动计算时间间隔
+    - 输出调用次数与耗时（毫秒）
+    
     返回：
-    - callable: 内部计时函数 tt(msg)。
-      调用格式：
-        tt("说明文字") → 打印上次调用到当前的耗时。
+        callable: 内部计时函数 tt(msg)
+        调用格式：tt("说明文字") → 打印上次调用到当前的耗时
     """
     last_time = None
     count = -1
@@ -52,43 +49,51 @@ def make_timer():
 
     return tt
 
-
 # ============================================================
 #                  路径工具函数
 # ============================================================
 def get_resource_path(relpath: str) -> str:
     """
-    修正资源路径（兼容 PyInstaller 打包运行环境）。
-
-    功能：
-    - 判断程序是否由 PyInstaller 打包。
-    - 自动切换资源访问路径：打包环境使用 sys._MEIPASS。
-
+    获取应用资源的绝对路径（仅应用资源）
+    
+    规则：
+    - PyInstaller 打包环境：使用 sys._MEIPASS
+    - 普通运行环境：以应用入口脚本（__main__.__file__）所在目录为基准
+    
     参数：
-    - relpath (str): 相对路径字符串。
-
+        relpath: 相对路径
+        
     返回：
-    - str: 绝对资源路径。
+        str: 绝对路径
     """
+    # PyInstaller 打包环境
     if hasattr(sys, "_MEIPASS"):
         return os.path.join(sys._MEIPASS, relpath)
-    return os.path.join(os.path.dirname(__file__), relpath)
 
+    # 普通 Python 运行环境：应用入口脚本
+    try:
+        import __main__
+        base_path = os.path.dirname(os.path.abspath(__main__.__file__))
+    except Exception:
+        # 兜底：交互式 / 特殊环境（REPL、某些 IDE）
+        base_path = os.getcwd()
+
+    return os.path.join(base_path, relpath)
 
 # ============================================================
 #                  Tk 窗口居中
 # ============================================================
 def center_window(win, width: int | None = None, height: int | None = None):
     """
-    将 Tkinter 窗口居中显示。
-
+    将 Tkinter 窗口居中显示
+    
     参数：
-    - win: Tkinter 窗口或 Toplevel 对象。
-    - width: 目标宽度（可选，默认当前窗口宽度）。
-    - height: 目标高度（可选，默认当前窗口高度）。
-
+        win: Tkinter 窗口或 Toplevel 对象
+        width: 目标宽度（可选，默认当前窗口宽度）
+        height: 目标高度（可选，默认当前窗口高度）
+    
     返回：
-    - None（直接更新窗口位置）
+        None（直接更新窗口位置）
     """
     win.update_idletasks()
     w = width or win.winfo_width()
@@ -99,33 +104,31 @@ def center_window(win, width: int | None = None, height: int | None = None):
     y = (sh - h) // 3
     win.geometry(f"{w}x{h}+{x}+{y}")
 
-
-
 # ============================================================
 #                  GitHub API 工具
 # ============================================================
 def list_github_repos(username: str, token: str | None = None, print_result: bool = True):
     """
-    获取指定 GitHub 用户的仓库列表。
-
+    获取指定 GitHub 用户的仓库列表
+    
     功能：
-    - 支持传入个人访问 Token（可访问私有仓库）。
-    - 支持分页抓取所有仓库（最大 100 每页）。
-
+    - 支持传入个人访问 Token（可访问私有仓库）
+    - 支持分页抓取所有仓库（最大 100 每页）
+    
     参数：
-    - username: GitHub 用户名。
-    - token: 个人访问令牌（str 或 None）。
-      如果 token 不为空且用户名为自己，则访问 /user/repos。
-    - print_result: 是否打印获取结果（默认 True）。
-
+        username: GitHub 用户名
+        token: 个人访问令牌（str 或 None）
+            如果 token 不为空且用户名为自己，则访问 /user/repos
+        print_result: 是否打印获取结果（默认 True）
+    
     返回：
-    - list[dict]: 仓库列表，每个元素结构：
-        {
-            "name": 仓库名称,
-            "size_mb": 仓库大小（MB),
-            "private": 是否私有仓库 (bool)
-        }
-      如果 Token 无效返回 None。
+        list[dict]: 仓库列表，每个元素结构：
+            {
+                "name": 仓库名称,
+                "size_mb": 仓库大小（MB),
+                "private": 是否私有仓库 (bool)
+            }
+        如果 Token 无效返回 None
     """
     # 选择 API URL
     if token and username:

{raytoolsbox-1.1.0.dist-info → raytoolsbox-1.1.2.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: raytoolsbox
-Version: 1.1.0
+Version: 1.1.2
 Summary: Add your description here
 Author: TIMLES@https://github.com/TIMLES
 License: MIT
-Requires-Python: >=3.13
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: cryptography>=46.0.4
 Requires-Dist: keyring>=25.7.0

raytoolsbox-1.1.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+raytoolsbox/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+raytoolsbox/security/__init__.py,sha256=awenOLOReXurtyQCIJCzZirwE5Q_4pEfQkvrioNSGJQ,278
+raytoolsbox/security/authenticator.py,sha256=tZp2q72taAjrojigFt6uc5C01U5_zYX2MCCjrCjUiZY,9569
+raytoolsbox/security/crypto_manager.py,sha256=7mKS_mhehlk0WUMYYI6M6ci1GE2TnADzsFtT5W2DWi0,20260
+raytoolsbox/security/pin_manager.py,sha256=UwcsiE-ZfFNIZ0NEGdHEyvz8ozIQtVek7uUFkWv_sHA,3750
+raytoolsbox/utils/__init__.py,sha256=AYk4BqqGVL1ZaGJX2dJJuKTdtfFL4LQMGmoT3v91BSg,295
+raytoolsbox/utils/mailToPhone.py,sha256=C_mN3qJiJM7epbYdp6nY5k6lk3p_ksLJA8o7rcWB3kY,3022
+raytoolsbox/utils/useful_func.py,sha256=__RLYc9d2xx47oG-6IvzTc7LWz_k1O3NMDy1lWJa_wE,6124
+raytoolsbox-1.1.2.dist-info/METADATA,sha256=rhw-ymgZL2f3ih45eeL7HRgtdk6Wo7szral_o6UY_p0,2956
+raytoolsbox-1.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+raytoolsbox-1.1.2.dist-info/top_level.txt,sha256=W3bjrGqlV1zMr5MySZQhI4ZT8K-rs2zXQdSNdLI6JDE,12
+raytoolsbox-1.1.2.dist-info/RECORD,,

raytoolsbox/to_github.py

@@ -1,73 +0,0 @@
-import requests
-# token: str | None = None,  意思是 token 可以是字符串类型，也可以是 None 类型 。默认值是 None 。
-def list_github_repos(username: str, token: str | None = None, print_result: bool = True):
-    """
-    获取 GitHub 仓库列表。
-    
-    :param username: GitHub 用户名（可以是自己，也可以是别人）
-    :param token: 不传则访问别人公开仓库；传入则可访问自己的公开+私有
-    :param print_result: 是否打印
-    :return: 仓库列表 [{name, size_mb, private}, ...]
-    """
-    # 选择 API URL
-    if token and username:  
-        # token 一般只能访问“当前登录用户”
-        # 所以如果 username == token中的用户 → /user/repos
-        api_url = "https://api.github.com/user/repos"
-        use_auth = True
-    else:
-        # 无 token → 访问公开仓库
-        api_url = f"https://api.github.com/users/{username}/repos"
-        use_auth = False
-
-    headers = {"Accept": "application/vnd.github+json"}
-    if token:
-        headers["Authorization"] = f"token {token}"
-
-    repos = []
-    page = 1
-
-    while True:
-        resp = requests.get(api_url, headers=headers, params={"page": page, "per_page": 100})
-
-                # ========== 处理错误 Token ==========
-        if resp.status_code == 401:
-            print("❌ GitHub Token 无效（Bad credentials）, 请检查：")
-            print("   1. Token 是否拼写正确")
-            print("   2. Token 是否未过期")
-            print("   3. 如果访问别人公开仓库 → 不要传 token")
-            return None  # 或者 raise ValueError("无效 Token")
-
-        # ========== 其它错误 ==========
-        if resp.status_code != 200:
-            raise RuntimeError(
-                f"GitHub API 请求失败：{resp.status_code}\n{resp.text}"
-            )
-
-        batch = resp.json()
-        if not batch:
-            break
-
-        for r in batch:
-            repos.append({
-                "name": r["name"],
-                "size_mb": r["size"] / 1024,
-                "private": r["private"],
-            })
-
-        page += 1
-
-        # 如果是 /user/repos，但 username 不是 token 的用户 → 会只返回公开仓库（合理情况）
-    
-    # 打印结果
-    if print_result:
-        for r in repos:
-            print(f"{r['name']:25} {r['size_mb']:7.2f} MB  {'private' if r['private'] else 'public'}")
-
-    return repos
-
-if __name__ == "__main__":
-
-    user = "2dust"
-    data = list_github_repos(user)
-    # print(data)

raytoolsbox-1.1.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-raytoolsbox/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-raytoolsbox/to_github.py,sha256=gvOg_ltE2dXQQ2hhpoa0A4Eth-h36NYl0qLRlizxnRM,2602
-raytoolsbox/security/__init__.py,sha256=2S4Eld0loDwKle0gW83byxu6KH8Zk9SfpwH9TiAsecs,182
-raytoolsbox/security/authenticator.py,sha256=POk11M4MR5nhs9ungVyGsIC1laP225IUF3sCQv14Tss,8944
-raytoolsbox/security/crypto_manager.py,sha256=6LMlfd9PrtvFMaW3x3hQ3ddGZU4v4myLvNbCJK7pqOE,18585
-raytoolsbox/security/pin_manager.py,sha256=B0Iuu8oY9a_9Cr5QhE9jr9h92f0VnMe8mciXPfQb5kU,2905
-raytoolsbox/utils/__init__.py,sha256=sncYTfqEkIk_cUDRyrle0rTOt_h7LOaJQJI38rmlaQ4,177
-raytoolsbox/utils/mailToPhone.py,sha256=JhVRMhPlzrQ-B3-Sf2YVNsfa3N1LZSlOSoYJnd4rbNo,2600
-raytoolsbox/utils/useful_func.py,sha256=-KzFo5_nXTzeh-KbCBGCzva8EeerK0nuyTAP-yflW4E,5958
-raytoolsbox-1.1.0.dist-info/METADATA,sha256=vg2AHFtN9GXDKHR0_hecTo9fqtKZvn696Og3Q6BRnZ4,2956
-raytoolsbox-1.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-raytoolsbox-1.1.0.dist-info/top_level.txt,sha256=W3bjrGqlV1zMr5MySZQhI4ZT8K-rs2zXQdSNdLI6JDE,12
-raytoolsbox-1.1.0.dist-info/RECORD,,