1 unstable release
0.1.0 | Feb 1, 2019 |
---|
#62 in #monorepo
14KB
287 lines
MORP
morp
is a command line that provides utilities for working with javascript monorepos.
Installation
- Install rustup to have a working rust environment.
- Run
cargo install morp
You may need to add the Cargo bins install directory to your $PATH
to be able to run morp
.
Prerequisites
- The packages of your monorepo must be in a
packages
directory located at the root of the monorepo. - The
name
key in thepackage.json
file of your packages must match the name of the package directory inpackages
monorepo
├── package.json
├── packages
│ ├── foo
│ │ ├── package.json -> `name` key must be `foo`
│ │ └── ...
│ └── ...
└── ...
Subcommands
morp graph
This command outputs a graph of the interdependencies between the monorepo packages.
options
--path -p
path of the monorepo
morp diff
Print the name of the changed packages compared to a branch, taking into account dependent packages.
Let's say you have 3 packages, A
, B
and C
. Package B
depends on A
and package C
doesn't depend on anything.
If you make a change in package A
, then morp diff
will output this:
A
B
This can be useful for CI purposes, if you want to trigger jobs depending on changed packages.
This command works by first looking for a common ancestor between HEAD
and the branch you specified (or develop
by default).
Once we have this common ancestor (ca
), we check which packages changed between ca
and HEAD
and the packages depending on these.
options
--path -p
path of the monorepo
--branch -b
branch to use as a reference for changed packages
--prefix
add a prefix to each package in the packages output
Dependencies
~17MB
~363K SLoC