stringify-authors

stringify-authors

Converts an author object or array of author objects into an array of strings. Useful for adding authors, maintainers or contributors to documentation, package.json or a readme.

Install

Install with npm

$ npm i stringify-authors --save

Usage

var authors = require('stringify-authors');

Given an array of author objects:

var authors = [{
  name: 'Jon Schlinkert',
  email: '[e-mail]',
  url: 'https://github.com/jonschlinkert'
}, {
  name: 'Brian Woodward',
  url: 'https://github.com/doowb',
  email: '[e-mail]'
}]

// default separator is ', '
stringify(authors, {sep: '\n'});

results in:

Jon Schlinkert <[e-mail]> (https://github.com/jonschlinkert)
Brian Woodward <[e-mail]> (https://github.com/doowb)

Filter with glob patterns

stringify(authors, {filter: 'name'});
//=> Jon Schlinkert, Brian Woodward

stringify(authors, {filter: '{name,url}', sep: '\n'});
// Jon Schlinkert (https://github.com/jonschlinkert)
// Brian Woodward (https://github.com/doowb)

Related

• author-regex: Regular expression for parsing an author string into an object following npm conventions. | homepage
• parse-author: Parse a string into an object with name, email and url properties following npm conventions.… more | homepage
• parse-authors: Parse a string into an array of objects with name, email and url properties following… more | homepage
• stringify-author: Stringify an authors object to name <email> (url). | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

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

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.

This file was generated by verb-cli on November 16, 2015.