duplitect

duplitect is a simple tool to detect duplicate versions of installed packages. JavaScript package managers such as NPM and Yarn habitually allow you to install multiple versions of (transient) dependencies. This works most of the time - for certain kinds of packages, it does not.

untool happens to be among these packages that have to be installed exactly once inside any given project, which is why we built this module.

Installation

Using NPM:

npm install -S duplitect

Using Yarn:

yarn add duplitect

CLI

Usually, you will want to use duplitect as a CLI tool. Since most typical Node.js projects contain a significant number of (unproblematic) duplicates, you will probably want to limit duplitect's output by passing one or more patterns.

Example

$ duplitect untool @untool*
Duplicate: untool
Duplicate: @untool/core

duplitect supports the wildcard character * as shown above. This allows you to match multiple, possibly scoped, packages at once.

API

getDuplicates([pattern, pattern, ...])

You can also use duplitect in your own tools - it only exposes a single function that mimics the CLI functionality. It returns a Promise object that resolves to an array of strings identifying duplicate packages.

Example

const getDuplicates = require('duplitect');

getDuplicates('untool', '@untool*').then(duplicates => {
  duplicates.forEach(duplicate => console.log(`Duplicate: duplicate`));
});