Generate License File

A CLI and code library to generate a text file containing all of the licenses for your production third-party dependencies.

Installation and Usage (CLI)

1npm install generate-license-file --save-dev
2
3npx generate-license-file --input package.json --output third-party-licenses.txt --overwrite

Argument	Description
--input	Absolute or relative path to the package.json for the project.
--output	Absolute or relative path for the generated output file.
--overwrite	(optional) Allows the CLI to overwrite existing output files. If this option is not provided and the output file already exists, you will be prompted to confirm.
--eol	(optional) Specify the line endings used in the output file. Accepted values are crlf or lf. If no value is provided your system default will be used.
--ci	(optional) Stops the CLI from prompting the user for inputs and instead exits with a non-zero exit code.
--no-spinner	(optional) Disable the CLI spinner while the output file is being generated.
--config	(optional) Specify the path to a generate-license-file config file at a non-standard location.
--version	(optional) Print the installed generate-license-file version.

If either the --input or --output are omitted the CLI will prompt you for their values.

For a full description of the CLI arguments and their usages please see the relevant docs page.

Installation and Usage (Library API)

1npm install generate-license-file --save-dev

TypeScript

1import { generateLicenseFile, getLicenseFileText, getProjectLicenses } from "generate-license-file";
2
3// Generate the license file and write it to disk.
4await generateLicenseFile("./package.json", "./third-party-licenses.txt");
5
6// Generate the license file content and return it as a string.
7const licenseFileText: string = await getLicenseFileText("./package.json");
8
9// Get an array of objects each containing the details of an
10// identified license and the dependencies it pertains to.
11const licenses: ILicense[] = await getProjectLicenses("./package.json");

For a full description of the library API and example usages please see the relevant docs page.

Advanced Configuration

Advanced configuration of the generated output can be done using a configuration file. In addition to the basic CLI arguments, a configuration file allows you to specify appendices, exclusions, and replacements.

Config files can be called either .glf or .generatelicensefile and can be customised using the following options:

• File name can optionally end with rc
• Can be in a ./.config directory (no longer needs the . prefix on the file name)
• Have the following file extensions: .json, jsonc, .json5, .yaml, .yml, .js, .cjs

E.g. .glf.json, .glfrc.yml, .generatelicensefile.jsonc, .config/glf.js, and more.

1{
2  // Default config - can be passed in via config and/or CLI
3  "inputs": ["./package.json"],
4  "output": "./third-party-licenses.txt",
5  "lineEnding": "lf",
6
7  // Paths to any file's whose content will be appended to the end of the generated file.
8  "append": ["./additional-content.txt"],
9
10  // Substitute the given packages license with the content in the respective file.
11  "replace": {
12    "replaced-package@4.33.1": "./bespoke-license.txt",
13    "another-replaced-package": "./bespoke-license-2.txt"
14  },
15
16  // Exclude any packages from the output.
17  "exclude": ["my-package@1.2.0"],
18
19  // Omit the version number in the output file
20  "omitVersion": false
21}

If you want to call your config file something else then you can pass it to the CLI via the --config argument:

1npx generate-license-file --config ./my-config.json

Contributing and Building From Source

generate-license-file is an NX Monorepo. We have aliased common commands in the scripts section of the src/package.json to make working with the project easier.

Each package in the monorepo (under src/packages/) contains a README with further information. The main library and CLI is under packages/generate-license-file.

1# cwd: src/
2
3npm run lint
4
5npm run test  # unit tests
6
7npm run test:e2e  # e2e tests
8
9npm run build  # will build all packages into src/dist/[package name]

License

generate-license-file is licensed under the ISC License.