Skip to content

jonschlinkert/topics

Repository files navigation

topics NPM version NPM monthly downloads NPM total downloads Linux Build Status

Get and update GitHub repository topics.

Follow this project's author, Jon Schlinkert, for updates on this project and others.

Install

Install with npm:

$ npm install --save topics

Usage

This library uses github-base. Visit that library's github repository for documentation about all available options and authentication options.

var topics = require('topics');

Example response

Status: 200 OK

{
  "names": [
    "octocat",
    "atom",
    "electron",
    "API"
  ]
}

API

List all topics for a repository. The main export is a function that calls the .get method.

Params

  • owner {String}: Either owner/repo combination, or owner if repo is the second argument.
  • repo {String|Object}: Repository name or options.
  • options {Object}
  • returns {Promise}

Example

var options = {
  username: 'your_username',
  password: 'your_password'
};

topics('micromatch/micromatch', options)
  .then(function(topics) {
    console.log('topics', topics);
  })
  .catch(console.error)

Create a topics request with the given method, owner, repo and options.

Params

  • method {String}
  • owner {String}: Either owner/repo combination, or owner if repo is the second argument.
  • repo {String|Object}: Repository name or options.
  • options {Object}
  • returns {Promise}

Example

var options = {
  username: 'your_username',
  password: 'your_password'
};

topics.request('get', 'micromatch', 'micromatch', options)
  .then(function(topics) {
    console.log('topics', topics);
  })
  .catch(console.error)

List all topics for a repository.

Params

  • owner {String}: Either owner/repo combination, or owner if repo is the second argument.
  • repo {String|Object}: Repository name or options.
  • options {Object}
  • returns {Promise}

Example

var options = {
  username: 'your_username',
  password: 'your_password'
};

topics.get('micromatch/micromatch', options)
  .then(function(topics) {
    console.log('topics', topics);
  })
  .catch(console.error)

Replace all topics for a repository.

Params

  • owner {String}: Either owner/repo combination, or owner if repo is the second argument.
  • repo {String|Object}: Repository name or options.
  • options {Object}
  • returns {Promise}

Example

var options = {
  username: 'your_username',
  password: 'your_password',

  // new topics to use (overwrites all existing topics)
  names: [
    'foo',
    'bar',
    'baz'
  ]
};

topics.put('micromatch/micromatch', options)
  .then(function(topics) {
    console.log('topics', topics);
  })
  .catch(console.error)

Gets all topics for a repository and then replaces the existing topics with one or more additional topics defined on options.names. Send an empty array (`[]

Params

  • owner {String}: Either owner/repo combination, or owner if repo is the second argument.
  • repo {String|Object}: Repository name or options.
  • options {Object}
  • returns {Promise}

Example

var options = {
  username: 'your_username',
  password: 'your_password',

  // new topics to use (overwrites all existing topics)
  names: [
    'foo',
    'bar',
    'baz'
  ]
};

topics.patch('micromatch/micromatch', options)
  .then(function(topics) {
    console.log('topics', topics);
  })
  .catch(console.error)

Utility for normalizing options. This is already used in necessary places in the other request methods, but it's exposed for unit tests and debugging.

Params

  • owner {String}
  • repo {String}
  • options {String}
  • returns {Object}: Returns the options object to use with the request methods.

About

Related projects

You might also be interested in these projects:

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Please read the contributing guide for advice on opening issues, pull requests, and coding standards.

Contributors

Commits Contributor
10 jonschlinkert
2 doowb

Building docs

(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

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

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test

Author

Jon Schlinkert

License

Copyright © 2017, Jon Schlinkert. Released under the MIT License.


This file was generated by verb-generate-readme, v0.6.0, on August 21, 2017.