raytoolsbox 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,133 @@
1
+ Metadata-Version: 2.4
2
+ Name: raytoolsbox
3
+ Version: 1.0.0
4
+ Summary: Add your description here
5
+ Author: TIMLES@https://github.com/TIMLES
6
+ License: MIT
7
+ Requires-Python: >=3.13
8
+ Description-Content-Type: text/markdown
9
+ Requires-Dist: cryptography>=46.0.4
10
+ Requires-Dist: keyring>=25.7.0
11
+ Requires-Dist: pyyaml>=6.0.3
12
+ Requires-Dist: requests>=2.32.5
13
+
14
+
15
+ # raytoolsbox
16
+
17
+ 一个不断进化的 **个人 Python 工具合集(Toolbox)**。
18
+ 包含常用开发工具、实用脚本、个人算法、桌面应用助手、Web 小工具等。
19
+
20
+ 项目以 **模块化、可扩展、易维护** 为目标,为日常开发与个人项目提供稳定的工具支持。
21
+
22
+ ---
23
+
24
+ ## ✨ 特性(Features)
25
+
26
+ - 📧 **邮件工具**
27
+ 简洁易用的邮件发送函数,可自动读取本地或用户目录的配置文件,自动处理 SSL、中文昵称等问题。
28
+
29
+ - 🔐 **个人加密算法(计划中)**
30
+ 自定义加密/解密模块,适用于本地存储与信息传输。
31
+
32
+ - 🌐 **Web 工具(计划中)**
33
+ 轻量级 FastAPI/Flask 封装,用于快速构建本地服务或 API。
34
+
35
+ - 🖥️ **屏幕工具 & GUI 工具(计划中)**
36
+ 自动 DPI 检测、屏幕尺寸工具、Tkinter/Qt 通用辅助函数。
37
+
38
+ - 🧰 **更多工具持续加入中……**
39
+
40
+ ---
41
+
42
+ ## 📦 安装(Installation)
43
+
44
+ ### 使用 uv(推荐)
45
+ ```
46
+ uv add raytoolsbox
47
+ ```
48
+
49
+ ### 使用 pip
50
+ ```
51
+ pip install raytoolsbox
52
+ ```
53
+
54
+ ---
55
+
56
+ ## 🚀 快速开始(Quick Start)
57
+
58
+
59
+
60
+ ---
61
+
62
+ ## 📂 目录结构(Project Layout)
63
+
64
+ ```
65
+ raytoolsbox/
66
+
67
+ ├── pyproject.toml # 项目信息 + 依赖管理(uv)
68
+ ├── README.md # 项目文档
69
+ ├── src/
70
+ │ └── raytoolsbox/
71
+ │ ├── __init__.py
72
+ │ └── maillToPhone.py
73
+
74
+ └── tests/
75
+ └── test_send_email.py # pytest 单元测试
76
+ ```
77
+
78
+ ---
79
+
80
+ ## 🧪 测试(Testing)
81
+
82
+ 本项目使用 pytest:
83
+
84
+ ```
85
+ uv run pytest
86
+ ```
87
+
88
+ 全部测试应通过:
89
+
90
+ ```
91
+ 2 passed
92
+ ```
93
+
94
+ ---
95
+
96
+ ## 🛠️ 开发路线图(Roadmap)
97
+
98
+ ### 已完成
99
+ - [x] 邮件发送工具封装
100
+ - [x] 可本地覆盖的配置系统
101
+ - [x] pytest 自动化测试(mock 网络发送)
102
+ - [x] 个人加密算法模块(AES + 自定义混淆)
103
+ - [x] 计时工具
104
+
105
+ ### 开发中 / 计划中
106
+ - [ ] Web 工具(FastAPI/Flask 封装)
107
+ - [ ] 屏幕工具(DPI、尺寸测量、窗口工具)
108
+ - [ ] Tkinter / PySide6 GUI 工具类
109
+ - [ ] 文件操作工具(临时文件、下载器)
110
+ - [ ] 日期工具、定时工具、任务提醒系统
111
+ - [ ] 扩展 CLI(命令行使用工具箱)
112
+
113
+ 如果你有想加入的功能欢迎告诉我!
114
+
115
+ ---
116
+
117
+ ## 🤝 贡献(Contributing)
118
+
119
+ 欢迎 Issue 或 PR!
120
+ 可提交:
121
+
122
+ - Bug 报告
123
+ - 新功能建议
124
+ - 工具模块
125
+ - 文档改进
126
+
127
+ ---
128
+
129
+ ## 📄 License
130
+
131
+ 使用 MIT License,自由商用/修改/发布。
132
+
133
+ ---
@@ -0,0 +1,120 @@
1
+
2
+ # raytoolsbox
3
+
4
+ 一个不断进化的 **个人 Python 工具合集(Toolbox)**。
5
+ 包含常用开发工具、实用脚本、个人算法、桌面应用助手、Web 小工具等。
6
+
7
+ 项目以 **模块化、可扩展、易维护** 为目标,为日常开发与个人项目提供稳定的工具支持。
8
+
9
+ ---
10
+
11
+ ## ✨ 特性(Features)
12
+
13
+ - 📧 **邮件工具**
14
+ 简洁易用的邮件发送函数,可自动读取本地或用户目录的配置文件,自动处理 SSL、中文昵称等问题。
15
+
16
+ - 🔐 **个人加密算法(计划中)**
17
+ 自定义加密/解密模块,适用于本地存储与信息传输。
18
+
19
+ - 🌐 **Web 工具(计划中)**
20
+ 轻量级 FastAPI/Flask 封装,用于快速构建本地服务或 API。
21
+
22
+ - 🖥️ **屏幕工具 & GUI 工具(计划中)**
23
+ 自动 DPI 检测、屏幕尺寸工具、Tkinter/Qt 通用辅助函数。
24
+
25
+ - 🧰 **更多工具持续加入中……**
26
+
27
+ ---
28
+
29
+ ## 📦 安装(Installation)
30
+
31
+ ### 使用 uv(推荐)
32
+ ```
33
+ uv add raytoolsbox
34
+ ```
35
+
36
+ ### 使用 pip
37
+ ```
38
+ pip install raytoolsbox
39
+ ```
40
+
41
+ ---
42
+
43
+ ## 🚀 快速开始(Quick Start)
44
+
45
+
46
+
47
+ ---
48
+
49
+ ## 📂 目录结构(Project Layout)
50
+
51
+ ```
52
+ raytoolsbox/
53
+
54
+ ├── pyproject.toml # 项目信息 + 依赖管理(uv)
55
+ ├── README.md # 项目文档
56
+ ├── src/
57
+ │ └── raytoolsbox/
58
+ │ ├── __init__.py
59
+ │ └── maillToPhone.py
60
+
61
+ └── tests/
62
+ └── test_send_email.py # pytest 单元测试
63
+ ```
64
+
65
+ ---
66
+
67
+ ## 🧪 测试(Testing)
68
+
69
+ 本项目使用 pytest:
70
+
71
+ ```
72
+ uv run pytest
73
+ ```
74
+
75
+ 全部测试应通过:
76
+
77
+ ```
78
+ 2 passed
79
+ ```
80
+
81
+ ---
82
+
83
+ ## 🛠️ 开发路线图(Roadmap)
84
+
85
+ ### 已完成
86
+ - [x] 邮件发送工具封装
87
+ - [x] 可本地覆盖的配置系统
88
+ - [x] pytest 自动化测试(mock 网络发送)
89
+ - [x] 个人加密算法模块(AES + 自定义混淆)
90
+ - [x] 计时工具
91
+
92
+ ### 开发中 / 计划中
93
+ - [ ] Web 工具(FastAPI/Flask 封装)
94
+ - [ ] 屏幕工具(DPI、尺寸测量、窗口工具)
95
+ - [ ] Tkinter / PySide6 GUI 工具类
96
+ - [ ] 文件操作工具(临时文件、下载器)
97
+ - [ ] 日期工具、定时工具、任务提醒系统
98
+ - [ ] 扩展 CLI(命令行使用工具箱)
99
+
100
+ 如果你有想加入的功能欢迎告诉我!
101
+
102
+ ---
103
+
104
+ ## 🤝 贡献(Contributing)
105
+
106
+ 欢迎 Issue 或 PR!
107
+ 可提交:
108
+
109
+ - Bug 报告
110
+ - 新功能建议
111
+ - 工具模块
112
+ - 文档改进
113
+
114
+ ---
115
+
116
+ ## 📄 License
117
+
118
+ 使用 MIT License,自由商用/修改/发布。
119
+
120
+ ---
@@ -0,0 +1,60 @@
1
+ [project]
2
+ name = "raytoolsbox"
3
+ version = "1.0.0"
4
+ description = "Add your description here"
5
+ authors = [{ name = "TIMLES@https://github.com/TIMLES" }]
6
+ license = {text = "MIT"}
7
+ readme = "README.md"
8
+ requires-python = ">=3.13"
9
+ dependencies = [
10
+ "cryptography>=46.0.4",
11
+ "keyring>=25.7.0",
12
+ "pyyaml>=6.0.3",
13
+ "requests>=2.32.5",
14
+ ]
15
+
16
+ # 开发依赖(不会随包发布)
17
+ [dependency-groups]
18
+ dev = [
19
+ "fastapi>=0.128.0",
20
+ "flask>=3.1.2",
21
+ "hypothesis>=6.151.4",
22
+ "pyside6>=6.10.1",
23
+ "pytest>=9.0.2",
24
+ "python-semantic-release>=10.5.3",
25
+ "pyyaml>=6.0.3",
26
+ "tkinterdnd2>=0.4.3",
27
+ "ttkbootstrap>=1.20.1",
28
+ "uvicorn>=0.40.0",
29
+ "zhdate>=0.1",
30
+ ]
31
+
32
+ # 告诉构建工具源代码在哪
33
+ [tool.setuptools.packages.find]
34
+ where = ["src"]
35
+
36
+ # 指定构建系统
37
+ [build-system]
38
+ requires = ["setuptools", "wheel"]
39
+ build-backend = "setuptools.build_meta"
40
+
41
+
42
+ # 使用 Git 提交消息定义版本变化(遵循 Conventional Commits)
43
+ [tool.semantic_release]
44
+ commit_parser = "conventional"
45
+ branch = "main"
46
+ tag_format = "v{version}"
47
+ version_toml = ["pyproject.toml:project.version"]
48
+ changelog_file = "CHANGELOG.md"
49
+
50
+ [tool.semantic_release.changelog]
51
+ sections = [
52
+ { type = "feat", section = "✨ 新增" },
53
+ { type = "fix", section = "🐛 修复" },
54
+ { type = "breaking", section = "💥 不兼容变更" },
55
+ { type = "docs", section = "📚 文档" },
56
+ { type = "style", section = "🎨 代码风格" },
57
+ { type = "refactor", section = "♻️ 重构" },
58
+ { type = "test", section = "✅ 测试" },
59
+ { type = "chore", section = "🧹 杂项" }
60
+ ]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
File without changes