70 lines
1.7 KiB
JavaScript
70 lines
1.7 KiB
JavaScript
|
function parse( f ) {
|
||
|
|
var c = [], bm, m;
|
||
|
|
var blockMatch = /\/\*\*\s*((.|\n)*?)\s*\*\//g;
|
||
|
|
var paramMatch = /\@(\S+) *((.|\n)*?)(?=\n\@|!!!)/m;
|
||
|
|
|
||
|
|
while ( bm = blockMatch.exec(f) ) {
|
||
|
|
block = bm[1].replace(/^\s*\* ?/mg,"") + "!!!";
|
||
|
|
var ret = { params: [], examples: [], tests: [] };
|
||
|
|
|
||
|
|
while ( m = paramMatch.exec( block ) ) {
|
||
|
|
block = block.replace( paramMatch, "" );
|
||
|
|
|
||
|
|
var n = m[1];
|
||
|
|
var v = m[2]
|
||
|
|
.replace(/\s*$/g,"")
|
||
|
|
.replace(/^\s*/g,"")
|
||
|
|
.replace(/&/g, "&")
|
||
|
|
.replace(/</g, "<")
|
||
|
|
.replace(/>/g, ">")
|
||
|
|
//.replace(/\n/g, "<br/>")
|
||
|
|
/*.replace(/(\s\s+)/g, function(a){
|
||
|
|
var ret = "";
|
||
|
|
for ( var i = 0; i < a.length; i++ )
|
||
|
|
ret += " ";
|
||
|
|
return ret;
|
||
|
|
})*/ || 1;
|
||
|
|
|
||
|
|
if ( n == 'param' || n == 'any' ) {
|
||
|
|
var args = v.split(/\s+/);
|
||
|
|
v = args.slice( 2, args.length );
|
||
|
|
v = { type: args[0], name: args[1], desc: v.join(' ') };
|
||
|
|
if ( n == 'any' ) v.any = 1;
|
||
|
|
n = "params";
|
||
|
|
} else if ( n == 'example' ) {
|
||
|
|
v = { code: v };
|
||
|
|
n = "examples";
|
||
|
|
} else if ( n == 'test' ) {
|
||
|
|
n = "tests";
|
||
|
|
}
|
||
|
|
|
||
|
|
if ( n == 'desc' || n == 'before' || n == 'after' || n == 'result' ) {
|
||
|
|
ret.examples[ ret.examples.length - 1 ][ n ] = v;
|
||
|
|
} else {
|
||
|
|
if ( ret[ n ] ) {
|
||
|
|
if ( ret[ n ].constructor == Array ) {
|
||
|
|
ret[ n ].push( v );
|
||
|
|
} else {
|
||
|
|
ret[ n ] = [ ret[ n ], v ];
|
||
|
|
}
|
||
|
|
} else {
|
||
|
|
ret[ n ] = v;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
ret.desc = block.replace(/\s*!!!$/,"")
|
||
|
|
.replace(/</g, "<")
|
||
|
|
.replace(/>/g, ">");
|
||
|
|
//.replace(/\n\n/g, "<br/><br/>")
|
||
|
|
//.replace(/\n/g, " ");
|
||
|
|
|
||
|
|
var m = /^((.|\n)*?(\.|$))/.exec( ret.desc );
|
||
|
|
if ( m ) ret['short'] = m[1];
|
||
|
|
|
||
|
|
if ( ret.name ) c.push( ret );
|
||
|
|
}
|
||
|
|
|
||
|
|
return c;
|
||
|
|
}
|