npm

Join us for the "JavaScript Supply Chain Security" tech talk, presented by VP of Security, Adam Baldwin. 6/20 at 10am PT.Sign up here »

package-json-to-readme

2.1.1 • Public • Published

package-json-to-readme Build Status

Generate a README.md from package.json contents. Works with node and io.js.

Why?

Every project worth its salt has a README that answers (at least) the following questions:

  • What's it called?
  • What is it for?
  • How do I install it?
  • How do I use it?
  • How do I test it?
  • What is the license?

With npm modules, most of that info can be gleaned from properties in the package.json file: name, description, scripts.test, preferGlobal, etc. That's why package-json-to-readme exists. Use it to generate a decent boilerplate README, then iterate from there.

Installation

npm i -g package-json-to-readme

Usage

# Write to stdout 
readme package.json
 
# Pipe output into a new file 
readme package.json > README.md
 
# Add a Travis badge 
readme package.json --travis
 
# Run tests and add their output 
readme package.json --tests
 
# Do it all 
readme package.json --tests --travis > README.md
 
# If your package has an example.sh or example.js file, it will be used to 
# generate a usage section like this one. 
 
# If your example.js has a require("./") statement, the relative path will be 
# replaced with the package name. 

Tests

npm install
npm test

Dependencies

  • github-url-to-object: Extract user, repo, and other interesting properties from GitHub URLs
  • hogan.js: A mustache compiler.
  • strip-ansi: Strip ANSI escape codes
  • sync-exec: Synchronous exec with status code support. Requires no external dependencies, no need for node-gyp compilations etc.
  • yargs: Light-weight option parsing with an argv hash. No optstrings attached.

Dev Dependencies

  • mocha: simple, flexible, fun test framework
  • nixt: Simple and powerful testing for command-line apps

License

MIT

See Also

  • mos, a pluggable module that injects content into your markdown files via hidden JavaScript snippets.

install

npm i package-json-to-readme

Downloadsweekly downloads

1,002

version

2.1.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability