NPM-Auth
This utility is used to set the credentials in .npmrc
locally to authenticate against any public/private NPM Repository.
Requirements
- This utility depends on various environment variables being set, specifically:
NPM_REGISTRY_API_KEY
=> the value of_auth
.NPM_REGISTRY_EMAIL
=> the email used to authenticate with. The default value will be used if this environment variable is not set.NPM_REGISTRY
=> the registry that the utility will authenticate against.
Installation
npm install npm-auth
Usage
# This is the first task that needs to run prior to "npm install" npm-auth
If you are not setting the properties as environment variables, you are welcome to passing them via the CLI
#arguments: # registry (required): the registry repository, eg: npmjs.org # email (required): your email address associated to this repositroy, format: you@email.com # secure-token (required): your api key which is used to authenticate # file-path (optional): specify the location to output the configuration file # print prints the local configuration file # Example usage npm-auth --registry=http://www.your-private-registry/npm --secure-token=aasd-123-zasdf-123-sfd --email=you@email.com # Note you may pass in just one of the three required parameters if the other parameters are set as Environment variables npm-auth --email=you@email.com # Also note that anythning passed via the CLI will OVERRIDE the Environment variables, which allows you to flexibibly configure within your CI environment.
.npmrc
from the project solution
Make sure to ignore the local .gitignore
# Other ignore files above
.npmrc
Development
Start with:
npm install
Running tests:
npm run test # Run test with coverage. The coverage report by default is configured for lcov and can be located in the `./coverage` directory. npm run test:cover
Command:
npm run push
Building the application:
The resulting source code is built to a ./dist
directory which is where the transpiled source resides. By default the test files are not built to this directory, only the underlying source.
Command:
npm run build
Contributing
Looking to contribute to NPM-Auth? I love seeing PR's and suggestions, please visit the CONTRIBUTING section for more information.