@wbmnky/license-report-generator NPM

@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

const licenser = require('@wbmnky/license-report-generator');

const options = { 
  useDevDependencies: true
};

return licenser.reporter.generate(options)
                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
                        .catch((error) => {
                          console.log(error);
                        });

Return licenses as plain object

const licenser = require('@wbmnky/license-report-generator');

const options = { 
  useDevDependencies: true,
  depth: 2
};

return licenser.reporter.generate(options)
                        .then(rep => console.log(rep.plain()))
                        .catch((error) => {
                          console.log(error);
                        });

Use with your own template

const licenser = require('@wbmnky/license-report-generator');
const fs       = require('fs');
const path     = require('path');

const options = {
  template: fs.readFileSync(path.resolve(__dirname, 'template-table.txt'), 'utf8')
};

return licenser.reporter.generate(options)
                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
                        .catch((error) => {
                          console.log(error);
                        });

Use with default table template

const licenser = require('@wbmnky/license-report-generator');

return licenser.reporter.generate({})
                        .then(rep => rep.table())
                        .then(rep => rep.write(path.resolve(__dirname, 'output.md')))
                        .catch((error) => {
                          console.log(error);
                        });

CLI usage

license-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