$ npm install list-methods -g
Easily generate a JSON or markdown list (sorted array) of property names of all enumerable properties, own and inherited, of objects that have function values.
Install globally with npm:
npm i -g list-methods
src
{String}: The file to read.return
{Object} Returns an object with the source file name
and the array of methods
.As a way of kickstarting documentation, this writes the list of methods to a text file. Lodash templates are used to generate the file, so the output is completely customizable.
Example:
methods.writeFile('api.md', 'index.js');
// generates a file, "api.md", using a template in lib/templates.js
Params:
dest
{String}:src
{String}:options
{String}:return
{String}Generate a JSON or YAML file from the list of methods. Automatically detects the format to use based on the given file extension.
Examples:
methods.writeDataFile('api.yml', 'index.js');
// generates a YAML file, "api.yml" using a template in lib/templates.js
methods.writeDataFile('api.json', 'index.js');
// generates a JSON file, "api.json" using a template in lib/templates.js
Params:
dest
{String}:src
{String}:return
{String}## writeDataFile
Type: `undefined`
Default: `undefined`
## writeFile
Type: `undefined`
Default: `undefined`
Run the methods
command without any arguments and a markdown file will be generated for index.js
, or the first javascript file found in the current directory.
If you want to specify the source file to read, or the destination to write to, you can use this format:
methods [src] [dest]
Or:
-s
| --src
: reads the specified source file-d
| --dest
: the destination path and file to write. note that extension is significantDest extension:
.yml
: generates a YAML file.md
: generates a markdown fileMethods uses Lo-Dash templates, so they're super fast and easy to extend. There are a couple of ways you can specify the template to use.
Either as a third argument:
methods [src] [dest] [template]
Or with -t
or --template
:
methods -t docs
There are three built-in templates:
list
: generates a simple, bullet list of methodsdocs
: generates a formatted markdown file, giving each method its own section with starter content for type
and default
, etc.yaml
: similar to docs, but outputs YAML. this is useful if you want to update and extend this file with other tools, like Verb or AssembleThe only context passed to the templates is the array of properties generated. Example:
module.exports = [
'# <%= data.name %> properties\n\n',
'<% _.forEach(data, function(fn) { %>',
'* <%- fn %>\n',
'<% }); %>'
].join('');
You can either specify the filepath to the custom template, or the name of a npm module that is installed locally, and methods will try to use it:
methods -t my-template
Jon Schlinkert
Copyright (c) 2014 Jon Schlinkert Released under the MIT license
This file was generated by verb-cli on July 12, 2014.
© 2010 - cnpmjs.org x YWFE | Home | YWFE