ArgonCodeKits 0.3.0__tar.gz

argoncodekits-0.3.0/ArgonCodeKits/__init__.py

@@ -0,0 +1,3 @@
+from .hash import *  # noqa: F403
+from .os import * # noqa: F403
+from .pyplus import * # noqa: F403

argoncodekits-0.3.0/ArgonCodeKits/hash.py

@@ -0,0 +1,46 @@
+import hashlib
+
+def md5(s: str) -> str:
+    """计算字符串的 MD5 哈希值
+
+    Args:
+        s (str): 输入字符串
+
+    Returns:
+        str: 字符串的 MD5 哈希值（32 位十六进制字符串）
+    """
+    
+    return hashlib.md5(s.encode()).hexdigest()
+
+def sha1(s: str) -> str:
+    """计算字符串的 SHA-1 哈希值
+
+    Args:
+        s (str): 输入字符串
+
+    Returns:
+        str: 字符串的 SHA-1 哈希值（40 位十六进制字符串）
+    """
+    return hashlib.sha1(s.encode()).hexdigest()
+
+def sha256(s: str) -> str:
+    """计算字符串的 SHA-256 哈希值
+
+    Args:
+        s (str): 输入字符串
+
+    Returns:
+        str: 字符串的 SHA-256 哈希值（64 位十六进制字符串）
+    """
+    return hashlib.sha256(s.encode()).hexdigest()
+
+def sha512(s: str) -> str:
+    """计算字符串的 SHA-512 哈希值
+
+    Args:
+        s (str): 输入字符串
+
+    Returns:
+        str: 字符串的 SHA-512 哈希值（128 位十六进制字符串）
+    """
+    return hashlib.sha512(s.encode()).hexdigest()

argoncodekits-0.3.0/ArgonCodeKits/os.py

@@ -0,0 +1,45 @@
+import os
+
+
+def get_folder_size(folder: str) -> int:
+    """获取文件夹大小
+
+    Args:
+        folder (str): 要计算大小的文件夹路径
+
+    Returns:
+        int: 文件夹的总大小（字节）
+    """
+    total = 0
+    for entry in os.scandir(folder):
+        if entry.is_file():
+            total += entry.stat().st_size
+        elif entry.is_dir():
+            total += get_folder_size(entry.path)  # 递归子文件夹（如果需要）
+    return total
+
+
+def filter_windows_invalid_chars(s: str, o: str = "[x]") -> str:
+    r"""将字符串中的 Windows 非法字符（\ / : * ? " < > |）全部替换为 指定内容
+
+    Args:
+        s (str): 输入字符串
+        o (str, optional): 替换内容，默认为 "[x]"
+    Returns:
+        str: 替换后的字符串
+    """
+    invalid_chars = set(r'\/:*?"<>|')
+    return "".join(o if c in invalid_chars else c for c in s)
+
+def check_working_directory() -> str:
+    """切换目录到脚本位置
+
+    Returns:
+        str: 脚本所在目录的路径
+    """
+    script_dir = os.path.normcase(os.getcwd())
+    current_dir = os.path.normcase(os.path.dirname(os.path.abspath(__file__)))
+    
+    if script_dir != current_dir:
+        os.chdir(current_dir)
+    return current_dir

argoncodekits-0.3.0/ArgonCodeKits/pyplus.py

@@ -0,0 +1,87 @@
+import logging
+import random
+import base64
+
+space = " " * 100
+
+def input(prompt: str, level: str = "info") -> str:
+    """显示提示信息并记录日志，然后获取用户输入并记录。
+
+    Args:
+        prompt (str): 提示信息
+        level (str): 日志等级，可选值：debug, info, warning, error, critical
+
+    Returns:
+        str: 用户输入的文本
+    """
+    level_map = {
+        "debug": logging.DEBUG,
+        "info": logging.INFO,
+        "warning": logging.WARNING,
+        "error": logging.ERROR,
+        "critical": logging.CRITICAL,
+    }
+
+    log_level = level_map.get(level.lower(), logging.INFO)
+
+    # 记录提示信息（纯文本，不含控制字符）
+    logging.log(log_level, f"提示信息：{prompt}")
+
+    # 获取用户输入
+    user_input = __builtins__.input(prompt)
+
+    # 记录用户输入
+    logging.log(log_level, f"用户输入：{user_input}")
+
+    return user_input
+
+
+def encrypt(text: str, password: str, rounds: int = 10) -> bytes:
+    """混淆：文本 -> 多次base64 + 打乱
+    
+    Args:
+        text (str): 需要加密的文本
+        password (str): 用于生成随机种子的密码
+        rounds (int): 加密轮数
+
+    Returns:
+        str: 加密后的数据
+    """
+    data = text.encode('utf-8')
+    for i in range(rounds):
+        # 每轮使用独立的随机生成器，种子 = 密码 + 轮次
+        r = random.Random(password + str(i))
+        # base64编码
+        data = base64.b64encode(data)
+        # 转列表打乱
+        chars = list(data)
+        r.shuffle(chars)
+        data = bytes(chars)
+    return data
+
+
+def decrypt(ciphertext: bytes, password: str, rounds: int = 10) -> str:
+    """反混淆：恢复打乱顺序 + base64解码
+    Args:
+        ciphertext (bytes): 加密后的数据
+        password (str): 用于生成随机种子的密码
+        rounds (int): 加密轮数
+        
+    Returns:
+        str: 解密后的文本
+    """
+    data = ciphertext
+    for i in range(rounds - 1, -1, -1):  # 从最后一轮逆向操作
+        # 使用与加密时相同的独立随机生成器
+        r = random.Random(password + str(i))
+        # 获取这轮的乱序索引（和加密时完全一样）
+        indices = list(range(len(data)))
+        r.shuffle(indices)
+        # 恢复原始顺序
+        chars = [None] * len(data)
+        for new_pos, old_pos in enumerate(indices):
+            chars[old_pos] = data[new_pos]
+        data = bytes(chars)
+        # base64解码
+        data = base64.b64decode(data)
+    return data.decode('utf-8')

argoncodekits-0.3.0/ArgonCodeKits.egg-info/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: ArgonCodeKits
+Version: 0.3.0
+Summary: Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。
+Author-email: Argon <smmomm@126.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mifongjvav/ArgonCodeKits
+Project-URL: Repository, https://github.com/mifongjvav/ArgonCodeKits
+Project-URL: BugTracker, https://github.com/mifongjvav/ArgonCodeKits/issues
+Keywords: utils,hash,md5,sha256,filesystem,encryption
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Argon Code Kits
+
+Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。
+
+## 功能模块
+
+### hash - 哈希计算
+
+- `md5(s)` - 计算字符串的 MD5 哈希值
+- `sha1(s)` - 计算字符串的 SHA-1 哈希值
+- `sha256(s)` - 计算字符串的 SHA-256 哈希值
+- `sha512(s)` - 计算字符串的 SHA-512 哈希值
+
+### os - 操作系统工具
+
+- `get_folder_size(folder)` - 获取文件夹大小
+- `filter_windows_invalid_chars(s, o="[x]")` - 过滤 Windows 文件名非法字符
+- `check_working_directory()` - 切换目录到脚本位置
+
+### pyplus - Python 增强功能
+
+- `input(prompt, level="info")` - 带日志记录的输入函数
+- `encrypt(text, password, rounds=10)` - 文本加密（基于 base64 和混淆）
+- `decrypt(ciphertext, password, rounds=10)` - 解密
+
+## 安装
+
+```bash
+pip install ArgonCodeKits

argoncodekits-0.3.0/ArgonCodeKits.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+ArgonCodeKits/__init__.py
+ArgonCodeKits/hash.py
+ArgonCodeKits/os.py
+ArgonCodeKits/pyplus.py
+ArgonCodeKits.egg-info/PKG-INFO
+ArgonCodeKits.egg-info/SOURCES.txt
+ArgonCodeKits.egg-info/dependency_links.txt
+ArgonCodeKits.egg-info/top_level.txt

argoncodekits-0.3.0/ArgonCodeKits.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

argoncodekits-0.3.0/ArgonCodeKits.egg-info/top_level.txt

@@ -0,0 +1 @@
+ArgonCodeKits

argoncodekits-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Argon
+
+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.

argoncodekits-0.3.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: ArgonCodeKits
+Version: 0.3.0
+Summary: Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。
+Author-email: Argon <smmomm@126.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mifongjvav/ArgonCodeKits
+Project-URL: Repository, https://github.com/mifongjvav/ArgonCodeKits
+Project-URL: BugTracker, https://github.com/mifongjvav/ArgonCodeKits/issues
+Keywords: utils,hash,md5,sha256,filesystem,encryption
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+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: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Argon Code Kits
+
+Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。
+
+## 功能模块
+
+### hash - 哈希计算
+
+- `md5(s)` - 计算字符串的 MD5 哈希值
+- `sha1(s)` - 计算字符串的 SHA-1 哈希值
+- `sha256(s)` - 计算字符串的 SHA-256 哈希值
+- `sha512(s)` - 计算字符串的 SHA-512 哈希值
+
+### os - 操作系统工具
+
+- `get_folder_size(folder)` - 获取文件夹大小
+- `filter_windows_invalid_chars(s, o="[x]")` - 过滤 Windows 文件名非法字符
+- `check_working_directory()` - 切换目录到脚本位置
+
+### pyplus - Python 增强功能
+
+- `input(prompt, level="info")` - 带日志记录的输入函数
+- `encrypt(text, password, rounds=10)` - 文本加密（基于 base64 和混淆）
+- `decrypt(ciphertext, password, rounds=10)` - 解密
+
+## 安装
+
+```bash
+pip install ArgonCodeKits

argoncodekits-0.3.0/README.md

@@ -0,0 +1,29 @@
+# Argon Code Kits
+
+Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。
+
+## 功能模块
+
+### hash - 哈希计算
+
+- `md5(s)` - 计算字符串的 MD5 哈希值
+- `sha1(s)` - 计算字符串的 SHA-1 哈希值
+- `sha256(s)` - 计算字符串的 SHA-256 哈希值
+- `sha512(s)` - 计算字符串的 SHA-512 哈希值
+
+### os - 操作系统工具
+
+- `get_folder_size(folder)` - 获取文件夹大小
+- `filter_windows_invalid_chars(s, o="[x]")` - 过滤 Windows 文件名非法字符
+- `check_working_directory()` - 切换目录到脚本位置
+
+### pyplus - Python 增强功能
+
+- `input(prompt, level="info")` - 带日志记录的输入函数
+- `encrypt(text, password, rounds=10)` - 文本加密（基于 base64 和混淆）
+- `decrypt(ciphertext, password, rounds=10)` - 解密
+
+## 安装
+
+```bash
+pip install ArgonCodeKits

argoncodekits-0.3.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ArgonCodeKits"
+version = "0.3.0"
+description = "Argon的代码库，包含一些实用的工具函数，旨在提高开发效率和代码精简度。"
+readme = "README.md"
+authors = [
+    {name = "Argon", email = "smmomm@126.com"}
+]
+license = "MIT"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "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",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+    "Topic :: Utilities",
+    "Topic :: Security :: Cryptography",
+]
+keywords = ["utils", "hash", "md5", "sha256", "filesystem", "encryption"]
+requires-python = ">=3.6"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/mifongjvav/ArgonCodeKits"
+Repository = "https://github.com/mifongjvav/ArgonCodeKits"
+BugTracker = "https://github.com/mifongjvav/ArgonCodeKits/issues"
+
+[tool.setuptools]
+packages = ["ArgonCodeKits"]  # 直接指定包名

argoncodekits-0.3.0/setup.cfg

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