piral-cli-dotenv

Plugin for the piral-cli. Adds a flag to include environment variables from .env files.

Extends the Piral CLI command options to include dotenv files.

Installation

Install the plugin either locally or globally.

We recommend the local installation:

1npm i piral-cli-dotenv --save-dev

Usage

Including a .env File

Some commands of the Piral CLI will be extended with --env flags, e.g.,

1piral debug <regular options> --env

The list of supported / extended commands is:

• build-piral
• debug-piral
• validate-piral
• build-pilet
• debug-pilet
• publish-pilet
• validate-pilet

The --env flags behave as follows.

No argument

Standard dotenv resolution mechanism, e.g., takes a .env file if available.

Example Call:

1piral build <regular options> --env

File path

Uses the path to resolve and use the file as dotenv input.

Example input:

1./secrets/.env

Example call:

1piral build <regular options> --env .env.prod

Name

Uses a file {name}.env or .env.{name} as input for dotenv.

Example input:

1prod

Example call:

1piral build <regular options> --env prod

Variables

Uses the provided values as environment variables.

Example inputs:

1FOO=BAR
2FOO="BAR";BAR="FOO"

Example call:

1piral build <regular options> --env SERVICE_URL="http://example.com"

FAQ

Does it work with every bundler?

It should. It was tested with piral-cli-webpack5 only. The piral-cli-parcel2 bundler is presumably not working as they treat environment variables differently. Other bundlers are not tested.

Are some environment variables overwritten?

Yes. Some variables are special (e.g., NODE_ENV) and will be set by the piral-cli anyway. This plugin focuses on non-special variables.

License

This plugin is released using the MIT license. For more information see the LICENSE file.