call-signature

call-signature

Parse / Generate Method Signatures

Install

$ npm install --save call-signature

Usage

const signature = require('call-signature');

// parse a call signature definition
var parsed = signature.parse('t.equal(expected, actual, [message])');

console.log(parsed);
/* =>  
       {
         object: 't',
         member: 'equal',
         args: [
           {
             name: 'actual',
             optional: false
           },
           {
             name: 'expected',
             optional: false
           },
           {
             name: 'message',
             optional: true
           }
         ]
       }
*/


// Create signature definitions from the parsed object.
signature.generate(parsed);

//=> "t.equal(expected, actual, [message])"

API

callSignature.parse(input)

input

Type: string

A string that matches the call signature spec:

object.member(required_arg1, required_arg2, [optional_arg1])

object and member can be any identifiers, but currently the callee must be a MemberExpression (that requirement may loosen in the future).

You can have any number of arguments. Optional arguments are denoted by placing the argument name between square [brackets].

returns

A simple JS Object with three properties object, member, and args.

object and member will be strings.

args will be an array. Each item of the array will have two properties name, and optional. name will be the string name of the arg. optional will be a boolean value.

callSignature.generate(parsed)

input

Type: Object

Must have the same definition as the return value from the parse method.

returns

A string signature definition that will parse to exactly the provided input.

Related

• escallmatch - Similar, with compatible string definitions to this library. Can be used to match AST Nodes to parsed signatures.

License

MIT © James Talmage