From b9e40fbaacc60de562481b764b0e78bf021f7cfa Mon Sep 17 00:00:00 2001 From: isaacs Date: Mon, 4 Jun 2012 17:32:46 -0700 Subject: [PATCH] Upgrade npm to 1.1.24 --- deps/npm/AUTHORS | 1 + deps/npm/Makefile | 2 + deps/npm/doc/cli/json.md | 31 + deps/npm/html/api/GubbleBum-Blocky.ttf | Bin 10292 -> 0 bytes deps/npm/html/api/author.html | 69 -- deps/npm/html/api/bin.html | 4 +- deps/npm/html/api/bugs.html | 4 +- deps/npm/html/api/commands.html | 4 +- deps/npm/html/api/config.html | 4 +- deps/npm/html/api/deprecate.html | 4 +- deps/npm/html/api/docs.html | 4 +- deps/npm/html/api/edit.html | 4 +- deps/npm/html/api/explore.html | 4 +- deps/npm/html/api/find.html | 88 --- deps/npm/html/api/get.html | 68 -- deps/npm/html/api/help-search.html | 4 +- deps/npm/html/api/home.html | 60 -- deps/npm/html/api/init.html | 4 +- deps/npm/html/api/install.html | 4 +- deps/npm/html/api/link.html | 4 +- deps/npm/html/api/list.html | 88 --- deps/npm/html/api/ln.html | 74 --- deps/npm/html/api/load.html | 4 +- deps/npm/html/api/ls.html | 4 +- deps/npm/html/api/npm.html | 6 +- deps/npm/html/api/outdated.html | 4 +- deps/npm/html/api/owner.html | 4 +- deps/npm/html/api/pack.html | 4 +- deps/npm/html/api/prefix.html | 4 +- deps/npm/html/api/prune.html | 4 +- deps/npm/html/api/publish.html | 4 +- deps/npm/html/api/rebuild.html | 4 +- deps/npm/html/api/restart.html | 4 +- deps/npm/html/api/rm.html | 57 -- deps/npm/html/api/root.html | 4 +- deps/npm/html/api/run-script.html | 4 +- deps/npm/html/api/search.html | 4 +- deps/npm/html/api/set.html | 68 -- deps/npm/html/api/shrinkwrap.html | 4 +- deps/npm/html/api/start.html | 4 +- deps/npm/html/api/stop.html | 4 +- deps/npm/html/api/style.css | 336 ---------- deps/npm/html/api/submodule.html | 4 +- deps/npm/html/api/tag.html | 4 +- deps/npm/html/api/test.html | 4 +- deps/npm/html/api/uninstall.html | 4 +- deps/npm/html/api/unpublish.html | 4 +- deps/npm/html/api/update.html | 4 +- deps/npm/html/api/version.html | 4 +- deps/npm/html/api/view.html | 4 +- deps/npm/html/api/whoami.html | 4 +- deps/npm/html/doc/GubbleBum-Blocky.ttf | Bin 10292 -> 0 bytes deps/npm/html/doc/README.html | 4 +- deps/npm/html/doc/adduser.html | 4 +- deps/npm/html/doc/author.html | 69 -- deps/npm/html/doc/bin.html | 4 +- deps/npm/html/doc/bugs.html | 4 +- deps/npm/html/doc/build.html | 4 +- deps/npm/html/doc/bundle.html | 4 +- deps/npm/html/doc/cache.html | 4 +- deps/npm/html/doc/changelog.html | 4 +- deps/npm/html/doc/coding-style.html | 4 +- deps/npm/html/doc/completion.html | 4 +- deps/npm/html/doc/config.html | 4 +- deps/npm/html/doc/deprecate.html | 4 +- deps/npm/html/doc/developers.html | 4 +- deps/npm/html/doc/disputes.html | 4 +- deps/npm/html/doc/docs.html | 4 +- deps/npm/html/doc/edit.html | 4 +- deps/npm/html/doc/explore.html | 4 +- deps/npm/html/doc/faq.html | 4 +- deps/npm/html/doc/find.html | 75 --- deps/npm/html/doc/folders.html | 4 +- deps/npm/html/doc/get.html | 621 ------------------ deps/npm/html/doc/global.html | 240 ------- deps/npm/html/doc/help-search.html | 4 +- deps/npm/html/doc/help.html | 4 +- deps/npm/html/doc/home.html | 72 -- deps/npm/html/doc/index.html | 4 +- deps/npm/html/doc/init.html | 4 +- deps/npm/html/doc/install.html | 4 +- deps/npm/html/doc/json.html | 35 +- deps/npm/html/doc/link.html | 4 +- deps/npm/html/doc/list.html | 4 +- deps/npm/html/doc/ln.html | 93 --- deps/npm/html/doc/ls.html | 87 --- deps/npm/html/doc/npm.html | 6 +- deps/npm/html/doc/outdated.html | 4 +- deps/npm/html/doc/owner.html | 4 +- deps/npm/html/doc/pack.html | 4 +- deps/npm/html/doc/prefix.html | 4 +- deps/npm/html/doc/prune.html | 4 +- deps/npm/html/doc/publish.html | 4 +- deps/npm/html/doc/rebuild.html | 4 +- deps/npm/html/doc/registry.html | 4 +- deps/npm/html/doc/removing-npm.html | 4 +- deps/npm/html/doc/restart.html | 4 +- deps/npm/html/doc/rm.html | 57 -- deps/npm/html/doc/root.html | 4 +- deps/npm/html/doc/run-script.html | 4 +- deps/npm/html/doc/scripts.html | 4 +- deps/npm/html/doc/search.html | 4 +- deps/npm/html/doc/semver.html | 4 +- deps/npm/html/doc/set.html | 621 ------------------ deps/npm/html/doc/shrinkwrap.html | 4 +- deps/npm/html/doc/star.html | 4 +- deps/npm/html/doc/start.html | 4 +- deps/npm/html/doc/stop.html | 4 +- deps/npm/html/doc/submodule.html | 4 +- deps/npm/html/doc/tag.html | 4 +- deps/npm/html/doc/test.html | 4 +- deps/npm/html/doc/uninstall.html | 4 +- deps/npm/html/doc/unpublish.html | 4 +- deps/npm/html/doc/update.html | 4 +- deps/npm/html/doc/version.html | 4 +- deps/npm/html/doc/view.html | 4 +- deps/npm/html/doc/whoami.html | 4 +- deps/npm/html/dochead.html | 2 +- deps/npm/html/{doc => }/style.css | 35 +- deps/npm/html/webfonts/23242D_3_0.eot | Bin 0 -> 9662 bytes deps/npm/html/webfonts/23242D_3_0.ttf | Bin 0 -> 9356 bytes deps/npm/html/webfonts/23242D_3_0.woff | Bin 0 -> 4373 bytes deps/npm/lib/bugs.js | 24 +- deps/npm/lib/cache.js | 11 + deps/npm/lib/docs.js | 24 +- deps/npm/lib/install.js | 2 +- deps/npm/lib/utils/error-handler.js | 53 +- deps/npm/man/man1/README.1 | 2 +- deps/npm/man/man1/adduser.1 | 2 +- deps/npm/man/man1/bin.1 | 2 +- deps/npm/man/man1/bugs.1 | 2 +- deps/npm/man/man1/build.1 | 2 +- deps/npm/man/man1/bundle.1 | 2 +- deps/npm/man/man1/cache.1 | 2 +- deps/npm/man/man1/changelog.1 | 2 +- deps/npm/man/man1/coding-style.1 | 2 +- deps/npm/man/man1/completion.1 | 2 +- deps/npm/man/man1/config.1 | 2 +- deps/npm/man/man1/deprecate.1 | 2 +- deps/npm/man/man1/developers.1 | 2 +- deps/npm/man/man1/disputes.1 | 2 +- deps/npm/man/man1/docs.1 | 2 +- deps/npm/man/man1/edit.1 | 2 +- deps/npm/man/man1/explore.1 | 2 +- deps/npm/man/man1/faq.1 | 2 +- deps/npm/man/man1/folders.1 | 2 +- deps/npm/man/man1/help-search.1 | 2 +- deps/npm/man/man1/help.1 | 2 +- deps/npm/man/man1/index.1 | 2 +- deps/npm/man/man1/init.1 | 2 +- deps/npm/man/man1/install.1 | 2 +- deps/npm/man/man1/json.1 | 37 +- deps/npm/man/man1/link.1 | 2 +- deps/npm/man/man1/list.1 | 2 +- deps/npm/man/man1/npm.1 | 4 +- deps/npm/man/man1/outdated.1 | 2 +- deps/npm/man/man1/owner.1 | 2 +- deps/npm/man/man1/pack.1 | 2 +- deps/npm/man/man1/prefix.1 | 2 +- deps/npm/man/man1/prune.1 | 2 +- deps/npm/man/man1/publish.1 | 2 +- deps/npm/man/man1/rebuild.1 | 2 +- deps/npm/man/man1/registry.1 | 2 +- deps/npm/man/man1/removing-npm.1 | 2 +- deps/npm/man/man1/restart.1 | 2 +- deps/npm/man/man1/root.1 | 2 +- deps/npm/man/man1/run-script.1 | 2 +- deps/npm/man/man1/scripts.1 | 2 +- deps/npm/man/man1/search.1 | 2 +- deps/npm/man/man1/semver.1 | 2 +- deps/npm/man/man1/shrinkwrap.1 | 2 +- deps/npm/man/man1/star.1 | 2 +- deps/npm/man/man1/start.1 | 2 +- deps/npm/man/man1/stop.1 | 2 +- deps/npm/man/man1/submodule.1 | 2 +- deps/npm/man/man1/tag.1 | 2 +- deps/npm/man/man1/test.1 | 2 +- deps/npm/man/man1/uninstall.1 | 2 +- deps/npm/man/man1/unpublish.1 | 2 +- deps/npm/man/man1/update.1 | 2 +- deps/npm/man/man1/version.1 | 2 +- deps/npm/man/man1/view.1 | 2 +- deps/npm/man/man1/whoami.1 | 2 +- deps/npm/man/man3/bin.3 | 2 +- deps/npm/man/man3/bugs.3 | 2 +- deps/npm/man/man3/commands.3 | 2 +- deps/npm/man/man3/config.3 | 2 +- deps/npm/man/man3/deprecate.3 | 2 +- deps/npm/man/man3/docs.3 | 2 +- deps/npm/man/man3/edit.3 | 2 +- deps/npm/man/man3/explore.3 | 2 +- deps/npm/man/man3/help-search.3 | 2 +- deps/npm/man/man3/init.3 | 2 +- deps/npm/man/man3/install.3 | 2 +- deps/npm/man/man3/link.3 | 2 +- deps/npm/man/man3/load.3 | 2 +- deps/npm/man/man3/ls.3 | 2 +- deps/npm/man/man3/npm.3 | 4 +- deps/npm/man/man3/outdated.3 | 2 +- deps/npm/man/man3/owner.3 | 2 +- deps/npm/man/man3/pack.3 | 2 +- deps/npm/man/man3/prefix.3 | 2 +- deps/npm/man/man3/prune.3 | 2 +- deps/npm/man/man3/publish.3 | 2 +- deps/npm/man/man3/rebuild.3 | 2 +- deps/npm/man/man3/restart.3 | 2 +- deps/npm/man/man3/root.3 | 2 +- deps/npm/man/man3/run-script.3 | 2 +- deps/npm/man/man3/search.3 | 2 +- deps/npm/man/man3/shrinkwrap.3 | 2 +- deps/npm/man/man3/start.3 | 2 +- deps/npm/man/man3/stop.3 | 2 +- deps/npm/man/man3/submodule.3 | 2 +- deps/npm/man/man3/tag.3 | 2 +- deps/npm/man/man3/test.3 | 2 +- deps/npm/man/man3/uninstall.3 | 2 +- deps/npm/man/man3/unpublish.3 | 2 +- deps/npm/man/man3/update.3 | 2 +- deps/npm/man/man3/version.3 | 2 +- deps/npm/man/man3/view.3 | 2 +- deps/npm/man/man3/whoami.3 | 2 +- deps/npm/node_modules/chownr/package.json | 10 +- .../node_modules/fstream-npm/fstream-npm.js | 14 +- .../node_modules/fstream-ignore/package.json | 4 +- .../npm/node_modules/fstream-npm/package.json | 11 +- deps/npm/node_modules/mkdirp/README.markdown | 7 + deps/npm/node_modules/mkdirp/index.js | 25 +- deps/npm/node_modules/mkdirp/package.json | 12 +- .../node_modules/node-gyp/legacy/common.gypi | 15 +- .../tools/gyp/pylib/gyp/generator/make.py | 10 +- .../npm/node_modules/node-gyp/lib/node-gyp.js | 19 + .../node-gyp/node_modules/ansi/package.json | 7 +- .../node-gyp/node_modules/glob/package.json | 7 +- deps/npm/node_modules/node-gyp/package.json | 16 +- deps/npm/node_modules/uid-number/package.json | 9 +- deps/npm/package.json | 6 +- .../npm-test-ignore-nested-nm/package.json | 3 + .../npm-test-ignore-nested-nm/test.js | 2 + 238 files changed, 612 insertions(+), 3231 deletions(-) delete mode 100755 deps/npm/html/api/GubbleBum-Blocky.ttf delete mode 100644 deps/npm/html/api/author.html delete mode 100644 deps/npm/html/api/find.html delete mode 100644 deps/npm/html/api/get.html delete mode 100644 deps/npm/html/api/home.html delete mode 100644 deps/npm/html/api/list.html delete mode 100644 deps/npm/html/api/ln.html delete mode 100644 deps/npm/html/api/rm.html delete mode 100644 deps/npm/html/api/set.html delete mode 100644 deps/npm/html/api/style.css delete mode 100755 deps/npm/html/doc/GubbleBum-Blocky.ttf delete mode 100644 deps/npm/html/doc/author.html delete mode 100644 deps/npm/html/doc/find.html delete mode 100644 deps/npm/html/doc/get.html delete mode 100644 deps/npm/html/doc/global.html delete mode 100644 deps/npm/html/doc/home.html delete mode 100644 deps/npm/html/doc/ln.html delete mode 100644 deps/npm/html/doc/ls.html delete mode 100644 deps/npm/html/doc/rm.html delete mode 100644 deps/npm/html/doc/set.html rename deps/npm/html/{doc => }/style.css (84%) create mode 100644 deps/npm/html/webfonts/23242D_3_0.eot create mode 100644 deps/npm/html/webfonts/23242D_3_0.ttf create mode 100644 deps/npm/html/webfonts/23242D_3_0.woff create mode 100644 deps/npm/test/packages/npm-test-ignore-nested-nm/package.json create mode 100644 deps/npm/test/packages/npm-test-ignore-nested-nm/test.js diff --git a/deps/npm/AUTHORS b/deps/npm/AUTHORS index a2b8141d70..fcfa7f2b08 100644 --- a/deps/npm/AUTHORS +++ b/deps/npm/AUTHORS @@ -65,3 +65,4 @@ Jens Grunert Joost-Wim Boekesteijn Dalmais Maxence Marcus Ekwall +Aaron Stacy diff --git a/deps/npm/Makefile b/deps/npm/Makefile index 19efd815c9..2663075c65 100644 --- a/deps/npm/Makefile +++ b/deps/npm/Makefile @@ -121,6 +121,8 @@ docpublish: doc-publish doc-publish: doc rsync -vazu --stats --no-implied-dirs --delete html/doc/ npmjs.org:/var/www/npmjs.org/public/doc rsync -vazu --stats --no-implied-dirs --delete html/api/ npmjs.org:/var/www/npmjs.org/public/api + rsync -vazu --stats --no-implied-dirs --delete html/webfonts/ npmjs.org:/var/www/npmjs.org/public/webfonts + scp html/style.css npmjs.org:/var/www/npmjs.org/public/ zip-publish: release scp release/* npmjs.org:/var/www/npmjs.org/public/dist/ diff --git a/deps/npm/doc/cli/json.md b/deps/npm/doc/cli/json.md index ddd500e3b1..5f50cd2cfa 100644 --- a/deps/npm/doc/cli/json.md +++ b/deps/npm/doc/cli/json.md @@ -394,6 +394,7 @@ Git urls can be of the form: git://github.com/user/project.git#commit-ish git+ssh://user@hostname:project.git#commit-ish + git+ssh://user@hostname/project.git#commit-ish git+http://user@hostname/project/blah.git#commit-ish git+https://user@hostname/project/blah.git#commit-ish @@ -420,6 +421,36 @@ Array of package names that will be bundled when publishing the package. If this is spelled `"bundleDependencies"`, then that is also honorable. +## optionalDependencies + +If a dependency can be used, but you would like npm to proceed if it +cannot be found or fails to install, then you may put it in the +`optionalDependencies` hash. This is a map of package name to version +or url, just like the `dependencies` hash. The difference is that +failure is tolerated. + +It is still your program's responsibility to handle the lack of the +dependency. For example, something like this: + + try { + var foo = require('foo') + var fooVersion = require('foo/package.json').version + } catch (er) { + foo = null + } + if ( notGoodFooVersion(fooVersion) ) { + foo = null + } + + // .. then later in your program .. + + if (foo) { + foo.doFooThings() + } + +Entries in `optionalDependencies` will override entries of the same name in +`dependencies`, so it's usually best to only put in one place. + ## engines You can specify the version of diff --git a/deps/npm/html/api/GubbleBum-Blocky.ttf b/deps/npm/html/api/GubbleBum-Blocky.ttf deleted file mode 100755 index 8eac02f7ada5402c2fd8775f6bb5e94a5ee5c9f0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10292 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 - - author - - - - -
-

owner

Manage package owners

- -

SYNOPSIS

- -
npm.commands.owner(args, callback)
- -

DESCRIPTION

- -

The first element of the 'args' parameter defines what to do, and the subsequent -elements depend on the action. Possible values for the action are (order of -parameters are given in parenthesis):

- -
  • ls (package): -List all the users who have access to modify a package and push new versions. -Handy when you need to know who to bug for help.
  • add (user, package): -Add a new user as a maintainer of a package. This user is enabled to modify -metadata, publish new versions, and add other owners.
  • rm (user, package): -Remove a user from the package owner list. This immediately revokes their -privileges.
- -

Note that there is only one level of access. Either you can modify a package, -or you can't. Future versions may contain more fine-grained access levels, but -that is not implemented at this time.

- -

SEE ALSO

- - -
- - - diff --git a/deps/npm/html/api/bin.html b/deps/npm/html/api/bin.html index 110729f265..f6781bfa4f 100644 --- a/deps/npm/html/api/bin.html +++ b/deps/npm/html/api/bin.html @@ -2,7 +2,7 @@ bin - +
@@ -19,7 +19,7 @@

This function should not be used programmatically. Instead, just refer to the npm.bin member.

- + - diff --git a/deps/npm/html/api/get.html b/deps/npm/html/api/get.html deleted file mode 100644 index 46d372ad6b..0000000000 --- a/deps/npm/html/api/get.html +++ /dev/null @@ -1,68 +0,0 @@ - - - get - - - - -
-

config

Manage the npm configuration files

- -

SYNOPSIS

- -
npm.commands.config(args, callback)
-var val = npm.config.get(key)
-npm.config.set(key, val)
- -

DESCRIPTION

- -

This function acts much the same way as the command-line version. The first -element in the array tells config what to do. Possible values are:

- -

  • set

    Sets a config parameter. The second element in args is interpreted as the -key, and the third element is interpreted as the value.

  • get

    Gets the value of a config parameter. The second element in args is the -key to get the value of.

  • delete (rm or del)

    Deletes a parameter from the config. The second element in args is the -key to delete.

  • list (ls)

    Show all configs that aren't secret. No parameters necessary.

  • edit:

    Opens the config file in the default editor. This command isn't very useful -programmatically, but it is made available.

- -

To programmatically access npm configuration settings, or set them for -the duration of a program, use the npm.config.set and npm.config.get -functions instead.

- -

SEE ALSO

- - -
- - - diff --git a/deps/npm/html/api/help-search.html b/deps/npm/html/api/help-search.html index d0e8382579..86ba337e9a 100644 --- a/deps/npm/html/api/help-search.html +++ b/deps/npm/html/api/help-search.html @@ -2,7 +2,7 @@ help-search - +
@@ -32,7 +32,7 @@ Name of the file that matched

The silent parameter is not neccessary not used, but it may in the future.

- + - diff --git a/deps/npm/html/api/init.html b/deps/npm/html/api/init.html index 400e61a3d6..4e8b7f92f5 100644 --- a/deps/npm/html/api/init.html +++ b/deps/npm/html/api/init.html @@ -2,7 +2,7 @@ init - +
@@ -35,7 +35,7 @@ then go ahead and use this programmatically.

json(1)

- + - diff --git a/deps/npm/html/api/ln.html b/deps/npm/html/api/ln.html deleted file mode 100644 index 0629e06425..0000000000 --- a/deps/npm/html/api/ln.html +++ /dev/null @@ -1,74 +0,0 @@ - - - ln - - - - -
-

link

Symlink a package folder

- -

SYNOPSIS

- -
npm.command.link(callback)
-npm.command.link(packages, callback)
- -

DESCRIPTION

- -

Package linking is a two-step process.

- -

Without parameters, link will create a globally-installed -symbolic link from prefix/package-name to the current folder.

- -

With a parameters, link will create a symlink from the local node_modules -folder to the global symlink.

- -

When creating tarballs for npm publish, the linked packages are -"snapshotted" to their current state by resolving the symbolic links.

- -

This is -handy for installing your own stuff, so that you can work on it and test it -iteratively without having to continually rebuild.

- -

For example:

- -
npm.commands.link(cb)           # creates global link from the cwd
-                                # (say redis package)
-npm.commands.link('redis', cb)  # link-install the package
- -

Now, any changes to the redis package will be reflected in -the package in the current working directory

-
- - - diff --git a/deps/npm/html/api/load.html b/deps/npm/html/api/load.html index c88f9addd0..68ac853862 100644 --- a/deps/npm/html/api/load.html +++ b/deps/npm/html/api/load.html @@ -2,7 +2,7 @@ load - +
@@ -32,7 +32,7 @@ config object.

For a list of all the available command-line configs, see npm help config

- + - diff --git a/deps/npm/html/api/root.html b/deps/npm/html/api/root.html index b9c8c27202..174ca46117 100644 --- a/deps/npm/html/api/root.html +++ b/deps/npm/html/api/root.html @@ -2,7 +2,7 @@ root - +
@@ -21,7 +21,7 @@

This function is not useful programmatically.

- + - diff --git a/deps/npm/html/api/shrinkwrap.html b/deps/npm/html/api/shrinkwrap.html index 1b25f12882..8be37c6a93 100644 --- a/deps/npm/html/api/shrinkwrap.html +++ b/deps/npm/html/api/shrinkwrap.html @@ -2,7 +2,7 @@ shrinkwrap - +
@@ -26,7 +26,7 @@ but the shrinkwrap file will still be written.

Finally, 'callback' is a function that will be called when the shrinkwrap has been saved.

- + - diff --git a/deps/npm/html/doc/bin.html b/deps/npm/html/doc/bin.html index 043f6fd8da..c6252a6687 100644 --- a/deps/npm/html/doc/bin.html +++ b/deps/npm/html/doc/bin.html @@ -2,7 +2,7 @@ bin - + - + - diff --git a/deps/npm/html/doc/folders.html b/deps/npm/html/doc/folders.html index 1ee33de7f4..582305a55e 100644 --- a/deps/npm/html/doc/folders.html +++ b/deps/npm/html/doc/folders.html @@ -2,7 +2,7 @@ folders - +
@@ -205,7 +205,7 @@ cannot be found elsewhere. See json(1)
  • faq(1)
  • json(1)
  • install(1)
  • pack(1)
  • cache(1)
  • config(1)
  • publish(1)
    • - + - diff --git a/deps/npm/html/doc/global.html b/deps/npm/html/doc/global.html deleted file mode 100644 index 9904c30ce5..0000000000 --- a/deps/npm/html/doc/global.html +++ /dev/null @@ -1,240 +0,0 @@ - - - global - - - - -
    -

    folders

    Folder Structures Used by npm

    - -

    DESCRIPTION

    - -

    npm puts various things on your computer. That's its job.

    - -

    This document will tell you what it puts where.

    - -

    tl;dr

    - -
    • Local install (default): puts stuff in ./node_modules of the current -package root.
    • Global install (with -g): puts stuff in /usr/local or wherever node -is installed.
    • Install it locally if you're going to require() it.
    • Install it globally if you're going to run it on the command line.
    • If you need both, then install it in both places, or use npm link.
    - -

    prefix Configuration

    - -

    The prefix config defaults to the location where node is installed. -On most systems, this is /usr/local, and most of the time is the same -as node's process.installPrefix.

    - -

    On windows, this is the exact location of the node.exe binary. On Unix -systems, it's one level up, since node is typically installed at -{prefix}/bin/node rather than {prefix}/node.exe.

    - -

    When the global flag is set, npm installs things into this prefix. -When it is not set, it uses the root of the current package, or the -current working directory if not in a package already.

    - -

    Node Modules

    - -

    Packages are dropped into the node_modules folder under the prefix. -When installing locally, this means that you can -require("packagename") to load its main module, or -require("packagename/lib/path/to/sub/module") to load other modules.

    - -

    Global installs on Unix systems go to {prefix}/lib/node_modules. -Global installs on Windows go to {prefix}/node_modules (that is, no -lib folder.)

    - -

    If you wish to require() a package, then install it locally.

    - -

    Executables

    - -

    When in global mode, executables are linked into {prefix}/bin on Unix, -or directly into {prefix} on Windows.

    - -

    When in local mode, executables are linked into -./node_modules/.bin so that they can be made available to scripts run -through npm. (For example, so that a test runner will be in the path -when you run npm test.)

    - -

    Man Pages

    - -

    When in global mode, man pages are linked into {prefix}/share/man.

    - -

    When in local mode, man pages are not installed.

    - -

    Man pages are not installed on Windows systems.

    - -

    Cache

    - -

    See cache(1). Cache files are stored in ~/.npm on Posix, or -~/npm-cache on Windows.

    - -

    This is controlled by the cache configuration param.

    - -

    Temp Files

    - -

    Temporary files are stored by default in the folder specified by the -tmp config, which defaults to the TMPDIR, TMP, or TEMP environment -variables, or /tmp on Unix and c:\windows\temp on Windows.

    - -

    Temp files are given a unique folder under this root for each run of the -program, and are deleted upon successful exit.

    - -

    More Information

    - -

    When installing locally, npm first tries to find an appropriate -prefix folder. This is so that npm install foo@1.2.3 will install -to the sensible root of your package, even if you happen to have cded -into some other folder.

    - -

    Starting at the $PWD, npm will walk up the folder tree checking for a -folder that contains either a package.json file, or a node_modules -folder. If such a thing is found, then that is treated as the effective -"current directory" for the purpose of running npm commands. (This -behavior is inspired by and similar to git's .git-folder seeking -logic when running git commands in a working dir.)

    - -

    If no package root is found, then the current folder is used.

    - -

    When you run npm install foo@1.2.3, then the package is loaded into -the cache, and then unpacked into ./node_modules/foo. Then, any of -foo's dependencies are similarly unpacked into -./node_modules/foo/node_modules/....

    - -

    Any bin files are symlinked to ./node_modules/.bin/, so that they may -be found by npm scripts when necessary.

    - -

    Global Installation

    - -

    If the global configuration is set to true, then npm will -install packages "globally".

    - -

    For global installation, packages are installed roughly the same way, -but using the folders described above.

    - -

    Cycles, Conflicts, and Folder Parsimony

    - -

    Cycles are handled using the property of node's module system that it -walks up the directories looking for node_modules folders. So, at every -stage, if a package is already installed in an ancestor node_modules -folder, then it is not installed at the current location.

    - -

    Consider the case above, where foo -> bar -> baz. Imagine if, in -addition to that, baz depended on bar, so you'd have: -foo -> bar -> baz -> bar -> baz .... However, since the folder -structure is: foo/node_modules/bar/node_modules/baz, there's no need to -put another copy of bar into .../baz/node_modules, since when it calls -require("bar"), it will get the copy that is installed in -foo/node_modules/bar.

    - -

    This shortcut is only used if the exact same -version would be installed in multiple nested node_modules folders. It -is still possible to have a/node_modules/b/node_modules/a if the two -"a" packages are different versions. However, without repeating the -exact same package multiple times, an infinite regress will always be -prevented.

    - -

    Another optimization can be made by installing dependencies at the -highest level possible, below the localized "target" folder.

    - -

    Example

    - -

    Consider this dependency graph:

    - -
    foo
-+-- blerg@1.2.5
-+-- bar@1.2.3
-|   +-- blerg@1.x (latest=1.3.7)
-|   +-- baz@2.x
-|   |   `-- quux@3.x
-|   |       `-- bar@1.2.3 (cycle)
-|   `-- asdf@*
-`-- baz@1.2.3
-    `-- quux@3.x
-        `-- bar
    - -

    In this case, we might expect a folder structure like this:

    - -
    foo
-+-- node_modules
-    +-- blerg (1.2.5) <---[A]
-    +-- bar (1.2.3) <---[B]
-    |   +-- node_modules
-    |   |   `-- baz (2.0.2) <---[C]
-    |   |       `-- node_modules
-    |   |           `-- quux (3.2.0)
-    |   `-- asdf (2.3.4)
-    `-- baz (1.2.3) <---[D]
-        `-- node_modules
-            `-- quux (3.2.0) <---[E]
    - -

    Since foo depends directly on bar@1.2.3 and baz@1.2.3, those are -installed in foo's node_modules folder.

    - -

    Even though the latest copy of blerg is 1.3.7, foo has a specific -dependency on version 1.2.5. So, that gets installed at [A]. Since the -parent installation of blerg satisfie's bar's dependency on blerg@1.x, -it does not install another copy under [B].

    - -

    Bar [B] also has dependencies on baz and asdf, so those are installed in -bar's node_modules folder. Because it depends on baz@2.x, it cannot -re-use the baz@1.2.3 installed in the parent node_modules folder [D], -and must install its own copy [C].

    - -

    Underneath bar, the baz->quux->bar dependency creates a cycle. -However, because bar is already in quux's ancestry [B], it does not -unpack another copy of bar into that folder.

    - -

    Underneath foo->baz [D], quux's [E] folder tree is empty, because its -dependency on bar is satisfied by the parent folder copy installed at [B].

    - -

    For a graphical breakdown of what is installed where, use npm ls.

    - -

    Publishing

    - -

    Upon publishing, npm will look in the node_modules folder. If any of -the items there are not in the bundledDependencies array, then they will -not be included in the package tarball.

    - -

    This allows a package maintainer to install all of their dependencies -(and dev dependencies) locally, but only re-publish those items that -cannot be found elsewhere. See json(1) for more information.

    - -

    SEE ALSO

    - - -
    - - - diff --git a/deps/npm/html/doc/help-search.html b/deps/npm/html/doc/help-search.html index 7690a717ee..fd85377665 100644 --- a/deps/npm/html/doc/help-search.html +++ b/deps/npm/html/doc/help-search.html @@ -2,7 +2,7 @@ help-search - +
    @@ -38,7 +38,7 @@ where the terms were found in the documentation.

    - + - diff --git a/deps/npm/html/doc/index.html b/deps/npm/html/doc/index.html index 9082ff85ba..84d6d3443b 100644 --- a/deps/npm/html/doc/index.html +++ b/deps/npm/html/doc/index.html @@ -2,7 +2,7 @@ index - +
    @@ -384,7 +384,7 @@

    Display npm username

    - + - diff --git a/deps/npm/html/doc/ls.html b/deps/npm/html/doc/ls.html deleted file mode 100644 index 9ad1fca278..0000000000 --- a/deps/npm/html/doc/ls.html +++ /dev/null @@ -1,87 +0,0 @@ - - - ls - - - - -
    -

    ls

    List installed packages

    - -

    SYNOPSIS

    - -
    npm list
-npm ls
-npm la
-npm ll
    - -

    DESCRIPTION

    - -

    This command will print to stdout all the versions of packages that are -installed, as well as their dependencies, in a tree-structure.

    - -

    It does not take positional arguments, though you may set config flags -like with any other command, such as -g to list global packages.

    - -

    It will print out extraneous, missing, and invalid packages.

    - -

    When run as ll or la, it shows extended information by default.

    - -

    CONFIGURATION

    - -

    long

    - -
    • Default: false
    • Type: Boolean
    - -

    Show extended information.

    - -

    parseable

    - -
    • Default: false
    • Type: Boolean
    - -

    Show parseable output instead of tree view.

    - -

    global

    - -
    • Default: false
    • Type: Boolean
    - -

    List packages in the global install prefix instead of in the current -project.

    - -

    SEE ALSO

    - - -
    - - - diff --git a/deps/npm/html/doc/npm.html b/deps/npm/html/doc/npm.html index 6f71723b2c..0d5a069420 100644 --- a/deps/npm/html/doc/npm.html +++ b/deps/npm/html/doc/npm.html @@ -2,7 +2,7 @@ npm - +
    @@ -14,7 +14,7 @@

    VERSION

    -

    1.1.23

    +

    1.1.24

    DESCRIPTION

    @@ -135,7 +135,7 @@ will no doubt tell you to put the output in a gist or email.

    - + - diff --git a/deps/npm/html/doc/root.html b/deps/npm/html/doc/root.html index ea583953c8..bdb274d227 100644 --- a/deps/npm/html/doc/root.html +++ b/deps/npm/html/doc/root.html @@ -2,7 +2,7 @@ root - + - + - diff --git a/deps/npm/html/doc/shrinkwrap.html b/deps/npm/html/doc/shrinkwrap.html index 5e9a401723..e0d115e149 100644 --- a/deps/npm/html/doc/shrinkwrap.html +++ b/deps/npm/html/doc/shrinkwrap.html @@ -2,7 +2,7 @@ shrinkwrap - +
    @@ -169,7 +169,7 @@ versions.

    - +