realm 0.4.1

A tool for managing python poetry projects

Realm

realm is a CLI tool written in Python aimed at simplifying the development and maintenance of multiple Python projects within the same repository with a particular focus on projects structured using Poetry.

Features

• Poetry Integration: realm is built to manage projects that use poetry. Therefore, each project within the repository should have a pyproject.toml file.

• Dependency Management: realm scans the pyproject.toml files to identify local path dependencies managed within the repository. If a project depends on a library, changes to that library will be considered when determining affected projects.

Commands

• realm init: Initializes a new realm repository.
• realm install: Executes poetry install on all projects.
• realm ls: Lists all projects managed by realm.
• realm run: Executes a command on all projects.
• realm task: Runs a poetry task on projects containing that task (requires poethepoet).

Filtering

You can apply filters to affect only specific projects. For example, to install only changed projects:

$ realm install --since origin/master

Available filters:

• --since - Includes only projects changed since the specified reference.
• --scope - Includes only projects that match the given pattern.
• --ignore - Excludes projects that match the given pattern.
• --match - Filters projects by a field specified in the pyproject.toml file.

Documentation

For more information on available commands and usage, refer to the documentation.

Contribution

Contributions to realm are welcome! If you encounter any issues or have suggestions for improvements, please open an issue.