Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

package-manager-manager

Package Overview
Dependencies
Maintainers
1
Versions
40
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

package-manager-manager

Utilities for managing package managers.

  • 0.1.1-55062d6
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
67K
decreased by-3.76%
Maintainers
1
Weekly downloads
 
Created
Source

package-manager-manager

Utilities for managing package managers.


npm (tag) GitHub Workflow Status (with branch)


package-manager-manager is a library aimed at providing information regarding the package manager currently being used in a given project.

It can be used in CLIs or similar projects which may at some point need to know and adapt their behavior based on the package manager currently used by the developer (e.g. A project scaffolding tool, a bundling tool, etc...).

Usage

To use the library first install it in your project, via:

npm i package-manager-manager

(or your package manager's equivalent)

Then simply import and use the getPackageManager() function to get an object containing all the information you need regarding the package manager currently being used:

const packageManager = await getPackageManager();

console.log(packageManager.name);
// logs 'npm', 'yarn', 'pnpm' or 'bun'

console.log(packageManager.version);
// logs the version of the package manager e.g. '8.11.0'

Note This library comes with properly defined and documented typescript types, meaning that once you obtain the PackageManager object you will be able to easily see what's available on it and get all necessary details directly in your IDE

API

getPackageInfo

packageManager.getPackageInfo allows you to get the information regarding a locally installed package that your client application is using, it can for example be used to make sure your user's application has a certain dependency or to gather and display the package version of such dependency.

For example:

const zodPackage = await packageManager.getPackageInfo('zod');
if (zodPackage) {
	console.log(`starting validation using zod (version: ${zodPackage.version}`);
} else {
	throw new Error('Error: zod is not installed');
}

Note This method only returns the information of a locally installed package, or null in case the package is not installed, it does not return information of packages not locally installed (the API could be extended in the future to also include such use case)

getRunScript

packageManager.getRunScript let's you create a command that can be used to run a script defined in the package.json file.

For example:

const buildStr = packageManager.getRunScript('build', {
	args: ['./dist', '--verbose'],
});

console.log(`To build your application run: ${buildStr}`);

If you need more fine grained control over the command you can use its packageManager.getRunScriptStruct alternative to obtain an object representing the command.

For example:

import { spawn } from 'child_process';

const buildCmd = packageManager.getRunScriptStruct('build', {
	args: ['./dist', '--verbose'],
});

// run the command for the user
spawn(buildCmd.cmd, buildCmd.cmdArgs);

getRunExec

packageManager.getRunExec let's you create a command that can be used to execute a command from a target package (which may or may not be locally installed).

For example:

const eslintStr = packageManager.getRunExec('eslint', {
	args: ['./src', '--quiet'],
});

console.log(`To run eslint on your application run: ${eslintStr}`);

If you need more fine grained control over the command you can use its packageManager.getRunExecStruct alternative to obtain an object representing the command.

For example:

import { spawn } from 'child_process';

const eslintCmd = packageManager.getRunExec('eslint', {
	args: ['./src', '--quiet'],
});

// run the command for the user
spawn(eslintCmd.cmd, eslintCmd.cmdArgs);

FAQs

Package last updated on 25 Sep 2023

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc