unichef 0.1.0a2__tar.gz

unichef-0.1.0a2/.gitignore

@@ -0,0 +1,40 @@
+# Planning documents: kept local, never committed
+/PRD.md
+/PROMPT.md
+/UniChef-PRD.md
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+dist/
+dist-extension/
+build/
+# The extension build scripts are source.
+!clients/extensions/common/build/
+*.egg-info/
+
+# Node / TypeScript
+node_modules/
+.pnpm-store/
+*.tsbuildinfo
+coverage/
+
+# Generated assets (rebuilt by scripts/assets/build.py)
+assets/branding/dist/
+
+# Editors, OS, local tool state
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+.claude/settings.local.json
+reports/
+.claude/worktrees/
+test-results/
+playwright-report/

unichef-0.1.0a2/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.5
+Name: unichef
+Version: 0.1.0a2
+Summary: Unicode character analysis and deterministic data-transformation recipes for the terminal.
+Project-URL: Homepage, https://0xdolan.github.io/unichef/
+Project-URL: Source, https://github.com/0xdolan/unichef
+Project-URL: Issues, https://github.com/0xdolan/unichef/issues
+Project-URL: Changelog, https://github.com/0xdolan/unichef/blob/main/CHANGELOG.md
+Author: 0xdolan
+License: GPL-3.0-or-later
+Keywords: bidi,cli,cyberchef,encoding,homoglyph,security,unicode
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Security
+Classifier: Topic :: Text Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: cryptography>=41.0
+Requires-Dist: regex>=2022.10.31
+Requires-Dist: rich>=13.7
+Description-Content-Type: text/markdown
+
+# unichef (Python)
+
+The UniChef command-line tool and its Python core: Unicode character analysis and deterministic data-transformation recipes for the terminal.
+
+UniChef computes every Unicode result from its own copy of the Unicode Character Database, so the output does not depend on the Python version that runs it.
+
+## Development
+
+```sh
+uv sync --all-groups
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+See the repository [README](https://github.com/0xdolan/unichef#readme) for the full documentation.
+
+License: GPL-3.0-or-later.

unichef-0.1.0a2/README.md

@@ -0,0 +1,18 @@
+# unichef (Python)
+
+The UniChef command-line tool and its Python core: Unicode character analysis and deterministic data-transformation recipes for the terminal.
+
+UniChef computes every Unicode result from its own copy of the Unicode Character Database, so the output does not depend on the Python version that runs it.
+
+## Development
+
+```sh
+uv sync --all-groups
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+See the repository [README](https://github.com/0xdolan/unichef#readme) for the full documentation.
+
+License: GPL-3.0-or-later.

unichef-0.1.0a2/pyproject.toml

@@ -0,0 +1,100 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "unichef"
+dynamic = ["version"]
+description = "Unicode character analysis and deterministic data-transformation recipes for the terminal."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "GPL-3.0-or-later" }
+authors = [{ name = "0xdolan" }]
+keywords = ["unicode", "cyberchef", "encoding", "security", "cli", "homoglyph", "bidi"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Information Technology",
+  "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Security",
+  "Topic :: Text Processing",
+  "Typing :: Typed",
+]
+dependencies = [
+  "rich>=13.7",
+  "regex>=2022.10.31",
+  "cryptography>=41.0",
+]
+
+[project.urls]
+Homepage = "https://0xdolan.github.io/unichef/"
+Source = "https://github.com/0xdolan/unichef"
+Issues = "https://github.com/0xdolan/unichef/issues"
+Changelog = "https://github.com/0xdolan/unichef/blob/main/CHANGELOG.md"
+
+[project.scripts]
+unichef = "unichef.__main__:main"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.3",
+  "pytest-cov>=5.0",
+  "hypothesis>=6.100",
+  "mypy>=1.13",
+  "ruff>=0.8",
+]
+
+[tool.hatch.version]
+path = "src/unichef/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/unichef"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/unichef", "tests", "README.md", "pyproject.toml"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "N", "UP", "B", "A", "C4", "SIM", "PTH", "RET", "ARG", "PL", "PERF", "RUF", "S", "T20", "ANN"]
+ignore = ["PLR0913", "S101"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["ANN", "PLR2004", "RUF001", "S"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["unichef"]
+
+[tool.ruff.format]
+quote-style = "double"
+docstring-code-format = true
+
+[tool.mypy]
+strict = true
+python_version = "3.12"
+files = ["src", "tests"]
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = ["regex.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+# Performance budgets run on their own (`make perf`): coverage tracing would skew them.
+addopts = "-ra --strict-markers -m 'not perf' --cov=unichef --cov-report=term-missing --cov-fail-under=90"
+testpaths = ["tests"]
+markers = [
+    "parity: shared vector tests",
+    "conformance: UCD conformance tests",
+    "slow: long-running",
+    "perf: performance budgets (PRD §13.1), run by make perf",
+]

unichef-0.1.0a2/src/unichef/__init__.py

@@ -0,0 +1,4 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+"""UniChef: Unicode character analysis and deterministic data-transformation recipes."""
+
+__version__ = "0.1.0a2"

unichef-0.1.0a2/src/unichef/__main__.py

@@ -0,0 +1,31 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+"""``python -m unichef`` and the ``unichef`` console script."""
+
+import sys
+from collections.abc import Sequence
+
+_PLAIN_VERSION = (["version"], ["--version"])
+
+
+def fast_version(argv: Sequence[str]) -> bool:
+    """Answer a bare ``unichef version`` without loading Rich or the registry (PRD §5.8:
+    cold start). Any other flag takes the normal path."""
+    if list(argv) not in _PLAIN_VERSION:
+        return False
+    from unichef.cli.about import version_line  # noqa: PLC0415
+
+    sys.stdout.buffer.write((version_line() + "\n").encode("utf-8"))
+    sys.stdout.flush()
+    return True
+
+
+def main() -> int:
+    if fast_version(sys.argv[1:]):
+        return 0
+    from unichef.cli.main import run  # noqa: PLC0415 - keep ``import unichef`` cheap
+
+    return run()
+
+
+if __name__ == "__main__":
+    sys.exit(main())