create-readme
v2.1.3
Published
Automatically creates README.md based on package.json and other existing files.
Downloads
4,720
Readme
create-readme
Automatically creates README.md based on package.json and other existing files.
Usage
Configuration options can also be set in package.json's config.readme.
# API use
# Default options, explained in documentation
options = {
debug: false
silent: false
encoding: 'utf-8'
addDescription: ''
addUsage: ''
modules: ['CommonJS']
unpkg: false
licenseFile: 'LICENSE'
badges: ['npm-version', 'travis', 'coveralls', 'dependencies', 'devDependencies', 'gitter']
branch: 'master'
replaceModuleReferences: true
filename: 'README.md'
}
ReadmeCreator = require 'create-readme'
readmeCreator = new ReadmeCreator(options)
data = readmeCreator.parse()
content = readmeCreator.render data
readme = readmeCreator.write content
readme.catch (err) ->
throw err
process.exitCode = 1
readme-creator --encoding utf-8 --add-description "" --addUsage "" \
--modules CommonJS --no-unpkg --license-file LICENSE.txt \
--badges npm-version,travis,coveralls,dependencies,devDependencies,gitter \
--branch master \
README.md
Installation
Download node at nodejs.org and install it, if you haven't already.
npm install create-readme --save
This package is provided in these module formats:
- CommonJS
Documentation
You can find a documentation here.
Dependencies
- bluebird: Full featured Promises/A+ implementation with exceptionally good performance
- commander: the complete solution for node.js command-line programs
- debug: small debugging utility
- github-url-to-object: Extract user, repo, and other interesting properties from GitHub URLs
- mustache: Logic-less {{mustache}} templates with JavaScript
- require-all:
Dev Dependencies
- @lluis/codo: A CoffeeScript documentation generator.
- @semantic-release/changelog: semantic-release plugin to create or update a changelog file
- coffee-script: Unfancy JavaScript
- coffeelint: Lint your CoffeeScript
- coffeelint-no-mocha-only: This CoffeeLint plugin verifies there are no describe.only's or it.only's left in mocha tests
- coffeelint-variable-scope: CoffeeLint rule that warn you when you accidentally overwrite outer scope variable
- coveralls: takes json-cov output into stdin and POSTs to coveralls.io
- ghooks: Simple git hooks
- mock-fs: A configurable mock file system. You know, for testing.
- nodemon: Simple monitor script for use during development of a node.js app.
- npm-build-tools: Cross-platform command-line tools to help use npm as a build tool.
- nsp: The Node Security (nodesecurity.io) command line interface
- proxyquire: Proxies nodejs require in order to allow overriding dependencies during testing.
- semantic-release: Automated semver compliant package publishing
- test-coffee-module: run tests on .coffee files with sensible defaults
- validate-commit-msg: Script to validate a commit message follows the conventional changelog standard