build/js/parse.js

   1 function parse( f ) {
   2         var c = [], bm, m;
   3         var blockMatch = /\/\*\*\s*((.|\n)*?)\s*\*\//g;
   4         var paramMatch = /\@(\S+) *((.|\n)*?)(?=\n\@|!!!)/m;
   5
   6         while ( bm = blockMatch.exec(f) ) {
   7                 block = bm[1].replace(/^\s*\* ?/mg,"") + "!!!";
   8                 var ret = { params: [], examples: [], tests: [] };
   9
  10                 while ( m = paramMatch.exec( block ) ) {
  11                         block = block.replace( paramMatch, "" );
  12
  13                         var n = m[1];
  14                         var v = m[2]
  15                                 .replace(/\s*$/g,"")
  16                                 .replace(/^\s*/g,"")
  17                                 .replace(/&/g, "&amp;")
  18                                 .replace(/</g, "&lt;")
  19                                 .replace(/>/g, "&gt;")
  20                                 //.replace(/\n/g, "<br/>")
  21                                 /*.replace(/(\s\s+)/g, function(a){
  22                                         var ret = "";
  23                                         for ( var i = 0; i < a.length; i++ )
  24                                                 ret += "&nbsp;";
  25                                         return ret;
  26                                 })*/ || 1;
  27
  28                         if ( n == 'param' || n == 'any' ) {
  29                                 var args = v.split(/\s+/);
  30                                 v = args.slice( 2, args.length );
  31                                 v = { type: args[0], name: args[1], desc: v.join(' ') };
  32                                 if ( n == 'any' ) v.any = 1;
  33                                 n = "params";
  34                         } else if ( n == 'example' ) {
  35                                 v = { code: v };
  36                                 n = "examples";
  37                         } else if ( n == 'test' ) {
  38                                 n = "tests";
  39                         }
  40
  41                         if ( n == 'desc' || n == 'before' || n == 'after' || n == 'result' ) {
  42                                 ret.examples[ ret.examples.length - 1 ][ n ] = v;
  43                         } else {
  44                                 if ( ret[ n ] ) {
  45                                         if ( ret[ n ].constructor == Array ) {
  46                                                 ret[ n ].push( v );
  47                                         } else {
  48                                                 ret[ n ] = [ ret[ n ], v ];
  49                                         }
  50                                 } else {
  51                                         ret[ n ] = v;
  52                                 }
  53                         }
  54                 }
  55
  56                 ret.desc = block.replace(/\s*!!!$/,"")
  57                                 .replace(/</g, "&lt;")
  58                                 .replace(/>/g, "&gt;");
  59                                 //.replace(/\n\n/g, "<br/><br/>")
  60                                 //.replace(/\n/g, " ");
  61
  62                 var m = /^((.|\n)*?(\.|$))/.exec( ret.desc );
  63                 if ( m ) ret['short'] = m[1];
  64
  65                 if ( ret.name ) c.push( ret );
  66         }
  67
  68         return c;
  69 }