npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

dynamic-installer

v1.1.1

Published

Allows installing dependencies dynamically through code instead of using npm install in the terminal

Downloads

173

Readme

Dynamic Installer

npm version License

Dynamic Installer is a library that allows you to programmatically install npm dependencies through code. It is ideal for secure development environments, enabling you to install dependencies using code instead of running npm install directly in the shell.

Security Warning ⚠️

Warning: This utility injects commands directly into the shell and is designed for secure, controlled development environments only. Avoid using it in production or in any exposed context, as it could be vulnerable to command injection.

Features

Refer to the CHANGELOG for updates and changes.

  • Programmatic npm installations: Control installation options programmatically.
  • Global or dependency-specific options: Pass global options like --no-save that apply to all libraries, or specify options for each individual dependency.
  • CommonJS and ESM support: Compatible with both module systems.
  • Verbose option: Enable detailed logging of the installation process.

Installation

Install dynamic-installer via npm:

npm install dynamic-installer

Usage

Import the library's installDependencies function to start using it:

import { installDependencies } from 'dynamic-installer';

The installDependencies function accepts a configuration object containing global options and a list of dependencies with specific options.

const options = {
  globalOptions: '--save-dev',
  dependencies: [
    { name: 'eslint', options: '--global' },
    { name: 'lodash', options: '--no-save', override: true },
    { name: 'mocha' }
  ]
};

// With async/await
const result = await installDependencies(options);
if (result.success) {
    console.log('All dependencies installed successfully!');
} else {
    console.error('Some dependencies failed to install:', result.details);
}

// Or using .then()
installDependencies(options)
    .then(result => {
        if (result.success) {
            console.log('All dependencies installed successfully!');
        } else {
            console.error('Some dependencies failed to install:', result.details);
        }
    });

Example Explanation

  • globalOptions are applied to all dependencies by default, unless explicitly overridden.
  • eslint installs using its own --global option and ignores globalOptions.
  • lodash combines --no-save with the global option --save-dev since override is set to false.
  • mocha defaults to using only the globalOptions.

Output

The function returns a Promise resolving to an object with:

  • success: Boolean indicating if all installations were successful.
  • details: Array containing individual installation results for each dependency.
  • logs: String with detailed logs of the installation process.

API

installDependencies(options)

  • options (Object): A configuration object containing:
    • globalOptions (String): Options applied globally to all dependencies.
    • dependencies (Array of Objects): List of dependencies, each with:
      • name (String): Dependency name (required).
      • options (String): Specific options for this dependency (optional).
      • override (Boolean): Set to true to use only dependency-specific options, ignoring globalOptions. Defaults to false.

Returns: A Promise resolving to an object with success and details.

Supported Options

All npm install options are supported, including:

  • --save-dev, --save-optional, --no-save, --global: Control how dependencies are stored.
  • --legacy-peer-deps, --force: Manage compatibility and dependency issues.

Refer to the npm install documentation for a complete list of options.

License

Licensed under the MIT License.

Contact

email: Manuel Otero