taylorono/buildpacks-pnpm

Buildpack for Pnpm

The Pnpm CNB provides the Pnpm Package manager. The buildpack installs pnpm onto the $PATH which makes it available for subsequent buildpacks and/or in the final running container. An example of buildpack that might use pnpm is the Pnpm Install CNB

Integration

The Pnpm CNB provides pnpm as dependency. Downstream buildpacks, like Pnpm Install CNB can require the pnpm dependency by generating a Build Plan TOML file that looks like the following:

[[requires]]
  name = "pnpm"

  # The Pnpm buildpack supports some non-required metadata options.
  [requires.metadata]

    # The version of the Pnpm dependency is not required. In the case it
    # is not specified, the buildpack will provide the default version, which can
    # be seen in the buildpack.toml file.
    # If you wish to request a specific version, the buildpack supports
    # specifying a semver constraint in the form of "8.*", "8.15.*", or even
    # "8.15.3".
    version = "8.15.3"

    # Setting the build flag to true will ensure that the pnpm
    # depdendency is available on the $PATH for subsequent buildpacks during
    # their build phase. If you are writing a buildpack that needs to run pnpm
    # during its build process, this flag should be set to true.
    build = true

    # Setting the launch flag to true will ensure that the pnpm
    # dependency is available on the $PATH for the running application. If you are
    # writing an application that needs to run pnpm at runtime, this flag should
    # be set to true.
    launch = true

Usage

To package this buildpack for consumption:

$ ./scripts/package.sh --version <version-number>

This will create a buildpackage.cnb file under the build directory which you can use to build your app as follows:

pack build <app-name> \
  --path <path-to-app> \
  --buildpack <path/to/node-engine.cnb> \
  --buildpack build/buildpackage.cnb \
  --buildpack <path/to/cnb-that-requires-node-and-pnpm>

Though the API of this buildpack does not require node, pnpm is unusable without node.

Run Tests

To run all unit tests, run:

./scripts/unit.sh

To run all integration tests, run:

/scripts/integration.sh