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

ender-installer

v1.0.3

Published

Package installer component of the Ender CLI

Downloads

65

Readme

Ender Installer Build Status

A component of the Ender CLI, providing an additional layer on top of Ender's npm wrapper Ender Repository.

Installing packages is not as simple as just asking npm to install them, there is additional logic we need in order to get exactly what we want and also to control npm (in particular, npm needs '.' to be installed separately). Our install logic allows us to install more than just the standard package.json "dependencies", we can also install "ender"->"dependencies". We also get to skip installing dependencies that already exist which the npm API doesn't allow us to do directly. The basic flow is: (1) check dependency status in node_modules, (2) ask npm to install anything missing, (3) repeat until there's not left to install. One special case is that we always ask npm to install packages specified by a path (i.e. local).

Executable

If you install with npm install ender-installer -g then you'll get an ender-installer executable that you can use to install npm packages, the Ender way. Combined with the executable in Ender Builder you'd have complete Ender install & build tools separate from the main Ender CLI.

The executable obeys the --force-install command; without it, it'll not reinstall packages that have already been installed.

$ ender-installer ender-js bonzo bean traversty --force-install

About Ender

For more information check out http://ender.jit.su

API

enderInstaller(options, packages, callback)

Ender Installer exports a single main function that performs the installation. The options object can contain a 'force-install' boolean (i.e. from --force-install on the command line) that will force an install from npm even if the package is already installed in node_modules ('_force-install' is an alternative and is used upstream to indicate that the option shouldn't be saved to the build file's command line string, i.e. ender refresh does a --force-install but that option isn't left in the build file).

The packages argument is an array of packages to be installed, npm-style so they can contain @semvers and even be filesystem paths.

The callback has the signature: function (err, npmResults, dependencyGraph) where npmResults is an array of results from Ender Repository's install() function and dependencyGraph is a DependencyGraph object generated from Ender Dependency Graph.


Contributing

Contributions are more than welcome! Just fork and submit a GitHub pull request! If you have changes that need to be synchronized across the various Ender CLI repositories then please make that clear in your pull requests.

Tests

Ender Installer uses Buster for unit testing. You'll get it (and a bazillion unnecessary dependencies) when you npm install in your cloned local repository. Simply run npm test to run the test suite.

Licence

Ender Installer is Copyright (c) 2012 @rvagg, @ded, @fat and other contributors. It is licenced under the MIT licence. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.