npm-api

Node.js library for getting info from NPM’s API

Please consider following this project's author, Brian Woodward, and consider starring the project to show your :heart: and support.

Install

Install with npm:

1$ npm install --save npm-api

Usage

1var NpmApi = require('npm-api');

API

NpmApi

NpmApi constructor. Create an instance to work with maintainer and repository information.

Example

1let npm = new NpmApi();

.view

Create a new instance of View or get an existing instance to work with npm couchdb views.

Params

• name {String}: Name of the couchdb view to work with.
• returns {Object} View: instance

Example

1var view = npm.view('byUser');

.list

Create a new instance of List or get an existing instance to work with npm couchdb list.

Params

• name {String}: Name of the couchdb list to work with.
• view {String|Object}: Name or instance of a view to work with.
• returns {Object} List: instance

Example

1var list = npm.list('sortCount', 'byUser');

.repo

Create an instance of a repo to work with.

Params

• name {String}: Name of the repo as it's published to npm.
• returns {Object}: Instance of a Repo model to work with.

Example

1var repo =  npm.repo('micromatch');

.maintainer

Create an instance of a maintainer to work with.

Params

• name {String}: Npm username of the maintainer.
• returns {Object}: Instance of a Maintainer model to work with.

Example

1var maintainer =  npm.maintainer('doowb');

Models

BaseModel

Base model to include common plugins.

Params

• store {Object}: Cache store instance to use.

Maintainer

Maintainer constructor. Create an instance of an npm maintainer by maintainer name.

Params

• name {String}: Name of the npm maintainer to get information about.

Example

1const maintainer = new Maintainer('doowb');

.repos

Get the repositories owned by this maintainer.

• returns {Promise}: Returns array of repository names when promise resolves.

Example

1maintainer.repos()
2  .then(function(repos) {
3    console.log(repos);
4  }, function(err) {
5    console.error(err);
6  });

Repo

Repo constructor. Create an instance of an npm repo by repo name.

Params

• name {String}: Name of the npm repo to get information about.

Example

1const repo = new Repo('micromatch');

.package

Get the repo's published package.json.

• returns {Promise}: Returns the package.json object when promise resolves.

Example

1repo.package()
2  .then(function(pkg) {
3    console.log(pkg);
4  }, function(err) {
5    console.error(err);
6  });

.version

Get the repo's published package.json value for the specified version.

Params

• version {String}: Specific version to retrieve.
• returns {Promise}: Returns the package.json object for the specified version when promise resolves.

Example

1repo.version('0.2.0')
2  .then(function(pkg) {
3    console.log(pkg);
4  }, function(err) {
5    console.error(err);
6  });

.dependencies

Get the repo's dependencies for the specified version.

Params

• version {String}: Specific version to retrieve. Defaults to latest.
• returns {Promise}: Returns the dependencies object for the specified version when promise resolves.

Example

1repo.dependencies()
2  .then(function(dependencies) {
3    console.log(dependencies);
4  }, function(err) {
5    console.error(err);
6  });

.devDependencies

Get the repo's devDependencies for the specified version.

Params

• version {String}: Specific version to retrieve. Defaults to latest.
• returns {Promise}: Returns the devDependencies object for the specified version when promise resolves.

Example

1repo.devDependencies()
2  .then(function(devDependencies) {
3    console.log(devDependencies);
4  }, function(err) {
5    console.error(err);
6  });

.prop

Get the specified property from the repo's package.json for the specified version.

Params

• prop {String}: Name of the property to get.
• version {String}: Specific version to retrieve. Defaults to latest.
• returns {Promise}: Returns the property for the specified version when promise resolves.

Example

1repo.prop('author')
2  .then(function(author) {
3    console.log(author);
4  }, function(err) {
5    console.error(err);
6  });

Registry queries

View

View constructor. Create an instance of a view associated with a couchdb view in the npm registry.

Params

• name {String}: Name of couchdb view to use.
• returns {Object}: instance of View

Example

1const view = new View('dependedUpon');

.query

Query the couchdb view with the provided parameters.

Params

• params {Object}: URL query parameters to pass along to the couchdb view.
• returns {Promise}: Results of the query when promise is resolved.

Example

1let results = await view.query({
2  group_level: 2,
3  startkey: JSON.stringify(['micromatch']),
4  endkey: JSON.stringify(['micromatch', {}])
5});

.stream

Query the couchdb view with the provided parameters and return a stream of results.

Params

• params {Object}: URL query parameters to pass along to the couchdb view.
• returns {Stream}: Streaming results of the query.

Example

1view.stream({
2  group_level: 2,
3  startkey: JSON.stringify(['micromatch']),
4  endkey: JSON.stringify(['micromatch', {}])
5})
6.on('data', (data) => {
7  console.log(data);
8});

.url

Build a formatted url with the provided parameters.

Params

• query {Object}: URL query parameters.
• returns {String}: formatted url string

List

List constructor. Create an instance of a list associated with a couchdb list in the npm registry.

Params

• name {String}: Name of couchdb list to use.
• view {Object}: Instance of a View to use with the list.
• returns {Object}: instance of List

Example

1let list = new List('dependedUpon', view);

.query

Query the couchdb list with the provided parameters.

Params

• params {Object}: URL query parameters to pass along to the couchdb list.
• returns {Promise}: Results of the query when promise is resolved.

Example

1let results = await list.query({ key: JSON.stringify(['micromatch']) })

.url

Build a formatted url with the provided parameters.

Params

• query {Object}: URL query parameters.
• returns {String}: formatted url string

About

1$ npm install && npm test

1$ npm install -g verbose/verb#dev verb-generate-readme && verb

Related projects

You might also be interested in these projects:

• base: Framework for rapidly creating high quality, server-side node.js applications, using plugins like building blocks | homepage
• download-stats: Get and calculate npm download stats for npm modules. | homepage

Contributors

Author

Brian Woodward

• GitHub Profile
• Twitter Profile
• LinkedIn Profile

License

Copyright © 2021, Brian Woodward. Released under the MIT License.

This file was generated by verb-generate-readme, v0.8.0, on January 20, 2021.