revo-module-installer 0.2.0

CLI for installing RevoData modules

Revo Modules

Revo Modules is a CLI for discovering and installing module bundles from a registry.

Setup

Install the CLI with uv (recommended) or pip.

uv tool install revo-module-installer

pip install revo-module-installer

Usage

revo --help

Search and install a module interactively (the default command lists module names and descriptions, then installs the selected entry).

revo

List modules from the default registry repository.

revo modules list --show-description

Generate an install plan for a specific module ID.

revo modules install example-module

Write the plan to a specific path and skip writing files.

revo modules install example-module --plan-output ./plan.json --dry-run

By default the install plan is written under the user cache directory in revo-modules/plans/<module_id>.json. Use --plan-output to override the path or --dry-run to avoid writing the plan.

Registry sources

Registry URLs can point to:

• GitHub repositories, which are resolved to raw registry files.
• Direct HTTP(S) URLs to registry YAML files.
• Local files via file:// URLs or file paths.
• Bundled package examples via package://example_registry.yml.

Manifest URLs support the same URL forms. GitHub blob URLs are automatically converted to raw content URLs.

Local registry fallback for tests

For testing purposes, you can allow a fallback to the bundled example registry by setting the following environment variables:

export REVO_MODULES_ENV=test
export REVO_MODULES_ALLOW_LOCAL_REGISTRY_FALLBACK=1

The bundled registry entry points to package://example_manifest.yml, so the example manifest stays self-contained for offline testing.

Contributing

For contributor-focused guidelines, setup and development workflows, see CONTRIBUTING.md.