truealter 0.1.0

Thin PyPI shim that invokes the ALTER CLI (installed separately via npm).

truealter

Python console-script shim for the ALTER CLI. The canonical ALTER CLI ships from @truealter/cli on npm. This package exists as a fourth install channel for pip-centric users.

Install

pip install truealter

After installation, truealter is on your PATH. The first time you run it, it execs the alter binary from npm — so you need that installed too:

npm install -g @truealter/cli

With both installed, truealter <args> is equivalent to alter <args>.

Why a shim?

The CLI itself is a Node.js project (see @truealter/cli on npm). We publish a thin Python shim so that:

• pip install users on systems without a global npm setup get a discoverable entry point and helpful install guidance.
• CI images that only have Python tooling can install a placeholder that prints a clear, actionable error rather than "command not found".
• The truealter PyPI name is reserved for this ecosystem and cannot be squatted later.

If the canonical node-side CLI isn't on your PATH, truealter prints install instructions and exits with status 127. It never silently runs a half-working re-implementation of the real CLI.

Related packages

• @truealter/cli on npm — the canonical CLI
• alter-runtime on PyPI — the ALTER identity daemon (separate, runs alongside; this shim is a sibling package in the same repo)

Licence

Apache-2.0. See LICENSE at the repo root.