@wbmnky/license-report-generator

finds and stores all dependency licenses

Install

pnpm add @wbmnky/license-report-generator

Usage

Options

{
  useDevDependencies: boolean, // defaults to 'false'
  packagePath: string,         // defaults to 'process.cwd()'
  packageName: string,         // defaults to 'package.json'
  depth: number,               // defaults to '1'
  template: string,            // defaults to the contents of assets/template.txt
}

Examples

Find licenses and write to file

1const licenser = require('@wbmnky/license-report-generator');
2
3const options = { 
4  useDevDependencies: true
5};
6
7return licenser.reporter.generate(options)
8                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
9                        .catch((error) => {
10                          console.log(error);
11                        });

Return licenses as plain object

1const licenser = require('@wbmnky/license-report-generator');
2
3const options = { 
4  useDevDependencies: true,
5  depth: 2
6};
7
8return licenser.reporter.generate(options)
9                        .then(rep => console.log(rep.plain()))
10                        .catch((error) => {
11                          console.log(error);
12                        });

Use with your own template

1const licenser = require('@wbmnky/license-report-generator');
2const fs       = require('fs');
3const path     = require('path');
4
5const options = {
6  template: fs.readFileSync(path.resolve(__dirname, 'template-table.txt'), 'utf8')
7};
8
9return licenser.reporter.generate(options)
10                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
11                        .catch((error) => {
12                          console.log(error);
13                        });

Use with default table template

1const licenser = require('@wbmnky/license-report-generator');
2
3return licenser.reporter.generate({})
4                        .then(rep => rep.table())
5                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
6                        .catch((error) => {
7                          console.log(error);
8                        });

CLI usage

1license-report-generator [--table] [--depth Number|Infinity] [--template-dir path/to/templates/] [--template-file template.txt] [--out-dir path/to/output/] [--out-file license-output.md] 

CLI options

• --table (Default: false) - use the default table template
• --depth {number}|Infinity (Default: 1) - package depth, 0 is current project only
• --with-dev-dependencies (Default: false) - whether to include devDependencies in the license report or not
• --out-dir (Default: process.cwd()) - the output directory where the license file is written to
• --out-file (Default: license-output.md) - the output filename of the license file
• --template-dir (Default: null) - if you want to use an own template, specify the directory where to find the template
• --template-file (Default: null) - if you want to use an own template, specify the filename of the template

Changelog

> 2.2.0

Subsequent changelogs can be found in the Releases section of this repository.

2.2.0

• feat: Added new variable generatedAt to use in a template
• fix: Removed Travis CI, replaced with GitHub Actions (build and publish)
• fix: Renamed interfaces and types
• chore: Replaced yarn with pnpm as the internal package manager
• chore: Updated dependencies to latest versions

2.1.0

• Added CLI option to use as a global installed npm package

2.0.0

• Removed bower support (fallback: legacy version 0.2.0 @ npm)
• Return all found packages as plain object, without formatting / writing to file
• Added second example template for display as a table

License

MIT © Sebastian Roming

Credits

This is originally based on ux-license-report.