npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

node-releaser

v2.1.6

Published

Software versioning, releasing and publishing tool.

Downloads

773

Readme

node-releaser

Software versioning, releasing and publishing tool.

NPM npm version

Features

  1. Supports semver and calver based versioning.
  2. Auto-create Github/Gitlab releases.
  3. Auto-manage package.json's version field and optional npm publish option.
  4. Auto-publishes your docker containers as you release.
  5. Interactive cli with --non-interactive option.

Sample output of check command.

Install

# install globally
npm i -g node-releaser
# or locally
npm i node-releaser 

Use

# if you installed globally
releaser [command] [options]
# or locally
npx releaser [command] [options]

Quickstart

In any git based project, run:

releaser release -l patch -m "fixed something" -m "fixed something else"

This command validates your codebase first, runs interactive configuration wizard if there is no configuration defined, commit+tag+push your changes and calls relevant hooks while doing all of this.

Sample output of release command.

It checks project's git history, git remotes, package.json and Dockerfile to offer you the essential functionality such as generating next versions, publishing npm package versions, creating releases on Github or Gitlab, pushing container images to a docker registry.

All features can be enabled/disabled through a configuration file. It is either .releaser.json or releaser property inside package.json. Interactive configuration wizard will help you to create this configuration and you can edit anytime as you wish.

For releasing on Github or Gitlab to work, the GITHUB_TOKEN or GITLAB_TOKEN environment variables has to be set. These are personal access tokens that you can create from their website.

Example Scenario: npm Packages

Let's say you are making a node.js module to help devs in some way and you decided to host it on Github and serve via npm.

On initial release you would do:

releaser release -l premajor.beta -m "initial release."

This command will show you the interactive configuration wizard and after configuration, it commits your changes, creates a git tag v1.0.0-beta.0, creates a release on Github and publishes your package on npm, in a default configuration behaviour.

You would do a few more beta updates and eventually release the major release:

releaser release -l beta -m "another beta release." # v1.0.0-beta.1
releaser release -l major -m "major release!" # v1.0.0

Example Scenario: Frontend App

In this scenario, we are making frontend web application and want to use calendar versioning instead of semver. Our code hosted on Gitlab and we have a package.json.

In the first call for releaser, you will face the configuration wizard and this time we choose calver as versioning scheme instead of semver. The call is pretty much same with only level difference.

releaser release -l calendar.beta -m "initial release."

With this call, our codebase will be pushed to Gitlab, version field of package.json gets updated, a new release will be created on Gitlab.

You can do more releases with no difference from previous examples:

releaser release -l beta -m "another beta release."
releaser release -l calendar -m "major release!"

Say you want to deploy as you release. You would have a deploy script such as ./cd/deploy.js that triggers the deploy in the cloud and all you have to do is to add a releaser afterPush hook that executes that script after every successful release. In .releaser.json file add the following:

{
  "hooks": {
    "afterPush": "node ./cd/deploy.js"
  }
}

With this hook, on each release, releaser also execute the node ./cd/deploy.js command.

More Control With A Configuration File

Normally, configuration managed by the releaser. But there could be cases that you want to edit configuration manually.

Releaser configuration could be in .releaser.json or releaser property inside package.json.

This is the schema of the configuration:

{
  "location": {"enum": [".releaser.json", "package.json"], "default": ".releaser.json"},
  "versioningScheme": {"enum": ["semver", "calver"]},
  "versioningFormat": {"type": "string", "format": "calverFormat"},
  "versioningPrefix": {"type": "string", "default": ""},
  "npmUpdatePackageVersion": {"type": "boolean", "default": false},
  "npmPublishPackage": {"type": "boolean", "default": false},
  "npmPublishPackageArgs": {"type": "array", "items": {"type": "string"}, "default": []},
  "githubRelease": {"type": "boolean", "default": false},
  "gitlabRelease": {"type": "boolean", "default": false},
  "dockerConnectionString": {"type": "string"},
  "dockerBuildPath": {"type": "string", "default": "."},
  "dockerBuildArgs": {"type": "array", "items": {"type": "string"}, "default": []},
  "dockerPushArgs": {"type": "array", "items": {"type": "string"}, "default": []},
  "hooks": {
    "type": "object",
    "properties": {
      "beforeCommit": {"type": "string"},
      "afterCommit": {"type": "string"},
      "beforePush": {"type": "string"},
      "afterPush": {"type": "string"}
    }
  }
}

A simple typical configuration file looks like this:

{
  "location": ".releaser.json",
  "versioningScheme": "semver",
  "versioningPrefix": "v",
  "npmUpdatePackageVersion": true,
  "githubRelease": true
}

Hooks

There are four hooks: beforeCommit, afterCommit, beforePush and afterPush. You can simply assign any command to any of these hooks via configuration file:

{
  "hooks": {
    "afterPush": "node ./cd/deploy.js"
  }
}

Additionally, there are template literals that you can pass as arguments to your commands:

{
  "hooks": {
    "afterPush": "node ./cd/deploy.js --version ${tag}"
  }
}

On execution the command above will become node ./cd/deploy.js --version v1.2.3.

List of template literals:

| Template Literal | Description | |------------------|--------------------------------------------------| | gitRemote | Push url read from git. | | gitRemoteService | It is "github" or "gitlab" | | gitBranch | The name of the git branch such as "main" | | tag | Full version tag including prefix such as v1.2.3 | | abbrCommitHash | Short version of the full commit hash. |

List of template literals based on the hook:

| Hook | Description | Template Literals | |--------------|----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------| | beforeCommit | Executed just before committing. | gitRemote, gitRemoteService, gitBranch, tag | | afterCommit | Executed after committing and tagging. | gitRemote, gitRemoteService, gitBranch, tag, abbrCommitHash | | beforePush | Executed just before pushing to remote. (No difference with afterCommit but useful if you use releaser push) | gitRemote, gitRemoteService, gitBranch, tag | | afterPush | Executed after pushing to remote. | gitRemote, gitRemoteService, gitBranch, tag |

Command Line Interface

You can list all the commands and the options by adding --help to them.

releaser --help

Sample output of help command.

Contributing

If you're interested in contributing, read the CONTRIBUTING.md first, please.


Version management of this repository done by releaser 🚀


Thanks for watching 🐬

Support me on Patreon