❤
npm
Sign UpSign In

doc-fn

0.1.1 • Public • Published

doc-fn

Adds 'docstring' style comments to functions, accessible programmatically.

Why

Firing up a REPL and finding documentation at your fingertips is an awesome experience in languages like python or clojure. Let's get some goodness into javascript

Example

var doc = require('doc-fn')
 
var inc = doc(function(a){
    /// signature: number -> number
    /// takes a number, and returns that number + 1
    return a + 1
})
 
console.log(inc.doc)
/* console output: 
    signature: number -> number
    takes a number, and returns that number + 1
*/

API

doc (fn) -> fn

mutates a function to add a doc property, which includes all comments starting with /// at the top of a function. Also adds a .docs property, containing a map of 'section names' to 'vals', for every line with the format '/// section name: value'.

 
var inc = doc(function(){
    /// signature: number -> number
    /// takes a number, and returns that number + 1
    return a + 1
})
 
console.log(inc.doc)
/* console output: 
    signature: number -> number
    takes a number, and returns that number + 1
*/
 
console.log(inc.docs.signature)
// console output: number -> number 

doc.merge (object) -> object

adds a getter to put the .doc property on all inhereting functions

doc.merge(Function.prototype) // adds .doc to all functions

Install

npm install doc-fn

Readme

Keywords

none

Package Sidebar

Install

npm i doc-fn

Repository

github.com/hughfdjackson/doc-fn

Homepage

github.com/hughfdjackson/doc-fn#readme

Weekly Downloads

1

Version

0.1.1

License

BSD

Last publish

Collaborators

  • hughfdjackson
Try on RunKit
Report malware