contao / monorepo-tools
Contao Monorepo Tools
Fund package maintenance!
to.contao.org/donate
Installs: 68 642
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 5
Forks: 3
Open Issues: 0
Requires
- php: ^8.1
- ext-json: *
- ext-zlib: *
- composer/semver: ^3.2
- phpspec/php-diff: ^1.0
- symfony/config: ^5.4 || ^6.4 || ^7.0
- symfony/console: ^5.4 || ^6.4 || ^7.0
- symfony/filesystem: ^5.4 || ^6.4 || ^7.0
- symfony/process: ^5.4 || ^6.4 || ^7.0
- symfony/yaml: ^5.4 || ^6.4 || ^7.0
Requires (Dev)
- ausi/remote-git: ^0.2.5
- contao/code-quality: ^1.0
- phpstan/phpstan: ^1.0
- phpstan/phpstan-symfony: ^1.0
- phpunit/phpunit: ^9.5
Conflicts
- composer/semver: 3.2.8
This package is auto-updated.
Last update: 2024-10-13 16:24:45 UTC
README
This project provides tools to work with a monorepo. The main usage is continuously splitting up a monorepo of a PHP project into multiple read-only splits for every commit, branch and tag. It also provides a command that can merge the composer.json files of the splits into a single composer.json file for the root directory to make it possible to install the monorepo itself as a replacement of the single packages.
There is also a merger available that can be used to merge multiple projects into one monorepo as a one-time process, but it is still experimental and should be used with caution.
Installation
composer require --dev contao/monorepo-tools
Usage
How the tools are used in action can be seen in the monorepo.yml and .github/workflows/ci.yml files of the project Contao.
Split command
vendor/bin/monorepo-tools split [--force-push] [<branch-or-tag>]
Splits the monorepo into repositories by subfolder as configured in the monorepo.yml file and pushes the results to the configured remotes.
Composer-json command
vendor/bin/monorepo-tools composer-json [--validate]
Updates (or validates) the root composer.json file to include a union of all settings from the splits. The autoload configuration gets rewritten to include the correct path to the right subfolder. Version constraints for requirements and conflicts get merged using intersections and unions.
Merge command
Merges multiple repositories into one monorepo. This is intended to be a one-time process, and most probably needs some fine-tuning. The biggest benefit of using it is that it’s reversible, meaning that after splitting the monorepo back the splits commit history of the past is kept untouched.
Feel free to contact me (@ausi
) on the Contao Slack workspace
if you consider using it for your project.
Configuration
The configuration is stored in a monorepo.yml file in the root of your monorepo project.
# URL or absolute path to the remote GIT repository of the monorepo monorepo_url: https://github.com/YOUR-VENDORNAME/YOUR-PROJECT.git # All branches that match this regular expression will be split by default branch_filter: /^(main|develop|\d+\.\d+)$/ # List of all split projects repositories: # The first split project living in the folder /first-subfolder first-subfolder: # URL or absolute path to the remote GIT repository url: https://github.com/YOUR-VENDORNAME/YOUR-FIRST-SPLIT-PROJECT.git # Second split project living in the folder /second-subfolder second-subfolder: # URL or absolute path to the remote GIT repository url: https://github.com/YOUR-VENDORNAME/YOUR-SECOND-SPLIT-PROJECT.git # Optional mapping of commit hashes between the monorepo and split repo # This is only relevant to projects that got merged from existing split repos in the past mapping: # <commit-hash-in-the-monorepo>: <commit-hash-in-the-split> 86f7e437faa5a7fce15d1ddcb9eaeaea377667b8: e9d71f5ee7c92d6dc9e92ffdad17b8bd49418f98 # Optional additional composer settings for the root composer.json composer: require-dev: contao/monorepo-tools: ^1.0 require: vendor/package: ^1.2.3 conflict: vendor/package: ^1.2.3