⚖️ ✔️ licensed is an interactive command line tool to help you choose and add licenses to your projects
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github .github: Add GitHub templates Jun 12, 2018
assets Logo: Change color to JS yellow Jul 3, 2018
lib licensed-exists: Change rawlist to list Jun 18, 2018
src
.babelrc Adding babel and eslint to enforce standard and ease collaboration Jun 10, 2018
.eslintrc Adding babel and eslint to enforce standard and ease collaboration Jun 10, 2018
.gitignore
.npmignore .npmignore: Ignore .github directory Jun 13, 2018
.travis.yml
LICENSE License: Wrap lines to 80 characters Jun 13, 2018
README.md Readme: Update npm badge Jul 3, 2018
package-lock.json package: update modules Sep 20, 2018
package.json package: update modules Sep 20, 2018

README.md

Build Status Number of downloads Licence Number of dependencies Made with Love in India

npm

⚖ licensed is a simple, interactive command line interface to help you choose and quickly add a LICENSE file to your project.

licensed demo gif


Setup

Make sure you have NodeJS (npm 5.2+) installed on your computer. Then, setup is as simple as:

$ npx licensed

If you've got an older version of node (npm version < 5.2) that doesn't yet have npx, here's a more traditional setup:

$ npm i -g licensed

Usage

After installation, navigate to your project directory ie. the directory you want your LICENSE file to be placed. Then:

Usage:
    $ licensed                  # Brings up an option to start a questionnaire or choose from a list of available licenses
    $ licensed <license-name>   # Brings prompt to enter your name
    $ licensed <license-name> <your-full-name> [--year | -y] <year>
    $ licensed [--list | -l]

Options:
    --year, -y <year>   Manually enter year the license is in effect
    --list, -l          List all available licenses
    --help              Show this screen
    --version           Show version

Examples:
    $ licensed mit "Mihir Chaturvedi"
    $ licensed apache
    $ licensed --year 2013-2018

Development

Run:

$ git clone https://github.com/plibither8/licensed.git
$ cd licensed
$ npm link

This will setup a symbolic link to the CLI. Any changes in source files will now be reflected when running the licensed command.

To lint your code, run

$ npm run lint

...and to build your files to lib/ directory, run

$ npm run build

Available licenses to choose from (currently):

  • Apache 2.0
  • BSD-2-Clause
  • BSD-3-Clause
  • GNU General Public License
  • ISC
  • MIT
  • Mozilla Public License 2.0

Contributions

  • If you are aware of more licenses, help expand the list by suggesting or creating a pull request with the license text and name added to assets/licenses, src/licenses.js and other respective files.
  • Any other positive suggestions for this project are welcome :)

Make sure to check out CONTRIBUTING.md.

Acknowledgements