Easily install new packages and their types, every time.
Switch branches/tags
Nothing to show
Clone or download
Latest commit ed8153f Oct 20, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
__tests__ don't log if there's no spin Oct 20, 2018
src don't log if there's no spin Oct 20, 2018
.gitignore initial public commit Apr 2, 2018
.prettierignore initial public commit Apr 2, 2018
README.md don't log if there's no spin Oct 20, 2018
package-lock.json 1.0.5 Oct 20, 2018
package.json 1.0.5 Oct 20, 2018
tsconfig.json add -e flag and cleanup Oct 19, 2018
tslint.json initial public commit Apr 2, 2018

README.md

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!')
})