Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    list-methodspublic

    list-methods NPM version

    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.

    Quickstart

    Install globally with npm:

    npm i -g list-methods

    API

    methods

    • src {String}: The file to read.
    • return {Object} Returns an object with the source file name and the array of methods.

    .writeFile

    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}

    .writeDataFile

    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}

    Example output

    ## writeDataFile
    Type: `undefined`
     
    Default: `undefined`
     
    ## writeFile
    Type: `undefined`
     
    Default: `undefined`

    CLI

    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.

    args

    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 significant

    Dest extension:

    • .yml: generates a YAML file
    • .md: generates a markdown file

    template

    Methods 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
    built-in templates

    There are three built-in templates:

    • list: generates a simple, bullet list of methods
    • docs: 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 Assemble
    custom templates

    The 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

    Author

    Jon Schlinkert

    License

    Copyright (c) 2014 Jon Schlinkert Released under the MIT license


    This file was generated by verb-cli on July 12, 2014.

    install

    npm i list-methods

    Downloadsweekly downloads

    39

    version

    0.3.3

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar