lerna-update-wizard

by Anifacted

A command line tool for bulk-updating lerna package dependencies

157 Stars 16 Forks Last release: Not found 194 Commits 43 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Lerna Update Wizard

Command line interface for simplifying the process of bulk updating dependencies across multiple Lerna or Yarn Workspace packages.

Install

$ 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

Usage

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

Or run it using npx

$ npx lerna-update-wizard

Features

Update dependencies across packages

  1. Search for and select the dependency to upgrade
  2. Select the packages in which you wish to perform the upgrade
  3. Pick the desired version to be installed for the dependency

Update dependency

Add new dependencies across packages

  1. Enter the name of a dependency not already in your project
  2. Select the packages in which to add the dependency
  3. Pick the desired version to be installed for the dependency
  4. When prompted, specify dependency type for each package (normal/dev/peer)

Add packages

Deduplicate dependencies across packages

  1. Run the command with the
    --dedupe
    option
  2. Only dependencies installed with 2 or more differing versions will be presented
  3. Complete the flow like normal (described above)

Deduplicate packages

Add/Update multiple dependencies in one session

You can batch updates for multiple dependencies into one session. Choose

+ Add another
after you've specified the details for the first update task.

Add packages

Note: Currently not supported in

--noninteractive
mode.

Auto-generate Git branch & commit

  1. After installation, choose whether or not you'd like to generate a Git branch for your changes
  2. 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.

Git

Non-interactive mode

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.

Yarn support

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.

NPM

NPM install

Yarn

Yarn install

Yarn Workspaces & lazy installation

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).

Notes

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.