Command line interface for simplifying the process of bulk updating dependencies across multiple Lerna packages.
$ yarn add --dev lerna-update-wizard
Or via NPM:
$ npm install --save-dev lerna-update-wizard
If installed globally, it can be used independently on any project:
$ yarn global add lerna-update-wizard
Simply run the lernaupdate
command in the root of a Lerna-based project:
$ lernaupdate
Or from the outside by specifying the path to the project:
$ lernaupdate ~/projects/my-lerna-project
- Search for and select the dependency to upgrade
- Select the packages in which you wish to perform the upgrade
- Pick the desired version to be installed for the dependency
- Enter the name of a dependency not already in your project
- Select the packages in which to add the dependency
- Pick the desired version to be installed for the dependency
- When prompted, specify dependency type for each package (normal/dev/peer)
- Run the command with the
--dedupe
option - Only dependencies installed with 2 or more differing versions will be presented
- Complete the flow like normal (described above)
-
After installation, choose whether or not you'd like to generate a Git branch for your changes
-
Then choose whether or not you'd like to make a separate Git commit for your changes.
A nice commit message with details about the update version range for each affected package will be generated for you.
The script can run without prompting you for input. Simply specify the --non-interactive
flag:
$ lernaupdate --non-interactive --dependency [email protected] ./my-project
The script will tell you if you need to specify any additional input flags based on the state of your mono repo.
For instance, you might need/wish to include information about which packages to affect and which type of installation to perform if the dependency is a first-time install:
$ lernaupdate --non-interactive \
--dependency [email protected] \
--packages packages/utils,packages/tools \
--new-installs-mode dev \
./my-project
Note: Git features are not available for --non-interactive
mode.
Lerna Update Wizard will automatically detect the package manager used for each package and use the appropriate one for installing the dependency.
Note: If the project root directory contains a yarn.lock
file, Yarn will be used to install all packages, in order to support Yarn Workspaces.
When using Yarn Workspaces for your mono-repo, only a single installation is required in the top-level directory after changing a dependency in the package.json file for one or more sub-packages.
To achieve this single "lazy" install, which can significantly speed up the install duration, you can specify the --lazy
flag.
If not specified, you will be prompted with the option to enable it at runtime, whenever use of Yarn Workspaces is detected (unless in non-interactive mode).
Lerna Update Wizard takes Lerna's packages
config parameter into account if specified in lerna.json. This means that if you have your packages located in a directory other than packages/
, this tool will still work, as long as their parent directory is specified.