aislop for Python

Python launcher package for the aislop CLI.

This package is for Python and pipx users who want an aislop command from Python packaging tools. Node.js must be available on the machine.

It exposes:

• aislop
• aislop-mcp

Install

Private install while this repo is private:

pipx install git+ssh://git@github.com/scanaislop/aislop-py.git

Public install after publishing to PyPI:

pipx install aislop

Use

aislop scan
aislop fix
aislop ci
aislop-mcp

The launcher keeps the Python package small while exposing the same aislop commands.

Versioning Model

The Python package version should track the CLI version. For example, aislop==0.10.2 launches the 0.10.2 CLI.

Do not make a fixed PyPI release float to a newer CLI version automatically. A user who installs a fixed PyPI version expects that installed package to keep running the same CLI version until they upgrade it.

Users can run aislop upgrade to check whether a newer release is available.

Upgrade Users

Private git install:

pipx install --force git+ssh://git@github.com/scanaislop/aislop-py.git

Public PyPI install:

pipx upgrade aislop

Users can run aislop upgrade at any time to check whether a newer release is available.

Update The Launcher

Run this after a new aislop version is published:

scripts/update-version.sh 0.10.3

Then validate:

PYTHONPATH=src python3 -m unittest discover -s tests
python3 -m pip wheel . --wheel-dir dist
pipx install --force .
aislop --version

Commit and push:

git add pyproject.toml src/aislop_py tests
git commit -m "Update aislop launcher to 0.10.3"
git push

Publish To PyPI

Publishing is automated from GitHub Actions:

• test publishes to TestPyPI.
• develop does not publish.
• main publishes to PyPI.

See docs/publishing.md.

Troubleshooting

If the command exits with a Node.js tooling error, install Node.js first:

brew install node

If the wrong version runs, reinstall the launcher:

pipx install --force aislop

For private installs:

pipx install --force git+ssh://git@github.com/scanaislop/aislop-py.git