yarn-plugin-envs v0.0.3

TL;DR

Yarn 2 only supports those env variables (see official doc)

• npm_package_name
• npm_package_version
• npm_execpath
• npm_config_user_agent
• npm_node_execpath
• npm_lifecycle_event

But they use to support many more when running scripts.

This plugin aims to add them.

Install

If you're using yarn berry (yarn 2 and more), you can run:

yarn plugin import https://raw.githubusercontent.com/Ayc0/yarn-plugin-envs/v0.0.3/src/index.js to install it.

Supported env variables

Fields in package.json

All fields (except exceptions) present in the package.json will be available, in a serialized way.

For instance, if you have this package.json:

{
  "name": "hello",
  "version": "1.2.3",
  "keywords": ["roses", "are", "red"],
  "scripts": {
    "hello": "world"
  }
}

will generates those env vars:

npm_package_name=hello
npm_package_version=1.2.3
npm_package_keywords_0=roses
npm_package_keywords_1=are
npm_package_keywords_2=red
npm_package_scripts_hello=world

(note: all values will be converted to strings)

Exceptions

Global NPM vars

We don't want to get the default global NPM configs, So, we won't inject env like npm_config_version_git_tag, or npm_config_version_tag_prefix, or npm_config_init_license for instance.

Runtime specific vars

In yarn 1, yarn was generating mappings and making them available as env vars. But we don't want to support those.

For instance if you were running yarn hello, yarn was injecting:

npm_config_argv='{"remain":[],"cooked":["run","hello"],"original":["hello"]}'

As we don't see the point of those, we decided to not supporting them.

Complicated fields

In the package.json, some fields can be written in multiple ways.

For instance, you can write:

{
  "author": "Ayc0 <ayc0.benj@gmail.com>",
  "author": {
    "name": "Ayc0",
    "email": "ayc0.benj@gmail.com"
  }
}

As we don't want to include complex text parsers and keep this plugin as simple as possible, we won't support neither author, nor contributors, nor repository nor funding (different syntax but same idea).

Vars based on files

In addition to having multiple string patterns in the package.json, the license could also be defined based on a LICENSE file present alongside the package.json.

As said before, we want to keep this plugin as simple as possible, so if we don't support string patterns, we won't check for files present on the disk.

So we won't support npm_package_license nor npm_package_readmeFilename (even if they are written in the package.json)

Complete list

• npm_config_version_git_tag
• npm_config_registry
• npm_config_python
• npm_config_ignore_scripts
• npm_config_ignore_optional
• npm_config_init_license
• npm_config_strict_ssl
• npm_config_save_prefix
• npm_config_user_agent
• npm_config_version_git_sign
• npm_node_execpath
• npm_execpath
• npm_config_email
• npm_config_username
• npm_config_version_git_message
• npm_config_version_tag_prefix
• npm_config_version_commit_hooks
• npm_config_bin_links
• npm_config_init_version

• npm_config_argv

• npm_package_repository_*
• npm_package_author_*
• npm_package_contributors_*
• npm_package_funding_*

• npm_package_readmeFilename
• npm_package_license