How To Deliver a Release

jaredhanson edited this page Oct 26, 2011 · 3 revisions

Passport-HTTP is packaged and delivered as a module for Node.

Increment Version

Prior to building a release package, the version number should be incremented. This is done by modifying the version information in the following files:

  • version field in package.json
  • exports.version property in lib/passport-http/index.js.

Smoke Test

As recommended in the npm Developer Guide, a basic check should be conducted to ensure that the package will install. This can be done by creating a directory, and attempting to install Passport-HTTP locally.

$ mkdir passport-http-test
$ cd passport-http-test
$ npm install ../passport-http

A more exhaustive check will ensure that the package can be used by an application. This can be done by running an example application.

$ mkdir passport-http-test
$ cd passport-http-test
$ cp -R ../passport-http/examples/basic basic
$ cd basic
$ npm install ../../passport-http
$ npm install
$ node app.js

Version Control Tag

When the source code is stable and prepared for release, the version should be tagged in the Git repository.

$ git tag -a v0.1.0 -m "Tag version 0.1.0."
$ git push origin v0.1.0

Publish Package

After the version has been tagged in the Git repository, the snapshot can be checked-out and published to the npm registry.

$ git checkout v0.1.0
$ npm publish