@lerna/list

What is @lerna/list?

@lerna/list is a part of the Lerna monorepo management toolset. It is used to list all the packages in a Lerna-managed monorepo. This can be useful for various tasks such as auditing, documentation, and automation scripts.

What are @lerna/list's main functionalities?

List all packages

This feature allows you to list all the packages in your Lerna-managed monorepo. The code sample demonstrates how to use the `list` function to retrieve and print the list of packages.

const { list } = require('@lerna/list');
list().then(packages => console.log(packages));

List packages with specific attributes

This feature allows you to filter the list of packages based on specific attributes such as scope. The code sample demonstrates how to list packages that match a specific scope.

const { list } = require('@lerna/list');
list({ scope: '@my-scope/*' }).then(packages => console.log(packages));

List private packages

This feature allows you to list only the private packages in your monorepo. The code sample demonstrates how to list packages that are marked as private.

const { list } = require('@lerna/list');
list({ private: true }).then(packages => console.log(packages));

Other packages similar to @lerna/list

lerna

Lerna is a tool for managing JavaScript projects with multiple packages. It offers a broader range of functionalities compared to @lerna/list, including versioning, publishing, and dependency management.

pnpm

pnpm is a fast, disk space-efficient package manager. It also supports monorepos and offers functionalities similar to Lerna, such as linking local packages and managing dependencies.

README

@lerna/list

List local packages

Usage

The list subcommand is aliased to several convenient shorthands (similar to npm ls):

• lerna ls: Identical to lerna list, which is itself analogous to the ls command
• lerna ll: Equivalent to lerna ls -l, showing long output
• lerna la: Equivalent to lerna ls -la, showing all packages (including private ones)

$ lerna ls
package-1
package-2

You might notice extra logging from lerna when running these commands in your shell. Rest assured they will not infect your piped incantations, as all logs are emitted to stderr, not stdout.

In any case, you can always pass --loglevel silent to create pristine chains of magical shell wizardry.

Options

• --json
• -a, --all
• -l, --long
• -p, --parseable

lerna ls also respects all available Filter Flags.

--json

Show information as a JSON array.

$ lerna ls --json
[
  {
    "name": "package-1",
    "version": "1.0.0",
    "private": false,
    "location": "/path/to/packages/pkg-1"
  },
  {
    "name": "package-2",
    "version": "1.0.0",
    "private": false,
    "location": "/path/to/packages/pkg-2"
  }
]

Tip: Pipe to the json utility to pick out individual properties:

$ lerna ls --json --all | json -a -c 'this.private === true' name
package-3

--all

Alias: -a

Show private packages that are hidden by default.

$ lerna ls --all
package-1
package-2
package-3 (private)

--long

Alias: -l

Show extended information.

$ lerna ls --long
package-1 v1.0.1 packages/pkg-1
package-2 v1.0.2 packages/pkg-2

$ lerna ls -la
package-1 v1.0.1 packages/pkg-1
package-2 v1.0.2 packages/pkg-2
package-3 v1.0.3 packages/pkg-3 (private)

--parseable

Alias: -p

Show parseable output instead of columnified view.

By default, each line of the output is an absolute path to a package.

In --long output, each line is a :-separated list: <fullpath>:<name>:<version>[:flags..]

$ lerna ls --parseable
/path/to/packages/pkg-1
/path/to/packages/pkg-2

$ lerna ls -pl
/path/to/packages/pkg-1:package-1:1.0.1
/path/to/packages/pkg-2:package-2:1.0.2

$ lerna ls -pla
/path/to/packages/pkg-1:package-1:1.0.1
/path/to/packages/pkg-2:package-2:1.0.2
/path/to/packages/pkg-3:package-3:1.0.3:PRIVATE

Changelog

3.5.0 (2018-11-27)

Bug Fixes

• conventional-commits: Bump minimum dependency ranges for node v11 compat (76fad65)
• prettier (001a6df)
• Update yarn workspaces error prompt link (#1756) (d6e6a42)
• publish: Ignore non-release tags when detecting from-git (#1782) (3cb7465)
• version: Add friendly error message when remote branch doesn't exist (#1741) (cd34b48)
• version: Don't version private packages lacking a version field (#1654) (578bb19)

Features

• publish: Add option --no-git-reset to leave unstaged changes in working tree (#1791) (eae5619)
• run: Log package name and timing in runScriptInPackageCapturing (#1781) (b69a728)
• version: Add --include-merged-tags option (#1712) (7ee05d7)