Metadata-Version: 2.1
Name: realm
Version: 0.1.0a1
Summary: A tool for managing python poetry projects
Home-page: https://github.com/orlevii/realm
License: MIT
Keywords: monorepo,realm
Author: Or Levi
Author-email: orlevi128@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries
Provides-Extra: tasks
Requires-Dist: click (>=7.0.0,<8.0.0)
Requires-Dist: colorama (>=0.4.4,<0.5.0)
Requires-Dist: poethepoet (>=0.9.0,<0.10.0); extra == "tasks"
Requires-Dist: toml (>=0.10.2,<0.11.0)
Project-URL: Documentation, https://github.com/orlevii/realm
Project-URL: Repository, https://github.com/orlevii/realm
Description-Content-Type: text/markdown

## Realm
Realm is tool for managing multiple poetry projects in the same git repository.

This project is inspired by the `lerna` project available for JavaScript

[![Build Status](https://github.com/orlevii/realm/workflows/build/badge.svg?branch=master&event=push)](https://github.com/orlevii/realm/actions/workflows/build.yml?query=branch%3Amaster)

### Requirements
In order to start using realm, you first need to have [poetry](https://github.com/python-poetry/poetry) installed

### Commands
* <code>realm init</code> - Initializes a new realm repo
* <code>realm install</code> - Executes `poetry install` on all projects
* <code>realm ls</code> - Prints all projects managed
* <code>realm run</code> - Executes a command on all projects
* <code>realm task</code> - Runs a poe task on all projects containing this task (requires poethepoet)

#### Filtering
You can set up filters to affect only certain projects

For example, you can install only changed projects 
```bash
$ realm install --since origin/master
```

Available filters:
* <code>--since</code> - Includes only projects changed since the specified ref
* <code>--scope</code> - Includes only projects that match the given pattern
* <code>--ignore</code> - Filters out projects that match the given pattern
* <code>--match</code> - Filters by a field specified in `pyproject.toml`

