Version 0.11.0 is a new release; it improves the install logic and fixes some bugs.

xpm is a Node.js CLI application to manage xPacks dependencies.

Install

xpm is a Node.js module that can be installed with npm.

For the prerequisites, since it is recommended to use a version manager or to customize the npm install location, please read the Install page for more details.

To install the latest stable version available, use:

npm uninstall --global xpm
npm install --global xpm@latest

To install this specific version, use:

xpm install --global xpm@0.11.0

Changes

The 0.11.0 release is generally compatible with previous releases.

The main change is the bundling of dependencies to avoid the deprecation warnings during install.

Bug fixes

  • [#124] the logic used to list packages failed to identify scoped npm packages, which required going an extra level down in the folder hierarchy; fixed;
  • [#119] when installing npm dependencies, only the top package must be installed, and a recursive search should not be performed; fixed;
  • [#120] in certain conditions, xpm list failed with exceptions; fixed;

Enhancements

  • [#123] for consistency reasons, accept -32 as an alias for --force-32bit in xpm install;
  • [#122] the logic used by xpm install to install all dependencies included the dependencies for all build configurations, which was inefficient for large projects; the behaviour was reverted to install only the package dependencies; to install all dependencies, use --all-configs;

Other changes

  • [#121] for a better compatibility when satisfying dependencies for the npm packages, the logic used by xpm install now invokes npm install first and later installs the xPacks;

Known problems

  • [#125] this release introduced a regression affecting some of the xpm install --config use cases; fixed in v0.11.1;
  • [#57] when multiple versions of the same package are referenced via different dependencies paths, the program fails; version mitigation will be implemented in a future release.

Documentation

The program interprets --help and displays a top help page:

% xpm --help

The xPack project manager command line tool
Usage: xpm <command> [<subcommand>...] [<options> ...] [<args>...]

where <command> is one of:
  init, install, link, list, run, uninstall

Common options:
  --loglevel <level>     Set log level (silent|warn|info|verbose|debug|trace)
  -s|--silent            Disable all messages (--loglevel silent)
  -q|--quiet             Mostly quiet, warnings and errors (--loglevel warn)
  --informative          Informative (--loglevel info)
  -v|--verbose           Verbose (--loglevel verbose)
  -d|--debug             Debug messages (--loglevel debug)
  -dd|--trace            Trace messages (--loglevel trace, -d -d)
  --no-update-notifier   Skip check for a more recent version
  -C <folder>            Set current folder

xpm -h|--help            Quick help
xpm <command> -h|--help  Quick help on command
xpm --version            Show version
xpm -i|--interactive     Enter interactive mode

npm xpm@0.11.0 '/Users/ilg/.nvm/versions/node/v14.16.0/lib/node_modules/xpm'
Home page: <https://xpack.github.io/xpm/>
Bug reports: <https://github.com/xpack/xpm-js/issues/>

Similar pages are available for each command.

For more details, the project documentation is available online from the web site.

Supported platforms

npm is a portable application that can run on Windows, macOS and GNU/Linux, both Intel and Arm.

CI tests

Continuous integration tests are done via GitHub Actions.

Download analytics

  • npmjs.com xpm
    • last week npm
    • all time npm

Credit to Shields IO for the badges.