cdocparser

CDocParser

CDocParser is a language agonistc C style comments parser that uses block comments to make it easer to generate documenation.

Install

npm install --save cdocparser

Usage

CDocParser consists of two parts the CommentExtractor and a CommentParser.

var CDocParser = require('cdocparser');
var extractor = new CDocParser.CommentExtractor( /* contextParser */ );
var parser = new CDocParser.CommentParser(/* Annotations */);


var comments = extractor.extract( /* code */);
var parsedComments = parser.parse( comments );

console.log(parsedComments);

API

CommentExtractor

The ComemntExtractor is used to extract C-Style comments from source and attach context infromation to it.

new CommentExtractor( contextParser )

Create a CommentExtractor to extract block comment like:

/**
 *
 *  CDocComment
 *
 */

You need to pass in a function that is used to generate a context object used to specify the context of the, comment. A context obj:

{
  type : 'contextType'
}

The type attribute is mandatory, you can add as much attributes as you would like.

#extract(code)

This method will return an Array of all comments in the form of

[
  { lines : {}, context : [context object generated by contextParser] }
]

CommentParser

new CommentParser( annotations )

Create a new CommentParser where annotaions is an object like:

{
  _  : {
    alias : {
      'aliasName' : 'aRealAnnotation'
    }
  },

  aRealAnnotation : function( annotationLine ){

  }
}

This object is used to provide parser for various types of annotations. It also includes tha ability to include aliases.

#parse ( comments )

This methods takes an comments array provided by CommentExtractor#extract and parses all annotations. The resulting object will look like:

{
  "[context.type]" : [
    {
      description : "[Contains all commetn lines without an annotation]",
      [annotationName] : [resultOfAnnotationParser]
    }
  ]
}

Development

Use mocha test to run the unit tests