semantic-release-cli

WebJar for semantic-release-cli

License

License

MIT
Categories

Categories

Ant Build Tools Github Development Tools Version Controls CLI User Interface
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

github-com-semantic-release-cli
Last Version

Last Version

0.0.0-development
Release Date

Release Date

Type

Type

jar
Description

Description

semantic-release-cli
WebJar for semantic-release-cli
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/semantic-release/cli

Download github-com-semantic-release-cli

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/github-com-semantic-release-cli/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>github-com-semantic-release-cli</artifactId>
    <version>0.0.0-development</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-semantic-release-cli/
implementation 'org.webjars.npm:github-com-semantic-release-cli:0.0.0-development'
// https://jarcasting.com/artifacts/org.webjars.npm/github-com-semantic-release-cli/
implementation ("org.webjars.npm:github-com-semantic-release-cli:0.0.0-development")
'org.webjars.npm:github-com-semantic-release-cli:jar:0.0.0-development'
<dependency org="org.webjars.npm" name="github-com-semantic-release-cli" rev="0.0.0-development">
  <artifact name="github-com-semantic-release-cli" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='github-com-semantic-release-cli', version='0.0.0-development')
)
libraryDependencies += "org.webjars.npm" % "github-com-semantic-release-cli" % "0.0.0-development"
[org.webjars.npm/github-com-semantic-release-cli "0.0.0-development"]

Dependencies

compile (19)

Group / Artifact Type Version
org.webjars.npm : request jar [2.58.0,3)
org.webjars.npm : request-promise jar [4.1.1,5)
org.webjars.npm : ini jar [1.3.4,2)
org.webjars.npm : npm-registry-client jar [7.3.0,8)
org.webjars.npm » github-url-from-git jar [1.4.0,2)
org.webjars.npm : inquirer jar [1.2.2,2)
org.webjars.npm : parse-github-repo-url jar [1.0.0,2)
org.webjars.npm : update-notifier jar [1.0.2,2)
org.webjars.npm : user-home jar [2.0.0,3)
org.webjars.npm : validator jar [6.1.0,7)
org.webjars.npm : js-yaml jar [3.3.1,4)
org.webjars.npm : npm jar [4.0.3,5)
org.webjars.npm » base32 jar 0.0.6
org.webjars.npm : nopt jar [4.0.0,5)
org.webjars.npm » travis-ci jar [2.1.1,3)
org.webjars.npm : npmlog jar [4.0.0,5)
org.webjars.npm : bluebird jar [3.4.6,4)
org.webjars.npm : lodash jar [4.16.4,5)
org.webjars.npm » keytar Optional jar [3.0.0,4)

Project Modules

There are no modules declared in this project.

semantic-release-cli

[Build Status](https://github.com/semantic-release/cli/actions?query=workflow%3ATest+

Install

npm install -g semantic-release-cli

cd your-module
semantic-release-cli setup

dialogue

Options

Usage:
  semantic-release-cli setup [options]

Options:
  -h --help           Show this screen.
  -v --version        Show version.
  --[no-]keychain     Use keychain to get passwords [default: true].
  --ask-for-passwords Ask for the passwords even if passwords are stored [default: false].
  --tag=<String>      npm tag to install [default: 'latest'].
--gh-token=<String>  GitHub auth token
--npm-token=<String> npm auth token
--circle-token=<String> CircleCI auth token
--npm-username=<String>  npm username

Aliases:
  init                 setup

What it Does

semantic-release-cli performs the following steps:

  1. Asks for the information it needs. You will need to provide it with:
    • Whether your GitHub repository is public or private
    • Which npm registry you want to use (Default: https://registry.npmjs.org/)
    • Your npm username (unless passwords were previously saved to keychain)
    • Your npm email
    • Your npm password
    • Which continuous integration system you want to use. (Options: Travis CI / Pro / Enterprise / CircleCI, or Other)
    • [Travis only] Whether you want to test a single node.js version (e.g. - 8) or multiple node.js versions (e.g. - 4, 6, 8, etc.)
  2. npm Add User
    • Runs npm adduser with the npm information provided to generate a .npmrc
    • Parses the npm token from the .npmrc for future use
  3. Uses user supplied GitHub Personal Access Token (with the following permissions: repo, read:org, repo:status, repo_deployment, user:email, write:repo_hook)
    • Sets GitHub Personal Access Token in user choosen CI/CD environment variable
  4. Update your package.json
    • Set version field to 0.0.0-development (semantic-release will set the version for you automatically)
    • Add a semantic-release script: "semantic-release": "semantic-release"
    • Add semantic-release as a devDependency
    • Add or overwrite the repository field

Travis CI

Versions 4.1.0+

semantic-release-cli does not perform any additional Travis-specific steps, but the cli output will provide a link for assistance integrating Travis and semantic-release-cli.

Prior to version 4.1.0

semantic-release-cli performs the following additional steps:

  1. Overwrite your .travis.yml file
    • after_success: npm install -g travis-deploy-once and travis-deploy-once "npm run semantic-release": run semantic-release exactly once after all builds pass
    • Set other sane defaults: cache: directories: ~/.npm, notifications: email: false
  2. Login to Travis CI to configure the package. This step requires your module to define a valid, case-sensitive repository field.
    • Enable builds of your repo
    • Add GH_TOKEN and NPM_TOKEN environment variables in the settings

CircleCI

For CircleCI, semantic-release-cli performs the following additional steps:

  1. Create minimal config.yml file (if CircleCI was selected)
version: 2
jobs:
  build:
    docker:
      - image: 'circleci/node:latest'
    steps:
      - checkout
      - run:
        name: install
        command: npm install
      - run:
        name: release
        command: npm run semantic-release || true
  1. Login to CircleCI to configure the package
    • Enable builds of your repo
    • Add GH_TOKEN and NPM_TOKEN environment variables in the settings

Github Actions

For Github Actions, semantic-release-cli performs the following additional step:

  • Login to Github to configure the package
  • Add NPM_TOKEN environment variables as a secret in the settings

For now you will have to manually modify your existing workflow to add a release step. Here is an example of a small complete workflow .github/workflows/workflow.yml:

name: CI
on: push
jobs:
  test:
    runs-on: ubuntu-16.04
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v1
        with:
          node-version: '12'
      - run: npm ci
      - run: npm test
      - name: Release
        env:
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: npx semantic-release

Other CI Servers

By default, semantic-release-cli supports the popular Travis CI and CircleCI servers. If you select Other as your server during configuration, semantic-release-cli will print out the environment variables you need to set on your CI server. You will be responsible for adding these environment variables as well as configuring your CI server to run npm run semantic-release after all the builds pass.

Note that your CI server will also need to set the environment variable CI=true so that semantic-release will not perform a dry run. (Most CI services do this by default.) See the semantic-release documentation for more details.

Setting defaults

This package reads your npm username from your global .npmrc. In order to autosuggest a username in the future, make sure to set your username there: npm config set username <username>.

Contribute

Please contribute! We welcome issues and pull requests.

When committing, please conform to the semantic-release commit standards.

License

MIT License 2015 © Christoph Witzko and contributors

https://twitter.com/trodrigues/status/509301317467373571

org.webjars.npm

Versions

Version
0.0.0-development