"Fossies" - the Fresh Open Source Software Archive

Member "Atom/resources/app/apm/node_modules/npm-registry-client/README.md" (25 Nov 2016, 11370 Bytes) of archive /windows/misc/atom-windows.zip:


As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format). Alternatively you can here view or download the uninterpreted source code file. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

npm-registry-client

The code that npm uses to talk to the registry.

It handles all the caching and HTTP calls.

Usage

var RegClient = require('npm-registry-client')
var client = new RegClient(config)
var uri = "https://registry.npmjs.org/npm"
var params = {timeout: 1000}

client.get(uri, params, function (error, data, raw, res) {
  // error is an error if there was a problem.
  // data is the parsed data object
  // raw is the json string
  // res is the response from couch
})

Registry URLs

The registry calls take either a full URL pointing to a resource in the registry, or a base URL for the registry as a whole (including the registry path – but be sure to terminate the path with /). http and https URLs are the only ones supported.

Using the client

Every call to the client follows the same pattern:

Credentials

Many requests to the registry can by authenticated, and require credentials for authorization. These credentials always look the same:

or

API

client.access(uri, params, cb)

Set the access level for scoped packages. For now, there are only two access levels: "public" and "restricted".

client.adduser(uri, params, cb)

Add a user account to the registry, or verify the credentials.

client.deprecate(uri, params, cb)

Deprecate a version of a package in the registry.

client.distTags.fetch(uri, params, cb)

Fetch all of the dist-tags for the named package.

client.distTags.add(uri, params, cb)

Add (or replace) a single dist-tag onto the named package.

client.distTags.set(uri, params, cb)

Set all of the dist-tags for the named package at once, creating any dist-tags that do not already exit. Any dist-tags not included in the distTags map will be removed.

client.distTags.update(uri, params, cb)

Update the values of multiple dist-tags, creating any dist-tags that do not already exist. Any pre-existing dist-tags not included in the distTags map will be left alone.

client.distTags.rm(uri, params, cb)

Remove a single dist-tag from the named package.

client.get(uri, params, cb)

Fetches data from the registry via a GET request, saving it in the cache folder with the ETag or the "Last Modified" timestamp.

client.publish(uri, params, cb)

Publish a package to the registry.

Note that this does not create the tarball from a folder.

client.star(uri, params, cb)

Star or unstar a package.

Note that the user does not have to be the package owner to star or unstar a package, though other writes do require that the user be the package owner.

client.stars(uri, params, cb)

View your own or another user's starred packages.

client.tag(uri, params, cb)

Mark a version in the dist-tags hash, so that pkg@tag will fetch the specified version.

client.unpublish(uri, params, cb)

Remove a version of a package (or all versions) from the registry. When the last version us unpublished, the entire document is removed from the database.

client.whoami(uri, params, cb)

Simple call to see who the registry thinks you are. Especially useful with token-based auth.

PLUMBING

The below are primarily intended for use by the rest of the API, or by the npm caching logic directly.

client.request(uri, params, cb)

Make a generic request to the registry. All the other methods are wrappers around client.request.

client.fetch(uri, params, cb)

Fetch a package from a URL, with auth set appropriately if included. Used to cache remote tarballs as well as request package tarballs from the registry.

Configuration

The client uses its own configuration, which is just passed in as a simple nested object. The following are the supported values (with their defaults, if any):