Have opinions about JavaScript? We want to hear them. Take the 2018 JavaScript Ecosystem Survey »

typed-install

1.0.5 • Public • Published

typed-install

npm

You're writing Typescript and it's time to install your favorite node module. Has this ever happened to you?

% npm i my-module @types/my-module
npm ERR! code E404
npm ERR! 404 Not Found: @types/my-module@latest

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/user/.npm/_logs/2018-03-31T23_41_37_683Z-debug.log

It's hard to know if type declarations are included with the module, shipped separately, or non-existent. Enter typed-install.

Installation and Usage

Install from npm using your favorite package manager.

% npm i -g typed-install

Run it with the typedi command, passing any number space-separated package names (this should be very familiar).

% typedi heroku-config lodash striptags
✔ Installing Packages
✔ Checking for @types
✔ Installing Available Types

The following packages were fully installed:
  * lodash
  * striptags

The following packages were installed, but lack types:
  * heroku-config

By default, typedi uses npm, saves packages into dependencies, and @types into devDependencies.. This is configurable with the following flags:

  • -d | --dev: save packages into the devDependencies
  • -p | --prod: save @types into dependencies
  • -y | --yarn: install using yarn instead of npm
  • -e | --exact: install with an exact type instead of a caret (^)

Using --dev and --prod together will probably not do what you expect.

npx

If you have npm@5.2.0 or greater installed, you can run this via npx (more info), a tool to run CLI packages without explicitly installing them. This is great for periodic or one time use.

The previous example becomes:

% npx typed-install heroku-config lodash striptags

If you're going to invoke this repeatedly or frequently, global installation is recommended.

API

The code that powers typedi can also be used via the Node.js API.

The main function takes the following options, in order:

modules (string[])

An array of npm module names

opts (object, default {})

an object with any of the following keys (see above):

  • dev
  • prod
  • yarn
  • exact

Any keys not present default to false.

shouldSpin (boolean, default false)

Whether or not to run the fancy spinner. If you're using this in other code, this should probably be false. Also controls whether messages are logged.

const typedi = require('typed-install').default
 
typedi(['lodash', 'striptags'], { dev: true }).then(() => {
  console.log('all done!')
})

install

npm i typed-install

Downloadsweekly downloads

98

version

1.0.5

license

ISC

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability