polyglot-python 0.2.0__tar.gz → 0.2.1__tar.gz

{polyglot_python-0.2.0/src/polyglot_python.egg-info → polyglot_python-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyglot-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Deterministic multilingual Python keyword transpiler: write Python in your own language.
 Author: Furox-Art
 License-Expression: MIT
@@ -37,15 +37,21 @@ syntax with your words.
 ## Install
 
 ```bash
-pip install polyglot-python   # after the first release
+pip install polyglot-python
 pip install -e .              # from source
 ```
 
-The first release is prepared but not yet on PyPI; install from source until it
-is published. Requires Python 3.12+. Python 3.10/3.11 are not supported because
+Requires Python 3.12+. Python 3.10/3.11 are not supported because
 their tokenizer splits Indic combining marks, so several Hindi keywords would
 not translate. No runtime dependencies.
 
+Node.js users can install the thin npm wrapper. It forwards every command to
+the Python CLI, so the Python package must be installed as well.
+
+```bash
+npm install -g polyglot-python
+```
+
 ## Quick start
 
 `examples/classify.tr`:
@@ -149,28 +155,33 @@ python -m venv .venv
 .venv/Scripts/python -m pytest -q --cov=polyglot_python --cov-fail-under=100
 ```
 
-The suite contains 119 tests with 100% statement coverage, including every
+The suite contains 120 tests with 100% statement coverage, including every
 keyword in both directions for all 9 locales, end-to-end CLI runs of every
-example, version consistency with the changelog, and byte-level determinism
-checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS at 3.12, enforces the
-100% coverage gate on Linux 3.12, translates every example twice on all three
-operating systems to compare bytes and line counts, and builds the wheel,
-installs it into a clean environment, and smoke-tests it. Dependabot keeps
-GitHub Actions and development dependencies current. A separate release
-workflow publishes tagged GitHub Releases to PyPI through Trusted Publishing.
+example, version consistency with the changelog and the npm wrapper, and
+byte-level determinism checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS
+at 3.12, enforces the 100% coverage gate on Linux 3.12, translates every
+example twice on all three operating systems to compare bytes and line counts,
+builds the wheel, installs it into a clean environment, and smoke-tests it,
+and runs the npm wrapper against the installed Python package. Dependabot keeps
+GitHub Actions and development dependencies current. Separate release workflows
+publish tagged GitHub Releases to PyPI and npm through Trusted Publishing.
 
 ## Releasing
 
-Publishing uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
-and stores no API token.
-
-1. On PyPI, add a pending publisher for project `polyglot-python`: owner
-   `Furox-Art`, repository `polyglot-python`, workflow `release.yml`,
-   environment `pypi`.
-2. Change `version` in `pyproject.toml` and
-   `src/polyglot_python/__init__.py` together; the test suite rejects drift.
-3. Publish a GitHub Release with tag `v<version>`. The release workflow verifies
-   the tag, builds the sdist and wheel, and uploads them to PyPI.
+Publishing uses Trusted Publishing for both registries and stores no API token.
+
+1. Configure the trusted publishers once:
+   - PyPI: publisher for project `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release.yml`, environment `pypi`.
+   - npm: trusted publisher for package `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release-npm.yml`, environment
+     `npm`.
+2. Change `version` in `pyproject.toml`,
+   `src/polyglot_python/__init__.py` and `npm/package.json` together; the test
+   suite rejects drift.
+3. Publish a GitHub Release with tag `v<version>`. `release.yml` verifies the
+   tag, builds the sdist and wheel, and uploads them to PyPI; `release-npm.yml`
+   verifies the same version and publishes `npm/` to npm with provenance.
 
 ## License
 

{polyglot_python-0.2.0 → polyglot_python-0.2.1}/README.md

@@ -13,15 +13,21 @@ syntax with your words.
 ## Install
 
 ```bash
-pip install polyglot-python   # after the first release
+pip install polyglot-python
 pip install -e .              # from source
 ```
 
-The first release is prepared but not yet on PyPI; install from source until it
-is published. Requires Python 3.12+. Python 3.10/3.11 are not supported because
+Requires Python 3.12+. Python 3.10/3.11 are not supported because
 their tokenizer splits Indic combining marks, so several Hindi keywords would
 not translate. No runtime dependencies.
 
+Node.js users can install the thin npm wrapper. It forwards every command to
+the Python CLI, so the Python package must be installed as well.
+
+```bash
+npm install -g polyglot-python
+```
+
 ## Quick start
 
 `examples/classify.tr`:
@@ -125,28 +131,33 @@ python -m venv .venv
 .venv/Scripts/python -m pytest -q --cov=polyglot_python --cov-fail-under=100
 ```
 
-The suite contains 119 tests with 100% statement coverage, including every
+The suite contains 120 tests with 100% statement coverage, including every
 keyword in both directions for all 9 locales, end-to-end CLI runs of every
-example, version consistency with the changelog, and byte-level determinism
-checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS at 3.12, enforces the
-100% coverage gate on Linux 3.12, translates every example twice on all three
-operating systems to compare bytes and line counts, and builds the wheel,
-installs it into a clean environment, and smoke-tests it. Dependabot keeps
-GitHub Actions and development dependencies current. A separate release
-workflow publishes tagged GitHub Releases to PyPI through Trusted Publishing.
+example, version consistency with the changelog and the npm wrapper, and
+byte-level determinism checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS
+at 3.12, enforces the 100% coverage gate on Linux 3.12, translates every
+example twice on all three operating systems to compare bytes and line counts,
+builds the wheel, installs it into a clean environment, and smoke-tests it,
+and runs the npm wrapper against the installed Python package. Dependabot keeps
+GitHub Actions and development dependencies current. Separate release workflows
+publish tagged GitHub Releases to PyPI and npm through Trusted Publishing.
 
 ## Releasing
 
-Publishing uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
-and stores no API token.
-
-1. On PyPI, add a pending publisher for project `polyglot-python`: owner
-   `Furox-Art`, repository `polyglot-python`, workflow `release.yml`,
-   environment `pypi`.
-2. Change `version` in `pyproject.toml` and
-   `src/polyglot_python/__init__.py` together; the test suite rejects drift.
-3. Publish a GitHub Release with tag `v<version>`. The release workflow verifies
-   the tag, builds the sdist and wheel, and uploads them to PyPI.
+Publishing uses Trusted Publishing for both registries and stores no API token.
+
+1. Configure the trusted publishers once:
+   - PyPI: publisher for project `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release.yml`, environment `pypi`.
+   - npm: trusted publisher for package `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release-npm.yml`, environment
+     `npm`.
+2. Change `version` in `pyproject.toml`,
+   `src/polyglot_python/__init__.py` and `npm/package.json` together; the test
+   suite rejects drift.
+3. Publish a GitHub Release with tag `v<version>`. `release.yml` verifies the
+   tag, builds the sdist and wheel, and uploads them to PyPI; `release-npm.yml`
+   verifies the same version and publishes `npm/` to npm with provenance.
 
 ## License
 

{polyglot_python-0.2.0 → polyglot_python-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "polyglot-python"
-version = "0.2.0"
+version = "0.2.1"
 description = "Deterministic multilingual Python keyword transpiler: write Python in your own language."
 readme = "README.md"
 requires-python = ">=3.12"

{polyglot_python-0.2.0 → polyglot_python-0.2.1}/src/polyglot_python/__init__.py

@@ -10,7 +10,7 @@ from .translator import (
     translate,
 )
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 
 __all__ = [
     "Locale",

{polyglot_python-0.2.0 → polyglot_python-0.2.1/src/polyglot_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyglot-python
-Version: 0.2.0
+Version: 0.2.1
 Summary: Deterministic multilingual Python keyword transpiler: write Python in your own language.
 Author: Furox-Art
 License-Expression: MIT
@@ -37,15 +37,21 @@ syntax with your words.
 ## Install
 
 ```bash
-pip install polyglot-python   # after the first release
+pip install polyglot-python
 pip install -e .              # from source
 ```
 
-The first release is prepared but not yet on PyPI; install from source until it
-is published. Requires Python 3.12+. Python 3.10/3.11 are not supported because
+Requires Python 3.12+. Python 3.10/3.11 are not supported because
 their tokenizer splits Indic combining marks, so several Hindi keywords would
 not translate. No runtime dependencies.
 
+Node.js users can install the thin npm wrapper. It forwards every command to
+the Python CLI, so the Python package must be installed as well.
+
+```bash
+npm install -g polyglot-python
+```
+
 ## Quick start
 
 `examples/classify.tr`:
@@ -149,28 +155,33 @@ python -m venv .venv
 .venv/Scripts/python -m pytest -q --cov=polyglot_python --cov-fail-under=100
 ```
 
-The suite contains 119 tests with 100% statement coverage, including every
+The suite contains 120 tests with 100% statement coverage, including every
 keyword in both directions for all 9 locales, end-to-end CLI runs of every
-example, version consistency with the changelog, and byte-level determinism
-checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS at 3.12, enforces the
-100% coverage gate on Linux 3.12, translates every example twice on all three
-operating systems to compare bytes and line counts, and builds the wheel,
-installs it into a clean environment, and smoke-tests it. Dependabot keeps
-GitHub Actions and development dependencies current. A separate release
-workflow publishes tagged GitHub Releases to PyPI through Trusted Publishing.
+example, version consistency with the changelog and the npm wrapper, and
+byte-level determinism checks. CI runs Ubuntu 3.12-3.14 plus Windows and macOS
+at 3.12, enforces the 100% coverage gate on Linux 3.12, translates every
+example twice on all three operating systems to compare bytes and line counts,
+builds the wheel, installs it into a clean environment, and smoke-tests it,
+and runs the npm wrapper against the installed Python package. Dependabot keeps
+GitHub Actions and development dependencies current. Separate release workflows
+publish tagged GitHub Releases to PyPI and npm through Trusted Publishing.
 
 ## Releasing
 
-Publishing uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
-and stores no API token.
-
-1. On PyPI, add a pending publisher for project `polyglot-python`: owner
-   `Furox-Art`, repository `polyglot-python`, workflow `release.yml`,
-   environment `pypi`.
-2. Change `version` in `pyproject.toml` and
-   `src/polyglot_python/__init__.py` together; the test suite rejects drift.
-3. Publish a GitHub Release with tag `v<version>`. The release workflow verifies
-   the tag, builds the sdist and wheel, and uploads them to PyPI.
+Publishing uses Trusted Publishing for both registries and stores no API token.
+
+1. Configure the trusted publishers once:
+   - PyPI: publisher for project `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release.yml`, environment `pypi`.
+   - npm: trusted publisher for package `polyglot-python`: owner `Furox-Art`,
+     repository `polyglot-python`, workflow `release-npm.yml`, environment
+     `npm`.
+2. Change `version` in `pyproject.toml`,
+   `src/polyglot_python/__init__.py` and `npm/package.json` together; the test
+   suite rejects drift.
+3. Publish a GitHub Release with tag `v<version>`. `release.yml` verifies the
+   tag, builds the sdist and wheel, and uploads them to PyPI; `release-npm.yml`
+   verifies the same version and publishes `npm/` to npm with provenance.
 
 ## License
 

{polyglot_python-0.2.0 → polyglot_python-0.2.1}/tests/test_cli.py

@@ -6,6 +6,8 @@ from pathlib import Path
 
 import pytest
 
+import polyglot_python
+
 from polyglot_python.cli import _configure_console, main
 
 TR_PROGRAM = (
@@ -135,7 +137,7 @@ def test_version(capsys):
     with pytest.raises(SystemExit) as caught:
         main(["--version"])
     assert caught.value.code == 0
-    assert "polyglot-python 0.2.0" in capsys.readouterr().out
+    assert f"polyglot-python {polyglot_python.__version__}" in capsys.readouterr().out
 
 
 def test_run_token_error_is_localized(tmp_path, capsys):

{polyglot_python-0.2.0 → polyglot_python-0.2.1}/tests/test_metadata.py

@@ -1,3 +1,4 @@
+import json
 import tomllib
 from pathlib import Path
 
@@ -16,3 +17,12 @@ def test_version_matches_pyproject():
 def test_changelog_mentions_current_version():
     changelog = ROOT.joinpath("CHANGELOG.md").read_text(encoding="utf-8")
     assert f"## [{polyglot_python.__version__}]" in changelog
+
+
+def test_npm_wrapper_matches_version():
+    package = json.loads(ROOT.joinpath("npm", "package.json").read_text(encoding="utf-8"))
+    assert package["name"] == "polyglot-python"
+    assert package["version"] == polyglot_python.__version__
+    binary = ROOT.joinpath("npm", package["bin"]["polyglot-python"])
+    assert binary.is_file()
+    assert binary.read_text(encoding="utf-8").startswith("#!/usr/bin/env node\n")