zerodep 0.2.0__tar.gz

zerodep-0.2.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: zerodep
+Version: 0.2.0
+Summary: Zero-dependency, single-file Python implementations of popular libraries
+Author: Peng Ding
+License-Expression: MIT
+Project-URL: Repository, https://github.com/Oaklight/zerodep
+Project-URL: Issues, https://github.com/Oaklight/zerodep/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"
+Provides-Extra: bench-aes
+Requires-Dist: pycryptodome>=3.20.0; extra == "bench-aes"
+Provides-Extra: bench-qr
+Requires-Dist: qrcode>=7.0; extra == "bench-qr"
+Requires-Dist: Pillow>=10.0.0; extra == "bench-qr"
+Provides-Extra: bench-http
+Requires-Dist: httpx>=0.27.0; extra == "bench-http"
+Provides-Extra: bench-dotenv
+Requires-Dist: python-dotenv>=1.0.0; extra == "bench-dotenv"
+Provides-Extra: bench-yaml
+Requires-Dist: PyYAML>=6.0; extra == "bench-yaml"
+Provides-Extra: bench-jsonc
+Requires-Dist: commentjson>=0.9.0; extra == "bench-jsonc"
+Provides-Extra: bench-structlog
+Requires-Dist: structlog>=24.0.0; extra == "bench-structlog"
+Provides-Extra: bench-retry
+Requires-Dist: tenacity>=8.0.0; extra == "bench-retry"
+Provides-Extra: bench-toon
+Requires-Dist: toon-format>=0.1.0; extra == "bench-toon"
+Provides-Extra: bench-tabulate
+Requires-Dist: tabulate>=0.9.0; extra == "bench-tabulate"
+Provides-Extra: bench-soup
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "bench-soup"
+Provides-Extra: bench-validate
+Requires-Dist: pydantic>=2.0.0; extra == "bench-validate"
+Provides-Extra: bench-sse
+Requires-Dist: httpx-sse>=0.4.0; extra == "bench-sse"
+Requires-Dist: httpx>=0.27.0; extra == "bench-sse"
+Provides-Extra: bench-markdown
+Requires-Dist: mistune>=3.0.0; extra == "bench-markdown"
+Provides-Extra: bench-diff
+Requires-Dist: unidiff>=0.7.0; extra == "bench-diff"
+Provides-Extra: bench-scheduler
+Requires-Dist: APScheduler>=3.10.0; extra == "bench-scheduler"
+Requires-Dist: schedule>=1.2.0; extra == "bench-scheduler"
+Requires-Dist: croniter>=1.3.0; extra == "bench-scheduler"
+Provides-Extra: bench-search
+Requires-Dist: rank-bm25>=0.2.2; extra == "bench-search"
+Provides-Extra: bench-frontmatter
+Requires-Dist: python-frontmatter>=1.1.0; extra == "bench-frontmatter"
+Provides-Extra: bench-config
+Requires-Dist: python-decouple>=3.8; extra == "bench-config"
+Provides-Extra: bench-cache
+Requires-Dist: cachetools>=5.0.0; extra == "bench-cache"
+Provides-Extra: bench-xml
+Requires-Dist: xmltodict>=0.13.0; extra == "bench-xml"
+Provides-Extra: dev
+Requires-Dist: zerodep[bench-aes,bench-cache,bench-config,bench-diff,bench-dotenv,bench-frontmatter,bench-http,bench-jsonc,bench-markdown,bench-qr,bench-retry,bench-scheduler,bench-search,bench-soup,bench-sse,bench-structlog,bench-tabulate,bench-toon,bench-validate,bench-xml,bench-yaml,test]; extra == "dev"
+
+# zerodep
+
+Zero-dependency, single-file Python implementations of popular libraries — stdlib only, Python 3.10+.
+
+零依赖、单文件的 Python 常用库实现 —— 仅使用标准库，支持 Python 3.10+。
+
+## Modules
+
+**Web & Networking**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `httpclient/` | Sync + async REST client with connection pooling, proxy, and auth | `httpx` |
+| `sse/` | Server-Sent Events client with auto-reconnect | `httpx-sse` |
+
+**Data Formats**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `yaml/` | YAML parser and serializer (common subset) | `PyYAML` |
+| `jsonc/` | JSONC parser (JSON with comments and trailing commas) | `commentjson` |
+| `toon/` | TOON (Token-Oriented Object Notation) encoder/decoder | `toon_format` |
+| `frontmatter/` | Frontmatter parser and serializer (YAML/TOML/JSON file-header metadata) | `python-frontmatter` |
+
+**Data Validation**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `validate/` | Runtime TypedDict/dataclass validator with JSON Schema generation | `pydantic` |
+
+**Text & Markup**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `markdown/` | Markdown to HTML renderer (CommonMark subset + GFM tables) | `mistune` |
+| `soup/` | HTML parser with BeautifulSoup-like API (find, select, CSS selectors) | `beautifulsoup4` |
+| `diff/` | Unified diff parser, patch apply/reverse, three-way merge | `unidiff` |
+
+**Search & Retrieval**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `search/` | BM25/BM25+/BM25L/BM25F + TF-IDF full-text search engine | `rank-bm25` |
+
+**Configuration**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `dotenv/` | .env file parser (load_dotenv, dotenv_values) | `python-dotenv` |
+
+**CLI & Terminal**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `ansi/` | ANSI terminal styling: colors, attributes, detection, strip/visible_len | — |
+| `tabulate/` | Table formatting with multiple output styles | `tabulate` |
+| `prompt/` | Interactive CLI prompts (confirm, select, text) | `questionary` |
+
+**Security & Encoding**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `aes/` | AES encryption: ECB, CBC, CTR, GCM modes (pure Python + OpenSSL via ctypes) | `pycryptodome` |
+| `qr/` | QR Code generation with terminal rendering | `qrcode` |
+
+**Infrastructure & Tools**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `retry/` | Retry decorator with configurable backoff strategies | `tenacity` |
+| `scheduler/` | In-process task scheduler with cron, interval, one-shot triggers | `APScheduler` |
+| `structlog/` | Structured logging with pretty console output | `structlog` |
+| `vcs/` | Git/Hg/Jujutsu CLI wrapper (diff, status, log, blame) | — |
+
+## Usage
+
+Each module is a **self-contained single file** that you can copy directly into your project. No installation required.
+
+Some modules have optional **sibling dependencies** on other zerodep modules (e.g. `structlog` can use `ansi` for color support). These are loaded via guarded imports — if the sibling module is absent, the module falls back to inline constants and remains fully functional.
+
+## License
+
+MIT

zerodep-0.2.0/README.md

@@ -0,0 +1,83 @@
+# zerodep
+
+Zero-dependency, single-file Python implementations of popular libraries — stdlib only, Python 3.10+.
+
+零依赖、单文件的 Python 常用库实现 —— 仅使用标准库，支持 Python 3.10+。
+
+## Modules
+
+**Web & Networking**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `httpclient/` | Sync + async REST client with connection pooling, proxy, and auth | `httpx` |
+| `sse/` | Server-Sent Events client with auto-reconnect | `httpx-sse` |
+
+**Data Formats**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `yaml/` | YAML parser and serializer (common subset) | `PyYAML` |
+| `jsonc/` | JSONC parser (JSON with comments and trailing commas) | `commentjson` |
+| `toon/` | TOON (Token-Oriented Object Notation) encoder/decoder | `toon_format` |
+| `frontmatter/` | Frontmatter parser and serializer (YAML/TOML/JSON file-header metadata) | `python-frontmatter` |
+
+**Data Validation**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `validate/` | Runtime TypedDict/dataclass validator with JSON Schema generation | `pydantic` |
+
+**Text & Markup**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `markdown/` | Markdown to HTML renderer (CommonMark subset + GFM tables) | `mistune` |
+| `soup/` | HTML parser with BeautifulSoup-like API (find, select, CSS selectors) | `beautifulsoup4` |
+| `diff/` | Unified diff parser, patch apply/reverse, three-way merge | `unidiff` |
+
+**Search & Retrieval**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `search/` | BM25/BM25+/BM25L/BM25F + TF-IDF full-text search engine | `rank-bm25` |
+
+**Configuration**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `dotenv/` | .env file parser (load_dotenv, dotenv_values) | `python-dotenv` |
+
+**CLI & Terminal**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `ansi/` | ANSI terminal styling: colors, attributes, detection, strip/visible_len | — |
+| `tabulate/` | Table formatting with multiple output styles | `tabulate` |
+| `prompt/` | Interactive CLI prompts (confirm, select, text) | `questionary` |
+
+**Security & Encoding**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `aes/` | AES encryption: ECB, CBC, CTR, GCM modes (pure Python + OpenSSL via ctypes) | `pycryptodome` |
+| `qr/` | QR Code generation with terminal rendering | `qrcode` |
+
+**Infrastructure & Tools**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `retry/` | Retry decorator with configurable backoff strategies | `tenacity` |
+| `scheduler/` | In-process task scheduler with cron, interval, one-shot triggers | `APScheduler` |
+| `structlog/` | Structured logging with pretty console output | `structlog` |
+| `vcs/` | Git/Hg/Jujutsu CLI wrapper (diff, status, log, blame) | — |
+
+## Usage
+
+Each module is a **self-contained single file** that you can copy directly into your project. No installation required.
+
+Some modules have optional **sibling dependencies** on other zerodep modules (e.g. `structlog` can use `ansi` for color support). These are loaded via guarded imports — if the sibling module is absent, the module falls back to inline constants and remains fully functional.
+
+## License
+
+MIT

zerodep-0.2.0/pyproject.toml

@@ -0,0 +1,149 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+py-modules = ["zerodep"]
+
+[project]
+name = "zerodep"
+version = "0.2.0"
+description = "Zero-dependency, single-file Python implementations of popular libraries"
+authors = [{ name = "Peng Ding" }]
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+
+[project.scripts]
+zerodep = "zerodep:main"
+
+[project.urls]
+Repository = "https://github.com/Oaklight/zerodep"
+Issues = "https://github.com/Oaklight/zerodep/issues"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-benchmark>=4.0.0",
+]
+# Reference libraries for correctness and benchmark comparisons
+bench-aes = [
+    "pycryptodome>=3.20.0",
+]
+bench-qr = [
+    "qrcode>=7.0",
+    "Pillow>=10.0.0",
+]
+bench-http = [
+    "httpx>=0.27.0",
+]
+bench-dotenv = [
+    "python-dotenv>=1.0.0",
+]
+bench-yaml = [
+    "PyYAML>=6.0",
+]
+bench-jsonc = [
+    "commentjson>=0.9.0",
+]
+bench-structlog = [
+    "structlog>=24.0.0",
+]
+bench-retry = [
+    "tenacity>=8.0.0",
+]
+bench-toon = [
+    "toon-format>=0.1.0",
+]
+bench-tabulate = [
+    "tabulate>=0.9.0",
+]
+bench-soup = [
+    "beautifulsoup4>=4.12.0",
+]
+bench-validate = [
+    "pydantic>=2.0.0",
+]
+bench-sse = [
+    "httpx-sse>=0.4.0",
+    "httpx>=0.27.0",
+]
+bench-markdown = [
+    "mistune>=3.0.0",
+]
+bench-diff = [
+    "unidiff>=0.7.0",
+]
+bench-scheduler = [
+    "APScheduler>=3.10.0",
+    "schedule>=1.2.0",
+    "croniter>=1.3.0",
+]
+bench-search = [
+    "rank-bm25>=0.2.2",
+]
+bench-frontmatter = [
+    "python-frontmatter>=1.1.0",
+]
+bench-config = [
+    "python-decouple>=3.8",
+]
+bench-cache = [
+    "cachetools>=5.0.0",
+]
+bench-xml = [
+    "xmltodict>=0.13.0",
+]
+dev = [
+    "zerodep[test,bench-aes,bench-qr,bench-http,bench-dotenv,bench-yaml,bench-jsonc,bench-structlog,bench-retry,bench-toon,bench-tabulate,bench-soup,bench-validate,bench-sse,bench-markdown,bench-diff,bench-scheduler,bench-search,bench-frontmatter,bench-config,bench-cache,bench-xml]",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["aes", "qr", "httpclient", "dotenv", "yaml", "jsonc", "structlog", "retry", "toon", "tabulate", "soup", "prompt", "validate", "sse", "markdown", "diff", "vcs", "ansi", "scheduler", "search", "frontmatter", "config", "cache", "runner", "xml"]
+
+[tool.ruff]
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.ruff.lint.per-file-ignores]
+"aes/aes.py" = ["E501"]
+"aes/aes_openssl.py" = ["E501"]
+"qr/qr.py" = ["E501"]
+"yaml/yaml.py" = ["E501"]
+"validate/validate.py" = ["E501"]
+"diff/diff.py" = ["E501"]
+"vcs/vcs.py" = ["E501"]
+"xml/xml.py" = ["E501"]
+"**/test_*.py" = ["E402"]
+
+[tool.ty.environment]
+extra-paths = [
+    "./aes",
+    "./ansi",
+    "./diff",
+    "./dotenv",
+    "./httpclient",
+    "./jsonc",
+    "./markdown",
+    "./prompt",
+    "./qr",
+    "./retry",
+    "./soup",
+    "./sse",
+    "./structlog",
+    "./tabulate",
+    "./toon",
+    "./validate",
+    "./vcs",
+    "./yaml",
+    "./scheduler",
+    "./search",
+    "./frontmatter",
+    "./config",
+    "./cache",
+    "./runner",
+    "./xml",
+]

zerodep-0.2.0/setup.cfg

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

zerodep-0.2.0/zerodep.egg-info/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: zerodep
+Version: 0.2.0
+Summary: Zero-dependency, single-file Python implementations of popular libraries
+Author: Peng Ding
+License-Expression: MIT
+Project-URL: Repository, https://github.com/Oaklight/zerodep
+Project-URL: Issues, https://github.com/Oaklight/zerodep/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "test"
+Provides-Extra: bench-aes
+Requires-Dist: pycryptodome>=3.20.0; extra == "bench-aes"
+Provides-Extra: bench-qr
+Requires-Dist: qrcode>=7.0; extra == "bench-qr"
+Requires-Dist: Pillow>=10.0.0; extra == "bench-qr"
+Provides-Extra: bench-http
+Requires-Dist: httpx>=0.27.0; extra == "bench-http"
+Provides-Extra: bench-dotenv
+Requires-Dist: python-dotenv>=1.0.0; extra == "bench-dotenv"
+Provides-Extra: bench-yaml
+Requires-Dist: PyYAML>=6.0; extra == "bench-yaml"
+Provides-Extra: bench-jsonc
+Requires-Dist: commentjson>=0.9.0; extra == "bench-jsonc"
+Provides-Extra: bench-structlog
+Requires-Dist: structlog>=24.0.0; extra == "bench-structlog"
+Provides-Extra: bench-retry
+Requires-Dist: tenacity>=8.0.0; extra == "bench-retry"
+Provides-Extra: bench-toon
+Requires-Dist: toon-format>=0.1.0; extra == "bench-toon"
+Provides-Extra: bench-tabulate
+Requires-Dist: tabulate>=0.9.0; extra == "bench-tabulate"
+Provides-Extra: bench-soup
+Requires-Dist: beautifulsoup4>=4.12.0; extra == "bench-soup"
+Provides-Extra: bench-validate
+Requires-Dist: pydantic>=2.0.0; extra == "bench-validate"
+Provides-Extra: bench-sse
+Requires-Dist: httpx-sse>=0.4.0; extra == "bench-sse"
+Requires-Dist: httpx>=0.27.0; extra == "bench-sse"
+Provides-Extra: bench-markdown
+Requires-Dist: mistune>=3.0.0; extra == "bench-markdown"
+Provides-Extra: bench-diff
+Requires-Dist: unidiff>=0.7.0; extra == "bench-diff"
+Provides-Extra: bench-scheduler
+Requires-Dist: APScheduler>=3.10.0; extra == "bench-scheduler"
+Requires-Dist: schedule>=1.2.0; extra == "bench-scheduler"
+Requires-Dist: croniter>=1.3.0; extra == "bench-scheduler"
+Provides-Extra: bench-search
+Requires-Dist: rank-bm25>=0.2.2; extra == "bench-search"
+Provides-Extra: bench-frontmatter
+Requires-Dist: python-frontmatter>=1.1.0; extra == "bench-frontmatter"
+Provides-Extra: bench-config
+Requires-Dist: python-decouple>=3.8; extra == "bench-config"
+Provides-Extra: bench-cache
+Requires-Dist: cachetools>=5.0.0; extra == "bench-cache"
+Provides-Extra: bench-xml
+Requires-Dist: xmltodict>=0.13.0; extra == "bench-xml"
+Provides-Extra: dev
+Requires-Dist: zerodep[bench-aes,bench-cache,bench-config,bench-diff,bench-dotenv,bench-frontmatter,bench-http,bench-jsonc,bench-markdown,bench-qr,bench-retry,bench-scheduler,bench-search,bench-soup,bench-sse,bench-structlog,bench-tabulate,bench-toon,bench-validate,bench-xml,bench-yaml,test]; extra == "dev"
+
+# zerodep
+
+Zero-dependency, single-file Python implementations of popular libraries — stdlib only, Python 3.10+.
+
+零依赖、单文件的 Python 常用库实现 —— 仅使用标准库，支持 Python 3.10+。
+
+## Modules
+
+**Web & Networking**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `httpclient/` | Sync + async REST client with connection pooling, proxy, and auth | `httpx` |
+| `sse/` | Server-Sent Events client with auto-reconnect | `httpx-sse` |
+
+**Data Formats**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `yaml/` | YAML parser and serializer (common subset) | `PyYAML` |
+| `jsonc/` | JSONC parser (JSON with comments and trailing commas) | `commentjson` |
+| `toon/` | TOON (Token-Oriented Object Notation) encoder/decoder | `toon_format` |
+| `frontmatter/` | Frontmatter parser and serializer (YAML/TOML/JSON file-header metadata) | `python-frontmatter` |
+
+**Data Validation**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `validate/` | Runtime TypedDict/dataclass validator with JSON Schema generation | `pydantic` |
+
+**Text & Markup**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `markdown/` | Markdown to HTML renderer (CommonMark subset + GFM tables) | `mistune` |
+| `soup/` | HTML parser with BeautifulSoup-like API (find, select, CSS selectors) | `beautifulsoup4` |
+| `diff/` | Unified diff parser, patch apply/reverse, three-way merge | `unidiff` |
+
+**Search & Retrieval**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `search/` | BM25/BM25+/BM25L/BM25F + TF-IDF full-text search engine | `rank-bm25` |
+
+**Configuration**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `dotenv/` | .env file parser (load_dotenv, dotenv_values) | `python-dotenv` |
+
+**CLI & Terminal**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `ansi/` | ANSI terminal styling: colors, attributes, detection, strip/visible_len | — |
+| `tabulate/` | Table formatting with multiple output styles | `tabulate` |
+| `prompt/` | Interactive CLI prompts (confirm, select, text) | `questionary` |
+
+**Security & Encoding**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `aes/` | AES encryption: ECB, CBC, CTR, GCM modes (pure Python + OpenSSL via ctypes) | `pycryptodome` |
+| `qr/` | QR Code generation with terminal rendering | `qrcode` |
+
+**Infrastructure & Tools**
+
+| Module | Description | Benchmark Against |
+|--------|-------------|-------------------|
+| `retry/` | Retry decorator with configurable backoff strategies | `tenacity` |
+| `scheduler/` | In-process task scheduler with cron, interval, one-shot triggers | `APScheduler` |
+| `structlog/` | Structured logging with pretty console output | `structlog` |
+| `vcs/` | Git/Hg/Jujutsu CLI wrapper (diff, status, log, blame) | — |
+
+## Usage
+
+Each module is a **self-contained single file** that you can copy directly into your project. No installation required.
+
+Some modules have optional **sibling dependencies** on other zerodep modules (e.g. `structlog` can use `ansi` for color support). These are loaded via guarded imports — if the sibling module is absent, the module falls back to inline constants and remains fully functional.
+
+## License
+
+MIT

zerodep-0.2.0/zerodep.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+zerodep.py
+zerodep.egg-info/PKG-INFO
+zerodep.egg-info/SOURCES.txt
+zerodep.egg-info/dependency_links.txt
+zerodep.egg-info/entry_points.txt
+zerodep.egg-info/requires.txt
+zerodep.egg-info/top_level.txt

zerodep-0.2.0/zerodep.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

zerodep-0.2.0/zerodep.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+zerodep = zerodep:main

zerodep-0.2.0/zerodep.egg-info/requires.txt

@@ -0,0 +1,75 @@
+
+[bench-aes]
+pycryptodome>=3.20.0
+
+[bench-cache]
+cachetools>=5.0.0
+
+[bench-config]
+python-decouple>=3.8
+
+[bench-diff]
+unidiff>=0.7.0
+
+[bench-dotenv]
+python-dotenv>=1.0.0
+
+[bench-frontmatter]
+python-frontmatter>=1.1.0
+
+[bench-http]
+httpx>=0.27.0
+
+[bench-jsonc]
+commentjson>=0.9.0
+
+[bench-markdown]
+mistune>=3.0.0
+
+[bench-qr]
+qrcode>=7.0
+Pillow>=10.0.0
+
+[bench-retry]
+tenacity>=8.0.0
+
+[bench-scheduler]
+APScheduler>=3.10.0
+schedule>=1.2.0
+croniter>=1.3.0
+
+[bench-search]
+rank-bm25>=0.2.2
+
+[bench-soup]
+beautifulsoup4>=4.12.0
+
+[bench-sse]
+httpx-sse>=0.4.0
+httpx>=0.27.0
+
+[bench-structlog]
+structlog>=24.0.0
+
+[bench-tabulate]
+tabulate>=0.9.0
+
+[bench-toon]
+toon-format>=0.1.0
+
+[bench-validate]
+pydantic>=2.0.0
+
+[bench-xml]
+xmltodict>=0.13.0
+
+[bench-yaml]
+PyYAML>=6.0
+
+[dev]
+zerodep[bench-aes,bench-cache,bench-config,bench-diff,bench-dotenv,bench-frontmatter,bench-http,bench-jsonc,bench-markdown,bench-qr,bench-retry,bench-scheduler,bench-search,bench-soup,bench-sse,bench-structlog,bench-tabulate,bench-toon,bench-validate,bench-xml,bench-yaml,test]
+
+[test]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+pytest-benchmark>=4.0.0

zerodep-0.2.0/zerodep.egg-info/top_level.txt

@@ -0,0 +1 @@
+zerodep

zerodep-0.2.0/zerodep.py

@@ -0,0 +1,554 @@
+"""zerodep CLI — copy zero-dependency Python modules into your project.
+
+Usage::
+
+    python zerodep.py list                  # list available modules
+    python zerodep.py info <module>         # module details + deps
+    python zerodep.py add <module> [...]    # copy modules to cwd
+    python zerodep.py manifest              # regenerate manifest.json
+
+Requires Python 3.10+, zero external dependencies.
+"""
+
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+import argparse
+import ast
+import json
+import shutil
+import sys
+import textwrap
+import urllib.error
+import urllib.request
+from datetime import datetime, timezone
+from pathlib import Path
+
+# ── Constants ──
+
+REPO_OWNER = "Oaklight"
+REPO_NAME = "zerodep"
+BRANCH = "master"
+
+_SOURCES = [
+    f"https://raw.githubusercontent.com/{REPO_OWNER}/{REPO_NAME}/{BRANCH}/{{path}}",
+    f"https://cdn.jsdelivr.net/gh/{REPO_OWNER}/{REPO_NAME}@{BRANCH}/{{path}}",
+    f"https://fastly.jsdelivr.net/gh/{REPO_OWNER}/{REPO_NAME}@{BRANCH}/{{path}}",
+]
+
+CACHE_DIR = Path.home() / ".zerodep" / "cache"
+MANIFEST_PATH = "manifest.json"
+
+# Modules where the directory name != file name (multi-file or renamed)
+# Discovered automatically during manifest generation.
+
+
+# ── Network ──
+
+
+def _fetch_url(url: str, timeout: int = 15) -> bytes:
+    """Fetch raw bytes from a URL using urllib."""
+    req = urllib.request.Request(url, headers={"User-Agent": "zerodep-cli"})
+    with urllib.request.urlopen(req, timeout=timeout) as resp:
+        return resp.read()
+
+
+def _fetch_with_fallback(path: str, *, offline: bool = False) -> bytes:
+    """Try sources in order, cache result, fall back to cache."""
+    cache_file = CACHE_DIR / path
+    if offline:
+        if cache_file.exists():
+            return cache_file.read_bytes()
+        _die(f"offline mode: {path!r} not found in cache ({cache_file})")
+
+    for src in _SOURCES:
+        url = src.format(path=path)
+        try:
+            data = _fetch_url(url)
+            cache_file.parent.mkdir(parents=True, exist_ok=True)
+            cache_file.write_bytes(data)
+            return data
+        except (urllib.error.URLError, OSError, TimeoutError):
+            continue
+
+    # All sources failed — try cache
+    if cache_file.exists():
+        _warn(f"network unavailable, using cached {path}")
+        return cache_file.read_bytes()
+
+    _die(
+        f"could not fetch {path!r} from any source and no cache exists.\n"
+        "  Check your network or use --offline with a populated cache."
+    )
+    return b""  # unreachable, for type checker
+
+
+def _load_manifest(*, offline: bool = False, local: bool = False) -> dict:
+    """Load manifest.json from network/cache or local file."""
+    if local:
+        # Use local manifest.json in repo root
+        local_path = Path(__file__).resolve().parent / MANIFEST_PATH
+        if not local_path.exists():
+            _die(
+                f"local {MANIFEST_PATH} not found. "
+                "Run 'zerodep manifest' to generate it."
+            )
+        return json.loads(local_path.read_text())
+
+    data = _fetch_with_fallback(MANIFEST_PATH, offline=offline)
+    return json.loads(data)
+
+
+# ── Dependency Resolution ──
+
+
+def _resolve_deps(
+    names: list[str],
+    manifest: dict,
+    *,
+    no_deps: bool = False,
+) -> list[str]:
+    """Topological resolve: return ordered list of modules to copy."""
+    modules = manifest["modules"]
+    resolved: list[str] = []
+    seen: set[str] = set()
+
+    def _visit(name: str) -> None:
+        if name in seen:
+            return
+        if name not in modules:
+            _die(
+                f"unknown module: {name!r}. "
+                "Run 'zerodep list' to see available modules."
+            )
+        seen.add(name)
+        if not no_deps:
+            for dep in modules[name].get("deps", []):
+                _visit(dep)
+        resolved.append(name)
+
+    for n in names:
+        _visit(n)
+    return resolved
+
+
+# ── Manifest Generation ──
+
+# Directories/files to skip when scanning for modules
+_SKIP_DIRS = {
+    "docs_en",
+    "docs_zh",
+    "plans",
+    ".git",
+    ".github",
+    "__pycache__",
+    ".pytest_cache",
+    ".ruff_cache",
+    "site",
+}
+
+
+def _scan_modules(repo_root: Path) -> dict:
+    """Scan repo recursively for module directories and extract metadata.
+
+    A directory is considered a module if it contains non-test ``.py`` files.
+    The module name is the leaf directory name (e.g. ``network/httpclient/``
+    registers as ``httpclient``).  Intermediate grouping directories that
+    contain no ``.py`` files are traversed but not registered.
+    """
+    modules: dict[str, dict] = {}
+
+    def _walk(directory: Path) -> None:
+        for entry in sorted(directory.iterdir()):
+            if (
+                not entry.is_dir()
+                or entry.name.startswith(".")
+                or entry.name in _SKIP_DIRS
+            ):
+                continue
+
+            # Find non-test .py files in this directory
+            py_files = sorted(
+                f
+                for f in entry.glob("*.py")
+                if not f.name.startswith("test_") and f.name != "conftest.py"
+            )
+
+            if py_files:
+                mod_name = entry.name
+                if mod_name in modules:
+                    prev_dir = str(Path(modules[mod_name]["files"][0]).parent)
+                    cur_dir = str(entry.relative_to(repo_root))
+                    _warn(
+                        f"duplicate module name {mod_name!r}: "
+                        f"found in {prev_dir} and {cur_dir}, keeping first"
+                    )
+                else:
+                    # Primary module file: prefer dir_name.py, else first file
+                    primary = None
+                    for f in py_files:
+                        if f.stem == entry.name:
+                            primary = f
+                            break
+                    if primary is None:
+                        primary = py_files[0]
+
+                    source = primary.read_text(encoding="utf-8")
+                    meta = _extract_frontmatter(source)
+                    version = meta.get("version", "0.0.0")
+                    deps = meta.get("deps", [])
+                    description = _extract_docstring_first_line(source) or ""
+                    files = [str(f.relative_to(repo_root)) for f in py_files]
+
+                    modules[mod_name] = {
+                        "description": description,
+                        "files": files,
+                        "version": version,
+                        "deps": deps,
+                    }
+
+            # Recurse into subdirectories
+            _walk(entry)
+
+    _walk(repo_root)
+    return modules
+
+
+def _extract_frontmatter(source: str) -> dict[str, str | list]:
+    """Extract metadata from ``# /// zerodep`` frontmatter block.
+
+    Parses a PEP 723-style comment block::
+
+        # /// zerodep
+        # version = "0.2.0"
+        # deps = ["httpclient"]
+        # ///
+
+    Returns:
+        Dict with parsed key-value pairs (values via ``ast.literal_eval``).
+    """
+    result: dict[str, str | list] = {}
+    in_block = False
+    for line in source.splitlines():
+        stripped = line.strip()
+        if stripped == "# /// zerodep":
+            in_block = True
+            continue
+        if stripped == "# ///" and in_block:
+            break
+        if in_block and stripped.startswith("# "):
+            content = stripped[2:]
+            if "=" in content:
+                key, _, val = content.partition("=")
+                key = key.strip()
+                val = val.strip()
+                try:
+                    result[key] = ast.literal_eval(val)
+                except (ValueError, SyntaxError):
+                    result[key] = val
+    return result
+
+
+def _extract_docstring_first_line(source: str) -> str | None:
+    """Extract the first line of the module docstring."""
+    try:
+        tree = ast.parse(source)
+    except SyntaxError:
+        return None
+    if (
+        tree.body
+        and isinstance(tree.body[0], ast.Expr)
+        and isinstance(tree.body[0].value, ast.Constant)
+        and isinstance(tree.body[0].value.value, str)
+    ):
+        first_line = tree.body[0].value.value.strip().split("\n")[0]
+        # Remove trailing period/dash fragments
+        return first_line.rstrip(".")
+    return None
+
+
+def _generate_manifest(repo_root: Path) -> dict:
+    """Generate the full manifest dict."""
+    modules = _scan_modules(repo_root)
+    return {
+        "version": "1",
+        "generated": datetime.now(timezone.utc).isoformat(),
+        "modules": modules,
+    }
+
+
+# ── Output Helpers ──
+
+
+def _die(msg: str) -> None:
+    print(f"error: {msg}", file=sys.stderr)
+    sys.exit(1)
+
+
+def _warn(msg: str) -> None:
+    print(f"warning: {msg}", file=sys.stderr)
+
+
+def _ok(msg: str) -> None:
+    print(msg)
+
+
+# ── Commands ──
+
+
+def cmd_list(args: argparse.Namespace) -> None:
+    """List available modules."""
+    manifest = _load_manifest(offline=args.offline, local=args.local)
+    modules = manifest["modules"]
+
+    if not modules:
+        _ok("No modules found.")
+        return
+
+    # Column widths
+    name_w = max(len(n) for n in modules)
+    ver_w = max(len(m.get("version", "")) for m in modules.values())
+
+    header = f"  {'Module':<{name_w}}  {'Version':<{ver_w}}  Description"
+    _ok(header)
+    _ok(f"  {'-' * name_w}  {'-' * ver_w}  {'-' * 40}")
+
+    for name in sorted(modules):
+        mod = modules[name]
+        ver = mod.get("version", "?")
+        desc = mod.get("description", "")
+        # Truncate description
+        max_desc = shutil.get_terminal_size((80, 24)).columns - name_w - ver_w - 8
+        if max_desc > 10 and len(desc) > max_desc:
+            desc = desc[: max_desc - 3] + "..."
+        _ok(f"  {name:<{name_w}}  {ver:<{ver_w}}  {desc}")
+
+    _ok(f"\n  {len(modules)} modules available")
+
+
+def cmd_info(args: argparse.Namespace) -> None:
+    """Show module details."""
+    manifest = _load_manifest(offline=args.offline, local=args.local)
+    modules = manifest["modules"]
+    name = args.module
+
+    if name not in modules:
+        _die(f"unknown module: {name!r}. Run 'zerodep list' to see available modules.")
+
+    mod = modules[name]
+    _ok(f"Module:      {name}")
+    _ok(f"Version:     {mod.get('version', '?')}")
+    _ok(f"Description: {mod.get('description', '(none)')}")
+    _ok(f"Files:       {', '.join(mod.get('files', []))}")
+
+    deps = mod.get("deps", [])
+    if deps:
+        _ok(f"Dependencies: {', '.join(deps)}")
+        # Show transitive deps
+        all_deps = _resolve_deps([name], manifest)
+        all_deps.remove(name)
+        if all_deps:
+            _ok(f"  (transitive: {', '.join(all_deps)})")
+    else:
+        _ok("Dependencies: none")
+
+
+def cmd_add(args: argparse.Namespace) -> None:
+    """Copy module files to target directory."""
+    manifest = _load_manifest(offline=args.offline, local=args.local)
+
+    # Resolve dependencies
+    to_copy = _resolve_deps(args.modules, manifest, no_deps=args.no_deps)
+
+    # Determine target directory
+    target = Path(args.dir).resolve()
+
+    # Build file list
+    file_plan: list[tuple[str, Path]] = []  # (remote_path, local_dest)
+    modules_data = manifest["modules"]
+
+    for mod_name in to_copy:
+        mod = modules_data[mod_name]
+        for remote_path in mod.get("files", []):
+            filename = Path(remote_path).name
+            if args.nested:
+                dest = target / mod_name / filename
+            else:
+                dest = target / filename
+            file_plan.append((remote_path, dest))
+
+    if not file_plan:
+        _ok("Nothing to copy.")
+        return
+
+    # Show plan
+    if not args.yes:
+        _ok("Will copy:")
+        for remote, dest in file_plan:
+            mod_name = remote.split("/")[0]
+            label = mod_name
+            if mod_name not in args.modules:
+                label += " (dependency)"
+            if dest.is_relative_to(Path.cwd()):
+                rel_dest = dest.relative_to(Path.cwd())
+            else:
+                rel_dest = dest
+            _ok(f"  {Path(remote).name:<25s} -> {rel_dest}  [{label}]")
+        _ok(f"Target: {target}")
+
+        # Check for existing files
+        existing = [dest for _, dest in file_plan if dest.exists()]
+        if existing:
+            _warn(f"{len(existing)} file(s) will be overwritten")
+
+        if not args.force:
+            answer = input("Continue? [Y/n] ").strip().lower()
+            if answer and answer != "y":
+                _ok("Aborted.")
+                return
+
+    # Fetch and copy
+    repo_root = Path(__file__).resolve().parent
+    copied = 0
+    for remote_path, dest in file_plan:
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        # Try local first (if running from repo)
+        local_file = repo_root / remote_path
+        if local_file.exists():
+            data = local_file.read_bytes()
+        else:
+            data = _fetch_with_fallback(remote_path, offline=args.offline)
+        dest.write_bytes(data)
+        copied += 1
+
+    _ok(f"Copied {copied} file(s) to {target}")
+
+
+def cmd_update(args: argparse.Namespace) -> None:
+    """Update existing module files (alias for add --force --yes)."""
+    args.force = True
+    args.yes = True
+    cmd_add(args)
+
+
+def cmd_manifest(args: argparse.Namespace) -> None:
+    """Regenerate manifest.json from local module source files."""
+    repo_root = Path(__file__).resolve().parent
+    manifest = _generate_manifest(repo_root)
+
+    out_path = repo_root / MANIFEST_PATH
+    out_path.write_text(
+        json.dumps(manifest, indent=2, ensure_ascii=False) + "\n",
+        encoding="utf-8",
+    )
+
+    n = len(manifest["modules"])
+    _ok(f"Generated {MANIFEST_PATH} with {n} modules")
+
+    # Show deps summary
+    deps_mods = {
+        name: mod["deps"]
+        for name, mod in manifest["modules"].items()
+        if mod.get("deps")
+    }
+    if deps_mods:
+        _ok("Modules with dependencies:")
+        for name, deps in sorted(deps_mods.items()):
+            _ok(f"  {name} -> {', '.join(deps)}")
+
+
+def cmd_version(args: argparse.Namespace) -> None:
+    """Print version."""
+    _ok(f"zerodep {__version__}")
+
+
+# ── CLI Entry Point ──
+
+
+def main(argv: list[str] | None = None) -> None:
+    """CLI dispatcher."""
+    parser = argparse.ArgumentParser(
+        prog="zerodep",
+        description="Copy zero-dependency Python modules into your project.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=textwrap.dedent("""\
+            examples:
+              zerodep list                   List all available modules
+              zerodep info sse               Show module details and deps
+              zerodep add scheduler          Copy scheduler.py to current dir
+              zerodep add sse retry -d lib/  Copy sse + httpclient + retry to lib/
+              zerodep add sse --nested       Copy into sse/ and httpclient/ subdirs
+              zerodep add sse --no-deps      Copy only sse.py, skip httpclient
+              zerodep manifest               Regenerate manifest.json
+        """),
+    )
+    parser.add_argument(
+        "--offline",
+        action="store_true",
+        help="use only cached files, no network",
+    )
+    parser.add_argument(
+        "--local",
+        action="store_true",
+        help="use local manifest.json instead of fetching from remote",
+    )
+
+    sub = parser.add_subparsers(dest="command")
+
+    # list
+    sub.add_parser("list", help="list available modules")
+
+    # info
+    p_info = sub.add_parser("info", help="show module details")
+    p_info.add_argument("module", help="module name")
+
+    # add
+    p_add = sub.add_parser("add", help="copy modules to your project")
+    p_add.add_argument("modules", nargs="+", help="module names to copy")
+    p_add.add_argument("-d", "--dir", default=".", help="target directory (default: .)")
+    p_add.add_argument(
+        "--nested", action="store_true", help="use subdirectories per module"
+    )
+    p_add.add_argument("--no-deps", action="store_true", help="skip dependencies")
+    p_add.add_argument("-y", "--yes", action="store_true", help="skip confirmation")
+    p_add.add_argument(
+        "-f", "--force", action="store_true", help="overwrite without prompt"
+    )
+
+    # update
+    p_update = sub.add_parser("update", help="update existing modules")
+    p_update.add_argument("modules", nargs="+", help="module names to update")
+    p_update.add_argument(
+        "-d", "--dir", default=".", help="target directory (default: .)"
+    )
+    p_update.add_argument(
+        "--nested", action="store_true", help="use subdirectories per module"
+    )
+    p_update.add_argument("--no-deps", action="store_true", help="skip dependencies")
+
+    # manifest
+    sub.add_parser("manifest", help="regenerate manifest.json from source")
+
+    # version
+    sub.add_parser("version", help="show version")
+
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        parser.print_help()
+        sys.exit(0)
+
+    commands = {
+        "list": cmd_list,
+        "info": cmd_info,
+        "add": cmd_add,
+        "update": cmd_update,
+        "manifest": cmd_manifest,
+        "version": cmd_version,
+    }
+    commands[args.command](args)
+
+
+if __name__ == "__main__":
+    main()