Home

Awesome

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

topics

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

Params

Example

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

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

.request

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

Params

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)

.get

List all topics for a repository.

Params

Example

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

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

.put

Replace all topics for a repository.

Params

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)

.patch

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

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)

.normalize

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

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

CommitsContributor
10jonschlinkert
2doowb

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.