package-json-dry v0.10.0

DRY - Use npm across multiple projects without repeating yourself

Get it

$ npm i -g dry-dry

Use it

$ dry init

The copy/paste madness

Because companies and other groups have bunch of package.json attributes that are the same across all npm projects. Those attributes must be maintained using copy/paste across all projects. This is wrong !

We believe that those attributes should be easily distributed and updated across projects.

The version management madness

Because most of multi module project use multiple version of the same dependencies. Bundling an application with those modules may be challenging.

Dry provide a mecanism to centralize dependencies version management.

Do not repeat yourself

dry is a stupid npm wrapper allowing any package.json to extend a parent file. The parent file can be located on the system or simply inside a published npm module.

How does it work

On each dry command, dry:

• creates a merged package.json based on the provided package-dry.json
• runs the npm command
• applies the possible package.json modifications made by npm to package-dry.json
• removes package.json

package.json is always removed to make sure that nobody will execute a pure npm command in a dry project.

Inheritance in action

Parent project

package-dry.json

{
    "name": "parent",
    "version": "1.0.0",
    "description": "",
    "main": "index.js",
    "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1",
        "foo": "npm help"
    },
    "keywords": [],
    "author": "",
    "license": "ISC",
    "dependencyManagement": {
        "dependency-one": "1.0.0",
        "dependency-two": "2.0.0",
        "dev-dependency-one": "1.1.0",
        "dev-dependency-two": "2.2.0"
    }
}

Child project

package-dry.json

{
    "name": "child",
    "version": "1.0.0",
    "description": "",
    "main": "index.js",
    "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
    },
    "keywords": [],
    "author": "",
    "license": "ISC",
    "dry": {
        "extends": "parent/package-dry.json",
        "dependencies": {
            "parent": "1.0.0"
        }
    },
    "dependencies": {
        "dependency-one": "managed",
        "dependency-three": "1.2.3"
    },
    "devDependencies": {
        "dev-dependency-two": "managed",
        "dev-dependency-three": "1.2.3"
    }
}

Merged package.json

{
  "name": "child",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "foo": "npm help"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "dependencies": {
     "dependency-one": "1.0.0",
     "dependency-three": "1.2.3"
  },
  "devDependencies": {
     "dev-dependency-two": "1.1.0",
     "dev-dependency-three": "1.2.3"
  }
}

package-dry.json

To do that, dry introduces a file named package-dry.json. package-dry.json replaces package.json in your dry projects. Of course, it can contain all the attributes of package.json with the addition of an attribute called dry.

package-dry.json dry attribute has 2 optional attributes:

• extends - The parent of the current dry package
• dependencies - The dependencies needed to resolve the file pointed by extends. Those dependencies will not be saved to your project.

dry commands

dry proxies all received arguments to npm. Just take your usual npm commands and replace the word npm with dry.

dry commands : additional parameters

The dry command accepts some additional parameters

• --dry-packager packager_cli_name : specify the nodejs packager cli to proxy (default : npm, possible values: npm|pnpm|yarn)
• --dry-keep-package-json' : when provided the generated package.json file is not deleted
• --dry-save-package-json-to' target_file_path : when provided a copy of the generated package.json file is done to target_file_path location

Other handled parameters:

• --loglevel trace|debug|info|warn|error: log set to a specific level
• -s, --silent: --loglevel error
• -q, --quiet: --loglevel warn
• -d: --loglevel info
• -dd, --verbose: --loglevel debug
• -ddd: --loglevel trace

dry : using a custom package manager

Dry use by default npm and it also allows using another package manager like pnpm and yarn trough the parameter --dry-packager.

If you're not using one of the configured packagers or if you need to extend an existing packager then you can provide to the --dry-packager parameter a path to a 'Package Manager Descriptor' json file.

All package manager available in Dry are defined using a 'Package Manager Descriptor'. It provides to Dry which command it needs to execute and how to handle and map dry supported arguments

{
    "extends": "",
    "packageManager": "", 
    "installParentCommandTemplate": "", 
    "preventPackageJsonChangeFromParentInstall": true|false,
    "mappedArguments" : [
        { 
            "arguments": [""],
            "expectSubArgument": true|false,
            "allowArgInInstallParentCommand": true|false,
            "mappedArgumentValues": {
                "": [""],
                "": [""],
                "": [""]
            }
        },
        { 
            "arguments": [""],
            "allowArgInInstallParentCommand": true|false,
            "mappedTo" : [""]
        }
 	]
}        

DryPackagerDescriptor

ArgumentMapping

You can check current descriptors with the links below:

• npm.json
• pnpm.json
• yarn.json