esysrepo-ctl

Control-plane tool for installing, updating, diagnosing, and managing the native esysrepo CLI (distributed via Conan). Distributed as a Python package on PyPI.

Native repository operations use esysrepo / erepo (from the Conan package). This tool only manages the lifecycle of that native CLI.

Install

pipx install esysrepo-ctl

Or from a development checkout:

python -m pip install -e ".[dev]"

Both esysrepo-ctl and erepo-ctl are equivalent entry points.

Then install the native CLI (first run bootstraps a Python env + Conan 2 per ADR-0008):

# Interactive: detect mode, confirm, persist
esysrepo-ctl install

# Non-interactive installer-like (managed home venv + always-on wrappers)
esysrepo-ctl install --mode managed --yes

# Project-private: activate your venv first, then:
esysrepo-ctl install --mode project --yes

Overrides: ESYSREPO_CTL_MODE, ESYSREPO_CTL_YES=1, --reconfigure (ignore persisted mode). Choice is persisted under ESYSREPO_CTL_HOME / platform data dir (config.json).

Commands

esysrepo-ctl --help
esysrepo-ctl --version
esysrepo-ctl version
esysrepo-ctl doctor
esysrepo-ctl install
esysrepo-ctl install --mode managed --yes
esysrepo-ctl install --mode project --yes --reconfigure
esysrepo-ctl install --version 0.2.4
esysrepo-ctl install --linkage shared   # thin shared esysrepo-cli + DLLs/.so
esysrepo-ctl install --channel center   # unnamed Conan Center-style refs
esysrepo-ctl list --dev                 # develop ships on @libesys/testing
esysrepo-ctl list
esysrepo-ctl list --linkage shared
esysrepo-ctl list --all-linkages
esysrepo-ctl update
esysrepo-ctl remove

Native CLI package (ADR-0009)

Installs pick one Conan application name. Wrappers stay esysrepo / erepo.

Until esysrepo-cli-static exists on Artifactory for that version/os/arch, the default install fails (hint: --linkage shared or wait for the static-exe Conan ship). ctl does not fall back to shared. Switching linkage can leave the other package in the Conan cache until you remove it with the same --linkage.

Conan channel (ADR-0007)

By default, package refs use LibESys Artifactory identity:

esysrepo-cli-static/<version>@libesys/stable

Configure the LibESys Conan remote yourself (or via CI vars CONAN_REMOTE_URL / CONAN_LOGIN_USERNAME / CONAN_PASSWORD). Install writes VirtualBuildEnv + VirtualRunEnv under the managed data dir and places wrappers per mode (above); doctor / discovery look at PATH, project Scripts/bin, and the managed bin.

Strict mode / no auto-bootstrap

By default, eligible commands (currently update) may auto-install the native CLI when it is missing (ADR-0005). Disable that with:

esysrepo-ctl --no-bootstrap update
# or
esysrepo-ctl --strict update

Auto-bootstrap is also disabled when any of these are set:

• CI=true (typical CI environments)
• ESYSREPO_CTL_NO_BOOTSTRAP=1
• ESYSREPO_CTL_STRICT=1

Explicit install / list / remove / doctor never trigger implicit native CLI install. version / update may auto-bootstrap when allowed.

Exit codes

Stable codes for scripting (ADR-0006):

Errors print to stderr as error: … with optional hint: … remediation lines.

Troubleshooting

esysrepo-ctl doctor
esysrepo-ctl version

Documentation

• Architecture overview
• CLI specification
• Quality requirements
• ADRs
• MVP implementation plan

Development

python scripts/setup-dev.sh   # or scripts/setup-dev.ps1 on Windows
pytest
pre-commit run --all-files