Skip to main content

xPack xpm v0.14.0 released

· 3 min read
Liviu Ionescu (ilg)
Liviu Ionescu (ilg)

Version 0.14.0 is a new major release; it separates xPack from npm dependencies.

xpm is a Node.js CLI application to automate builds and to manage xpm packages.

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

Changes​

The 0.14.0 release introduces a breaking change due to the separate dependencies, but this is handled by the compatibility policies.

Bug fixes​

  • [#149] in certain conditions, xpm list did not show local packages; fixed
  • [#148] the generated minimumXpmRequired might have pre-release parts; fixed

Enhancements​

  • [#143] separate xPack from npm dependencies (breaking change! see 0001 policy)
  • [#147] add default empty properties in package.json for init

Other changes​

  • none

Known problems​

  • [#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.14.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.

caution

The xpm tool is currently work in progress and should be used with caution.