@springernature/util-package-extender
v0.0.4
Published
Extends a component package by merging with the package it extends
Downloads
3
Maintainers
Keywords
Readme
Package Extender
This helper allows you to extend one Component Package (remote) with another (local). The helper merges files from the remote package with files from the local, ignoring any files in the remote that already exist at the local level.
Remote Package - package being extended, published to NPM
Local Package - package that extends the remote
This should be run from within the repository of the local package, and requires the local package to have a package.json
file with the fields name
, version
, extendsPackage
. The last of these should define the name and version of the remote package in the format package-name@version
. For example:
{
"name": "brand-package",
"version": "1.0.0",
"extendsPackage": "[email protected]"
}
Install
$ npm install @springernature/util-package-extender
Usage
The helper exports two functions:
getPackageExtensionDetails(packageJsonObject, packageScope)
Returns a Promise
with package extension details contained in an Object
. The package.json
file for the local package needs to contain the keys name
, version
, and extendsPackage
.
packageJsonObject
Type: Object
A Javascript Object representing the package.json
file of the local package.
packageScope
Type: String
Default: 'springernature'
The scope under which to search for the remote package (only works with scoped packages at the moment).
Example
const extender = require('@springernature/util-package-extender');
const obj = require('./package.json');
// With default scope
// ------------------
try {
const details = await extender.getPackageExtensionDetails(obj);
// {
// extendPackage: true,
// remotePackage: '@springernature/[email protected]',
// localPackage: '[email protected]'
// }
} catch(err) {
throw err;
}
// With custom scope
// -----------------
try {
const details = await extender.getPackageExtensionDetails(obj, 'my-scope');
// {
// extendPackage: true,
// remotePackage: '@my-scope/[email protected]',
// localPackage: '[email protected]'
// }
} catch(err) {
throw err;
}
// No package extension defined
// ----------------------------
try {
const details = await extender.getPackageExtensionDetails(obj);
// {
// extendPackage: false,
// remotePackage: null,
// localPackage: null
// }
} catch(err) {
throw err;
}
extendPackage(packageJsonPath, remotePackage, localPackage, outputDirectory)
Returns a Promise
after merging the two packages on the local filesystem. Files from the remote package are either merged in place with the local files, or merged into an output directory with a copy of the local files.
packageJsonPath
Type: String
Location of the package.json
file for the local package.
remotePackage
Type: String
Name and version of the remote package in the format package-name@version
.
localPackage
Type: String
Name and version of the local package in the format package-name@version
.
outputDirectory
Type: String
Default: null
Directory in which to store the merged files. Defaults to merging in place with the local files.
Example
const extender = require('@springernature/util-package-extender');
const obj = require('./package.json');
// Merge in place
// --------------
try {
const details = await extender.getPackageExtensionDetails(obj);
await extender.extendPackage(
'/path/to/package.json',
details.remotePackage,
details.localPackage
)
} catch(err) {
throw err;
}
// Merge into output directory (./demo)
// ------------------------------------
try {
const details = await extender.getPackageExtensionDetails(obj);
await extender.extendPackage(
'/path/to/package.json',
details.remotePackage,
details.localPackage,
'./demo'
)
} catch(err) {
throw err;
}
License
MIT License © 2019, Springer Nature