get-pm

Detect and abstract away package managers in JS/TS codebases

Why?

Many a time, I find myself creating CLIs that require some sort of access to the user's package manager. This is a pain to do, as I have to write a bunch of code to detect the user's package manager, and then write code to abstract away the differences between the package managers. This package aims to solve that problem.

Right about now, you might be thinking "Why not use which-pm or which-pm-runs or preferred-pm". Well, those packages are great, but they don't abstract away the differences between the package managers. This package does that.

Detection logic

• If a bin target is executed with a user_agent i.e npx | pnpx | yarn dlx, then the package manager is detected from the user_agent.
• If a lockfile is present, then the package manager is detected from the lockfile.
• If node_modules is present, then the package manager is detected from the node_modules.
• If multiple package managers are detected and the prefer option has been passed, then the package manager is detected from the prefer option. see example below.
• If all else fails, defaults to npm.

Usage

1import { getPackageManager } from 'get-pm';
2
3const pm = getPackageManager({
4    prefer: ['pnpm', 'yarn'], // optional - if multiple found, prefer these
5    cwd: process.cwd(), // optional - defaults to process.cwd()
6    workspace: true, // optional - treat working dir as a workspace
7    silent: false, // optional - suppress console output when running pm commands eg. `pm.install()`
8});
9
10console.log(pm.name); // npm | yarn | pnpm
11console.log(pm.version) // semver version of the package manager
12
13// install packages defined in package.json
14await pm.install();
15
16// add packages
17await pm.add(['foo', 'bar']);
18
19// add packages with flags/options
20await pm.add(['foo', 'bar'], "-Dw"); // -Dw is the workspace flag for pnpm
21
22// remove packages
23await pm.remove(['foo', 'bar']);
24
25// run scripts in package.json
26await pm.run('build');
27
28// execute binaries
29await pm.exec('tailwindcss', ['init', '-p']);

Usage with commonjs

The get-pm package is an esm module which cannot be used with the default require syntax in commonjs. To use it with cjs, you will have to use the import syntax as shown below:

1async function getPm() {
2    const { getPackageManager } = await import("get-pm")
3    const pm = getPackageManager();
4
5    return pm
6}
7

License

This project is licensed under the MIT License - see the LICENSE file for details