@feki.de/semantic-release-yarn v1.0.1
@feki.de/semantic-release-yarn
Forked from
@semantic-release/npm
semantic-release plugin to publish a npm package using the yarn package manager.
| Step | Description |
|---|---|
verifyConditions | Verify the presence of the NPM_TOKEN environment variable, or an .npmrc file, and verify the authentication method is valid. |
prepare | Update the package.json version and create the npm package tarball. |
addChannel | Add a release to a dist-tag. |
publish | Publish the npm package to the registry. |
When to use
The prepare step of @semantic-release/npm executes npm install which might result in the following two issues:
- Unwanted package versions used for build since
yarn.lockis not used - Errors when installing packages that do not occur with
yarn - Allows usage of yarn
workspaces(In combination with multi-semantic-release)
Install
$ npm install @feki.de/semantic-release-yarn -DUsage
The plugin can be configured in the semantic-release configuration file:
{
"plugins": [
"@semantic-release/commit-analyzer",
"@semantic-release/release-notes-generator",
"@feki.de/semantic-release-yarn",
]
}Configuration
Npm registry authentication
The npm authentication configuration is required and can be set via environment variables.
Both the token and the legacy (username, password and email) authentication are supported. It is recommended to use the token authentication. The legacy authentication is supported as the alternative npm registries Artifactory and npm-registry-couchapp only supports that form of authentication.
Notes:
- Only the
auth-onlylevel of npm two-factor authentication is supported, semantic-release will not work with the defaultauth-and-writeslevel. - The presence of an
.npmrcor.yarnrcfile will override any specified environment variables.
Environment variables
| Variable | Description |
|---|---|
NPM_TOKEN | Npm token created via npm token create |
NPM_USERNAME | Npm username created via npm adduser or on npmjs.com |
NPM_PASSWORD | Password of the npm user. |
NPM_EMAIL | Email address associated with the npm user |
NPM_CONFIG_USERCONFIG | Path to non-default .npmrc file |
Use either NPM_TOKEN for token authentication or NPM_USERNAME, NPM_PASSWORD and NPM_EMAIL for legacy authentication
Options
| Options | Description | Default |
|---|---|---|
npmPublish | Whether to publish the npm package to the registry. If false the package.json version will still be updated. | false if the package.json private property is true, true otherwise. |
pkgRoot | Directory path to publish. | . |
tarballDir | Directory path in which to write the package tarball. If false the tarball is not be kept on the file system. | false |
Note: The pkgRoot directory must contain a package.json. The version will be updated only in the package.json and npm-shrinkwrap.json within the pkgRoot directory.
Note: If you use a shareable configuration that defines one of these options you can set it to false in your semantic-release configuration in order to use the default value.
Npm configuration
The plugin uses the npm CLI which will read the configuration from .npmrc. See npm config for the option list.
The registry can be configured via the npm environment variable NPM_CONFIG_REGISTRY and will take precedence over the configuration in .npmrc.
The registry and dist-tag can be configured in the package.json and will take precedence over the configuration in .npmrc and NPM_CONFIG_REGISTRY:
{
"publishConfig": {
"registry": "https://registry.npmjs.org/",
"tag": "latest"
}
}Examples
The npmPublish and tarballDir option can be used to skip the publishing to the npm registry and instead, release the package tarball with another plugin. For example with the @semantic-release/github plugin:
{
"plugins": [
"@semantic-release/commit-analyzer",
"@semantic-release/release-notes-generator",
["@feki.de/semantic-release-yarn", {
"npmPublish": false,
"tarballDir": "dist",
}],
["@semantic-release/github", {
"assets": "dist/*.tgz"
}]
]
}