Anthology

Anthology is a command-line tool designed to streamline common tasks in Poetry based mono-repos. It provides commands for installing dependencies, running scripts, and managing project versions.

Installation

To install Anthology, use poetry:

poetry self add anthology

Usage

Anthology provides several commands to manage Anthology projects:

poetry anthology install [dir]

This command installs sub-packages defined in the Anthology project. It reads the Anthology configuration, updates package sources, locks sub-packages, generates the meta pyproject.toml document, and installs dependencies.

poetry anthology run [script_name] [args]

This command runs scripts defined in the Anthology project. It reads the Anthology configuration, locates the package directory, retrieves the scripts defined in the Anthology configuration for the target, and executes the specified script using subprocess.

poetry anthology version [args]

This command manages versioning within the Anthology project. It reads the Anthology configuration, executes 'poetry version' command in each of the sub-packages, updates package sources, locks sub-packages, extracts the version of the sub-package, and generates the meta pyproject.toml document with the updated version.

Examples

To install sub-packages in the current directory:

poetry anthology install

To run a script named 'build' in the Anthology project:

poetry anthology run build

To update the version of sub-packages in the Anthology project:

poetry anthology version