No project description provided
Project description
Monorepo Factory
Monorepo Factory is a command-line tool designed to streamline the process of setting up repositories and submodules based on a TOML configuration file. It automates the creation of monorepos, allowing you to define complex repository structures in a simple and declarative manner.
Features
- Automated Repository Creation: Generate multiple repositories with predefined settings.
- Submodule Support: Easily configure and include submodules within your repositories.
- Pattern Matching: Apply patterns to match and configure repositories dynamically.
- Customizable Initialization: Initialize repositories with custom READMEs and other initial files.
Installation
Monorepo Factory can be installed using pipx
, which allows you to run Python applications in isolated environments. To install pipx
and Monorepo Factory, follow these steps:
# Install pipx if it's not already installed
python3 -m pip install --user pipx
python3 -m pipx ensurepath
# Install Monorepo Factory using pipx
pipx install monorepo-factory
Usage
To use Monorepo Factory, you need to have a TOML configuration file that defines the structure of your repositories and any patterns or submodules you want to include.
# Run Monorepo Factory with the path to your TOML configuration file
monorepo_factory PATH_TO_TOML_FILE
For detailed usage instructions, you can use the --help
flag:
$ poetry run python monorepo_factory --help
Usage: monorepo_factory [OPTIONS] TOML_FILE
Main function to set up repositories and submodules from a TOML configuration file.
╭─ Arguments ────────────────────────────────────────────╮
│ * toml_file TEXT [default: None] [required] │
╰────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰────────────────────────────────────────────────────────╯
Configuration
Your TOML configuration file should define the repositories, submodules, and any patterns that you want to apply. Here's an example structure of what the TOML file might look like:
# Define repositories and their properties
[[repo]]
name = "main-repo"
description = "This is the main repository."
# Define submodules for a repository
[[repo.subrepos]]
name = "submodule-1"
path = "libs/submodule-1"
# Define patterns to apply settings to repositories matching a pattern
[[pattern]]
pattern = "service-"
description = "Services repository pattern."
Contributing
Contributions to Monorepo Factory are welcome! Please read the CONTRIBUTING.md
file for guidelines on how to contribute to this project.
License
Monorepo Factory is released under the MIT License. See the LICENSE
file for more information.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for monorepo_factory-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91472dcc4aee147016179c85fa5b846f6838c3ef116aecfaae7a7ee3fd2ded4c |
|
MD5 | 36f38985b80d5691c6c3cca140df4493 |
|
BLAKE2b-256 | 2c59ed7c01b7d94fd4a4795954f7db74a207d710b0139da7c8d82c28f295e068 |