oxy-py-sdk 1.0.0__tar.gz

oxy_py_sdk-1.0.0/.editorconfig

@@ -0,0 +1,258 @@
+# https://editorconfig.org
+root = true
+
+# -----------------------------------------------------------------------------
+# Defaults
+# -----------------------------------------------------------------------------
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+max_line_length = 120
+
+# -----------------------------------------------------------------------------
+# Python
+# -----------------------------------------------------------------------------
+[*.py]
+indent_size = 4
+max_line_length = 120
+
+[*.pyi]
+indent_size = 4
+max_line_length = 120
+
+[*.pyw]
+indent_size = 4
+
+# -----------------------------------------------------------------------------
+# Config / data (usually 2-space)
+# -----------------------------------------------------------------------------
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.toml]
+indent_size = 2
+
+[*.json]
+indent_size = 2
+
+[*.jsonc]
+indent_size = 2
+
+[*.json5]
+indent_size = 2
+
+[{.eslintrc,.babelrc,.stylelintrc,.prettierrc,.botorcc,jest.config,*.bowerrc,*.jsb3,*.jsb2}]
+indent_size = 2
+
+[*.{ini,cfg,conf}]
+indent_size = 4
+
+[*.env]
+indent_size = 4
+trim_trailing_whitespace = false
+
+[*.env.*]
+indent_size = 4
+trim_trailing_whitespace = false
+
+# -----------------------------------------------------------------------------
+# Docs / markup
+# -----------------------------------------------------------------------------
+[*.md]
+indent_size = 2
+# Trailing spaces can mean hard line breaks in Markdown.
+trim_trailing_whitespace = false
+max_line_length = off
+
+[*.mdx]
+indent_size = 2
+trim_trailing_whitespace = false
+max_line_length = off
+
+[*.rst]
+indent_size = 3
+trim_trailing_whitespace = false
+
+[*.adoc]
+indent_size = 2
+trim_trailing_whitespace = false
+
+[*.txt]
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.html]
+indent_size = 2
+
+[*.htm]
+indent_size = 2
+
+[*.css]
+indent_size = 2
+
+[*.scss]
+indent_size = 2
+
+[*.sass]
+indent_size = 2
+indent_style = space
+
+[*.less]
+indent_size = 2
+
+[*.svg]
+indent_size = 2
+
+# -----------------------------------------------------------------------------
+# JavaScript / TypeScript / frontend
+# -----------------------------------------------------------------------------
+[*.{js,cjs,mjs,jsx}]
+indent_size = 2
+max_line_length = 120
+
+[*.{ts,cts,mts,tsx}]
+indent_size = 2
+max_line_length = 120
+
+[*.vue]
+indent_size = 2
+max_line_length = 120
+
+[*.svelte]
+indent_size = 2
+max_line_length = 120
+
+[*.js.map]
+indent_size = 2
+
+# -----------------------------------------------------------------------------
+# Shell / Docker / Make / CI
+# -----------------------------------------------------------------------------
+[*.{sh,bash,zsh,ksh}]
+indent_size = 2
+
+[Dockerfile]
+indent_size = 4
+
+[Dockerfile*]
+indent_size = 4
+
+[docker-compose*.{yml,yaml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+indent_size = 4
+
+[GNUmakefile]
+indent_style = tab
+indent_size = 4
+
+[*.mk]
+indent_style = tab
+indent_size = 4
+
+[{.github/workflows/*.yml,.github/workflows/*.yaml}]
+indent_size = 2
+
+# -----------------------------------------------------------------------------
+# Windows scripts (keep CRLF)
+# -----------------------------------------------------------------------------
+[*.{bat,cmd,ps1}]
+end_of_line = crlf
+
+[*.bat]
+indent_style = space
+indent_size = 4
+
+[*.cmd]
+indent_style = space
+indent_size = 4
+
+[*.ps1]
+indent_style = space
+indent_size = 4
+
+# -----------------------------------------------------------------------------
+# SQL / database
+# -----------------------------------------------------------------------------
+[*.{sql,ddl}]
+indent_size = 2
+
+# -----------------------------------------------------------------------------
+# Java / Kotlin / Groovy / XML family
+# -----------------------------------------------------------------------------
+[*.{java,kt,kts,groovy,gradle}]
+indent_size = 4
+continuation_indent_size = 8
+max_line_length = 120
+
+[*.{xml,xsd,xsl,xslt,wsdl,wsdd,wadl,tld,jnlp,fxml,pom,ant,xul,rng,xjb,jrxml,plan,jhm}]
+indent_size = 2
+
+[*.{mod,ent,dtd,elt}]
+indent_size = 2
+
+# -----------------------------------------------------------------------------
+# Go / Rust / C-family (common defaults)
+# -----------------------------------------------------------------------------
+[*.go]
+indent_style = tab
+indent_size = 4
+
+[*.rs]
+indent_size = 4
+max_line_length = 100
+
+[*.{c,h,cpp,hpp,cc,hh,cxx,hxx}]
+indent_size = 4
+
+[*.{m,mm}]
+indent_size = 4
+
+# -----------------------------------------------------------------------------
+# Misc project files
+# -----------------------------------------------------------------------------
+[*.gradle.kts]
+indent_size = 4
+
+[*.properties]
+indent_size = 4
+
+[*.graphql]
+indent_size = 2
+
+[*.proto]
+indent_size = 2
+
+[*.tf]
+indent_size = 2
+
+[*.hcl]
+indent_size = 2
+
+[*.nix]
+indent_size = 2
+
+[*.lock]
+indent_size = 2
+insert_final_newline = true
+
+[*.diff]
+trim_trailing_whitespace = false
+
+[*.patch]
+trim_trailing_whitespace = false
+
+# Binary / generated: avoid editors "fixing" them
+[*.{png,jpg,jpeg,gif,ico,webp,pdf,xlsx,xls,whl,gz,zip,pyc,class,jar,so,dylib,dll,exe}]
+charset = unset
+end_of_line = unset
+insert_final_newline = unset
+trim_trailing_whitespace = unset
+indent_style = unset
+indent_size = unset

oxy_py_sdk-1.0.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

oxy_py_sdk-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,32 @@
+name: Publish package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/oxy-py-sdk/
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          version: '0.12.7'
+          python-version: '3.15'
+      - name: Build
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          test "$RELEASE_TAG" = "v$(uv version --short)"
+          uv build
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always

oxy_py_sdk-1.0.0/.gitignore

@@ -0,0 +1,59 @@
+### Project ###
+logs/
+settings.yaml
+
+### Python ###
+.venv/
+.ruff_cache/
+.pytest_cache/
+__pycache__/
+dist/
+
+### Apache Maven ###
+target/
+!tests/oxy/main/**/target/
+!tests/oxy/test/**/target/
+!.mvn/wrapper/maven-wrapper.jar
+
+### Gradle ###
+.gradle/
+
+### Eclipse ###
+.settings/
+.project
+.classpath
+
+### IntelliJ IDEA ###
+.idea/
+*.iml
+*.ipr
+*.iws
+.idea
+out
+test-output
+atlassian-ide-plugin.xml
+
+### VS Code ###
+.vscode/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!tests/oxy/main/**/build/
+!tests/oxy/test/**/build/
+
+### MacOS ###
+.DS_Store
+
+### Others ###
+*.jar
+*.sw?
+*~
+.#*
+.*.md.html
+.flattened-pom.xml
+*.egg-info/

oxy_py_sdk-1.0.0/.python-version

@@ -0,0 +1 @@
+3.15

oxy_py_sdk-1.0.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 1.0.0 - 2026-11-12
+
+- 首个正式版本，发行包名为 `oxy-py-sdk`，Python 导入包名为 `oxy`。
+- 支持 Python 3.15 及以上版本，提供类型标记 `py.typed`。
+- 提供日志、集合、日期时间、UUID、路径及 MD5/SHA256 等基础工具。
+- 提供 `codec` 可选依赖，支持 DES、RSA 加解密及签名。
+- 提供 `data` 可选依赖，支持 DataFrame 拆分及 Excel 文件缓存，包含 pandas、openpyxl。
+- 提供 `http` 可选依赖，支持异步 HTTP 请求、请求装饰器及响应处理。
+- 提供 `setting` 可选依赖，支持 YAML 配置读写；搭配 `codec` 支持配置文件加解密。
+- 支持组合安装可选依赖，或通过 `oxy-py-sdk[all]` 安装全部功能依赖。
+- 使用 GitHub Release 触发构建，通过 Trusted Publishing 发布到 PyPI。
+- 补充安装示例、发布说明、项目元数据及 MIT 许可证声明。

oxy_py_sdk-1.0.0/LICENSE

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

oxy_py_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.5
+Name: oxy-py-sdk
+Version: 1.0.0
+Summary: Python utilities for HTTP, configuration, cryptography, and data processing
+Project-URL: Homepage, https://github.com/oxy-projects/oxy-py-sdk
+Project-URL: Repository, https://github.com/oxy-projects/oxy-py-sdk
+Project-URL: Issues, https://github.com/oxy-projects/oxy-py-sdk/issues
+Project-URL: Changelog, https://github.com/oxy-projects/oxy-py-sdk/blob/main/CHANGELOG.md
+Author-email: wangjz <wangjz_vip@163.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: configuration,cryptography,http,utilities
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.15
+Provides-Extra: all
+Requires-Dist: colorama>=0.4.6; extra == 'all'
+Requires-Dist: cryptography>=49.0.0; extra == 'all'
+Requires-Dist: httpx[http2]>=0.28.1; extra == 'all'
+Requires-Dist: openpyxl>=3.1.5; extra == 'all'
+Requires-Dist: pandas>=3.0.3; extra == 'all'
+Requires-Dist: pycryptodome>=3.23.0; extra == 'all'
+Requires-Dist: pydantic>=2.13.4; extra == 'all'
+Requires-Dist: pyyaml>=6.0.3; extra == 'all'
+Provides-Extra: codec
+Requires-Dist: cryptography>=49.0.0; extra == 'codec'
+Requires-Dist: pycryptodome>=3.23.0; extra == 'codec'
+Provides-Extra: data
+Requires-Dist: openpyxl>=3.1.5; extra == 'data'
+Requires-Dist: pandas>=3.0.3; extra == 'data'
+Provides-Extra: http
+Requires-Dist: httpx[http2]>=0.28.1; extra == 'http'
+Requires-Dist: pydantic>=2.13.4; extra == 'http'
+Provides-Extra: setting
+Requires-Dist: pyyaml>=6.0.3; extra == 'setting'
+Description-Content-Type: text/markdown
+
+# oxy-py-sdk
+
+Python 通用工具库，提供 HTTP 请求、配置管理、加解密、日志和数据处理工具。
+发行包名为 `oxy-py-sdk`，Python 导入包名为 `oxy`。支持 Python 3.15 及以上版本。
+
+## 按需安装
+
+基础包包含日志、集合、通用语言工具及 MD5/SHA256，无第三方运行时依赖。
+未安装 colorama 时日志使用无颜色输出；安装 `[all]` 会同时安装 colorama，启用彩色日志。
+其他功能按需安装：
+
+```bash
+pip install oxy-py-sdk
+pip install "oxy-py-sdk[codec]"        # DES、RSA、签名等加解密
+pip install "oxy-py-sdk[data]"         # DataFrame、Excel 读写及缓存
+pip install "oxy-py-sdk[http]"         # HTTP 请求
+pip install "oxy-py-sdk[setting]"      # YAML 配置读写
+pip install "oxy-py-sdk[http,setting]" # 自由组合
+pip install "oxy-py-sdk[setting,codec]" # 配置文件加解密
+pip install "oxy-py-sdk[all]"          # 全部功能依赖，含彩色日志
+```
+
+| 分组 | 依赖 | 模块 |
+| --- | --- | --- |
+| codec | pycryptodome、cryptography | `oxy.utils.codec` |
+| data | pandas、openpyxl | `oxy.utils.data`、`oxy.utils.data.cache` |
+| http | httpx（含 HTTP/2）、pydantic | `oxy.utils.http` |
+| setting | pyyaml | `oxy.utils.setting` |
+
+`setting` 的字典读取和转换不需要 YAML 依赖；配置文件加解密需要同时安装 `setting` 和 `codec`。
+MD5/SHA256 使用标准库，无需安装 `codec`。DES 和 MD5 主要用于兼容现有协议。
+
+## 使用示例
+
+基础工具：
+
+```python
+from oxy.utils.lang import gen_uuid_str
+from oxy.utils.lang.collection import distinct
+
+print(gen_uuid_str())
+print(distinct([1, 1, 2]))  # [1, 2]
+```
+
+安装 `oxy-py-sdk[http]` 后：
+
+```python
+import asyncio
+from oxy.utils.http import api
+
+@api.get("https://httpbin.org/get")
+async def fetch():
+    return {"q": "python"}
+
+result = asyncio.run(fetch())
+```
+
+安装 `oxy-py-sdk[setting]` 后：
+
+```python
+from pathlib import Path
+from oxy.utils.setting import dump_yaml, load_yaml
+
+dump_yaml({"project": {"name": "demo"}}, Path("settings.yaml"))
+settings = load_yaml(Path("settings.yaml"))
+```
+
+## 开发与验证
+
+```bash
+uv sync --locked --all-extras
+uv run --locked --all-extras pytest -q
+uv build
+uvx twine check --strict dist/*
+```
+
+测试不需要真实外部服务，HTTP 请求使用模拟传输。
+
+只安装指定功能：
+
+```bash
+uv sync --locked --extra http --extra setting
+```
+
+修改依赖后运行 `uv lock` 并提交 `pyproject.toml` 与 `uv.lock`。
+
+## 发布
+
+完整配置及操作步骤见 [发布说明](RELEASING.md)，版本记录见 [CHANGELOG](CHANGELOG.md)。
+发布 GitHub Release 后自动构建并发布到 PyPI。
+版本来源为 `pyproject.toml`，Release 标签必须是 `v` 加版本号，例如 `v1.0.0`。
+
+## 许可证
+
+[MIT](LICENSE)，Copyright (c) 2026 wangjz。

oxy_py_sdk-1.0.0/README.md

@@ -0,0 +1,95 @@
+# oxy-py-sdk
+
+Python 通用工具库，提供 HTTP 请求、配置管理、加解密、日志和数据处理工具。
+发行包名为 `oxy-py-sdk`，Python 导入包名为 `oxy`。支持 Python 3.15 及以上版本。
+
+## 按需安装
+
+基础包包含日志、集合、通用语言工具及 MD5/SHA256，无第三方运行时依赖。
+未安装 colorama 时日志使用无颜色输出；安装 `[all]` 会同时安装 colorama，启用彩色日志。
+其他功能按需安装：
+
+```bash
+pip install oxy-py-sdk
+pip install "oxy-py-sdk[codec]"        # DES、RSA、签名等加解密
+pip install "oxy-py-sdk[data]"         # DataFrame、Excel 读写及缓存
+pip install "oxy-py-sdk[http]"         # HTTP 请求
+pip install "oxy-py-sdk[setting]"      # YAML 配置读写
+pip install "oxy-py-sdk[http,setting]" # 自由组合
+pip install "oxy-py-sdk[setting,codec]" # 配置文件加解密
+pip install "oxy-py-sdk[all]"          # 全部功能依赖，含彩色日志
+```
+
+| 分组 | 依赖 | 模块 |
+| --- | --- | --- |
+| codec | pycryptodome、cryptography | `oxy.utils.codec` |
+| data | pandas、openpyxl | `oxy.utils.data`、`oxy.utils.data.cache` |
+| http | httpx（含 HTTP/2）、pydantic | `oxy.utils.http` |
+| setting | pyyaml | `oxy.utils.setting` |
+
+`setting` 的字典读取和转换不需要 YAML 依赖；配置文件加解密需要同时安装 `setting` 和 `codec`。
+MD5/SHA256 使用标准库，无需安装 `codec`。DES 和 MD5 主要用于兼容现有协议。
+
+## 使用示例
+
+基础工具：
+
+```python
+from oxy.utils.lang import gen_uuid_str
+from oxy.utils.lang.collection import distinct
+
+print(gen_uuid_str())
+print(distinct([1, 1, 2]))  # [1, 2]
+```
+
+安装 `oxy-py-sdk[http]` 后：
+
+```python
+import asyncio
+from oxy.utils.http import api
+
+@api.get("https://httpbin.org/get")
+async def fetch():
+    return {"q": "python"}
+
+result = asyncio.run(fetch())
+```
+
+安装 `oxy-py-sdk[setting]` 后：
+
+```python
+from pathlib import Path
+from oxy.utils.setting import dump_yaml, load_yaml
+
+dump_yaml({"project": {"name": "demo"}}, Path("settings.yaml"))
+settings = load_yaml(Path("settings.yaml"))
+```
+
+## 开发与验证
+
+```bash
+uv sync --locked --all-extras
+uv run --locked --all-extras pytest -q
+uv build
+uvx twine check --strict dist/*
+```
+
+测试不需要真实外部服务，HTTP 请求使用模拟传输。
+
+只安装指定功能：
+
+```bash
+uv sync --locked --extra http --extra setting
+```
+
+修改依赖后运行 `uv lock` 并提交 `pyproject.toml` 与 `uv.lock`。
+
+## 发布
+
+完整配置及操作步骤见 [发布说明](RELEASING.md)，版本记录见 [CHANGELOG](CHANGELOG.md)。
+发布 GitHub Release 后自动构建并发布到 PyPI。
+版本来源为 `pyproject.toml`，Release 标签必须是 `v` 加版本号，例如 `v1.0.0`。
+
+## 许可证
+
+[MIT](LICENSE)，Copyright (c) 2026 wangjz。

oxy_py_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "oxy-py-sdk"
+version = "1.0.0"
+description = "Python utilities for HTTP, configuration, cryptography, and data processing"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["http", "configuration", "cryptography", "utilities"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.15",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+requires-python = ">=3.15"
+authors = [
+  { name = "wangjz", email = "wangjz_vip@163.com" }
+]
+# 基础工具仅使用标准库；功能依赖按需安装。
+dependencies = []
+
+[project.optional-dependencies]
+codec = [
+  # 密码学：DES 等对称算法用 pycryptodome；RSA/签名用 cryptography。
+  "pycryptodome>=3.23.0",
+  "cryptography>=49.0.0",
+]
+data = [
+  "pandas>=3.0.3",
+  "openpyxl>=3.1.5",
+]
+http = [
+  # HTTP请求库。
+  "httpx[http2]>=0.28.1",
+  # 类型约束，数据校验。
+  "pydantic>=2.13.4",
+]
+setting = [
+  # YAML 解析库。
+  "pyyaml>=6.0.3",
+]
+# 全部
+all = [
+  # 终端颜色输出库。可以让命令行输出带颜色，比如错误显示红色、成功显示绿色。
+  "colorama>=0.4.6",
+  "oxy-py-sdk[codec,data,http,setting]",
+]
+
+[project.urls]
+Homepage = "https://github.com/oxy-projects/oxy-py-sdk"
+Repository = "https://github.com/oxy-projects/oxy-py-sdk"
+Issues = "https://github.com/oxy-projects/oxy-py-sdk/issues"
+Changelog = "https://github.com/oxy-projects/oxy-py-sdk/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+  "pandas-stubs>=3.0.5.260730",
+  "pytest>=8.0",
+  "respx>=0.21",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/oxy"]