Labs64 NetLicensing Client (JavaScript)

JavaScript wrapper for Labs64 NetLicensing RESTful API

Visit Labs64 NetLicensing at https://netlicensing.io

How to Use

NetLicensing JavaScript Client was designed to work both in the browser and in Node.js.

In order to use NetLicensing JavaScript Client, you must include the compiled and minified JavaScript file in your project. There are multiple options for including these pre-compiled files, also known as a distribution, in your website or application.

Using from a CDN

A CDN (Content Delivery Network) is the fastest way to get up and running with NetLicensing JavaScript Client. Simply include the following lines of code in the <head> section of your page using latest released version:

<script src="https://cdn.jsdelivr.net/gh/Labs64/NetLicensingclient-javascript@x.y.z/dist/netlicensing-client.min.js"></script>

Installing with Node.js / npm

NetLicensing JavaScript Client is available on npmjs. Add the following to your package.json file and then run npm install:

"dependencies": {
    "netlicensing-client": "x.y.z"
}

or execute following command in your Node.js environment:

$ npm install netlicensing-client

Manual installation

We strongly recommend that you use either a CDN or a package manager like npm. This will make it easier for you to deploy your project in different environments, and easily update NetLicensing JavaScript Client when new versions are released. Nonetheless, if you prefer to integrate NetLicensing into your project manually, you can download the release of your choice from GitHub and copy the files from the dist directory into your project.

Include the compiled files in your page:

<script src="netlicensing-client/dist/netlicensing-client.min.js"></script>

Check NetLicensing Wiki or NetLicensing Community Support for detailed usage instructions.

Online Demo

Demo web application for this library can be found here as well as source code.

Development

Useful commands:

npm run dev - build and track all changes to your resources
npm run test- run unit tests
npm run lint - syntax check

Here is a Docker-based local development environment prepared, which provides a very flexible and extensible way of developing Node.js applications.

System Requirements

To be able to build this library you have to meet the following requirements:

docker To be able to build this NetLicensing Client you have to meet the following requirements:
Node.js >= 8.x
npm >= 6.x

Develop with Docker

Clone repository

$ git clone https://github.com/Labs64/NetLicensingClient-javascript.git

Prepare docker image

$ docker build -t labs64/nodejs .

Start local development environment

$ docker run -v $(pwd):/opt/NetLicensingClient-javascript -i -t labs64/nodejs /bin/bash

Configure git using your eMail and Username

$ git config --global user.email "eMail"
$ git config --global user.name "User Name"

How to Contribute

Everyone is welcome to contribute to this project! Once you're done with your changes send a pull request and check CI Status. Thanks!

Bugs and Feedback

For bugs, questions and discussions please use the GitHub Issues.

License

This boilerplate is open-sourced software licensed under the Apache License Version 2.0.

Visit Labs64 NetLicensing at https://netlicensing.io