DEVELOPMENT.md

Development guide

Getting started

First, install Node.js.

Now, clone this repository and run the following in a shell in the checked out folder:

$ npm install

This installs all (development) dependencies in local subfolders. It can be run at any time should the versions in the package.json change.

Running tests

Simply run:

$ npm test

This tests the library with Chrome which will get started for that purpose.

Tests can be automatically re-run on file changes. For that, instead start the long-running test runner:

$ npm run karma

Test output will appear in the shell.

Building a browser bundle

A stand-alone browser bundle that exposes the global uriproj object can be created with:

$ npm run build

This will build the uriproj.{src|min}.js files in the root project folder.

Publishing a new version

1. Raise the version number in package.json.
2. If it is a minor or major version change, update the version in README.md.
3. Create a semver git tag (x.y.z) and push it.
4. Regenerate documentation at https://doc.esdoc.org.
5. Run npm publish.
6. Attach the uriproj.{src|min}.js files to the GitHub release.

The last two steps build and publish the package to the npm registry.

Code style

The JavaScript Standard Style is used in this project. Conformance can be checked with:

$ npm run style