@ -3,6 +3,7 @@
const common = require ( '../common' ) ;
const assert = require ( 'assert' ) ;
const fs = require ( 'fs' ) ;
const path = require ( 'path' ) ;
const json = require ( '../../tools/doc/json.js' ) ;
@ -12,113 +13,116 @@ const json = require('../../tools/doc/json.js');
// The json property is some json which will be generated by the doctool.
var testData = [
{
'file' : common . fixturesDir + '/sample_document.md' ,
'json' : {
'source' : 'foo' ,
'modules' : [ { 'textRaw' : 'Sample Markdown' ,
'name' : 'sample_markdown' ,
'modules' : [ { 'textRaw' : 'Seussian Rhymes' ,
'name' : 'seussian_rhymes' ,
'desc' : '<ol>\n<li>fish</li>\n<li><p>fish</p>\n</li>\n<li>' +
file : path . join ( common . fixturesDir , 'sample_document.md' ) ,
json : {
source : 'foo' ,
modules : [ {
textRaw : 'Sample Markdown' ,
name : 'sample_markdown' ,
modules : [ {
textRaw : 'Seussian Rhymes' ,
name : 'seussian_rhymes' ,
desc : '<ol>\n<li>fish</li>\n<li><p>fish</p>\n</li>\n<li>' +
'<p>Red fish</p>\n</li>\n<li>Blue fish</li>\n</ol>\n' ,
'type' : 'module' ,
'displayName' : 'Seussian Rhymes'
} ] ,
'type' : 'module' ,
'displayName' : 'Sample Markdown'
} ]
type : 'module' ,
displayName : 'Seussian Rhymes'
} ] ,
type : 'module' ,
displayName : 'Sample Markdown'
} ]
}
} ,
{
'file' : common . fixturesDir + '/order_of_end_tags_5873.md' ,
'json' : {
'source' : 'foo' ,
'modules' : [ {
'textRaw' : 'Title' ,
'name' : 'title' ,
'modules' : [ {
'textRaw' : 'Subsection' ,
'name' : 'subsection' ,
'classMethods' : [ {
'textRaw' : 'Class Method: Buffer.from(array)' ,
'type' : 'classMethod' ,
'name' : 'from' ,
'signatures' : [ {
'params' : [ {
'textRaw' : '`array` {Array} ' ,
'name' : 'array' ,
'type' : 'Array'
} ]
} ,
file : path . join ( common . fixturesDir , 'order_of_end_tags_5873.md' ) ,
json : {
source : 'foo' ,
modules : [ {
textRaw : 'Title' ,
name : 'title' ,
modules : [ {
textRaw : 'Subsection' ,
name : 'subsection' ,
classMethods : [ {
textRaw : 'Class Method: Buffer.from(array)' ,
type : 'classMethod' ,
name : 'from' ,
signatures : [
{
params : [ {
textRaw : '`array` {Array} ' ,
name : 'array' ,
type : 'Array'
} ]
} ,
{
'params' : [ {
'name' : 'array'
} ]
params : [ {
name : 'array'
} ]
}
]
} ] ,
'type' : 'module' ,
'displayName' : 'Subsection'
} ] ,
'type' : 'module' ,
'displayName' : 'Title'
} ]
} ] ,
type : 'module' ,
displayName : 'Subsection'
} ] ,
type : 'module' ,
displayName : 'Title'
} ]
}
} ,
{
'file' : common . fixturesDir + '/doc_with_yaml.md' ,
'json' : {
'source' : 'foo' ,
'modules' : [
file : path . join ( common . fixturesDir , 'doc_with_yaml.md' ) ,
json : {
source : 'foo' ,
modules : [
{
'textRaw' : 'Sample Markdown with YAML info' ,
'name' : 'sample_markdown_with_yaml_info' ,
'modules' : [
textRaw : 'Sample Markdown with YAML info' ,
name : 'sample_markdown_with_yaml_info' ,
modules : [
{
'textRaw' : 'Foobar' ,
'name' : 'foobar' ,
'meta' : {
'added' : [ 'v1.0.0' ]
textRaw : 'Foobar' ,
name : 'foobar' ,
meta : {
added : [ 'v1.0.0' ]
} ,
'desc' : '<p>Describe <code>Foobar</code> in more detail ' +
desc : '<p>Describe <code>Foobar</code> in more detail ' +
'here.</p>\n' ,
'type' : 'module' ,
'displayName' : 'Foobar'
type : 'module' ,
displayName : 'Foobar'
} ,
{
'textRaw' : 'Foobar II' ,
'name' : 'foobar_ii' ,
'meta' : {
'added' : [ 'v5.3.0' , 'v4.2.0' ]
textRaw : 'Foobar II' ,
name : 'foobar_ii' ,
meta : {
added : [ 'v5.3.0' , 'v4.2.0' ]
} ,
'desc' : '<p>Describe <code>Foobar II</code> in more detail ' +
desc : '<p>Describe <code>Foobar II</code> in more detail ' +
'here.</p>\n' ,
'type' : 'module' ,
'displayName' : 'Foobar II'
type : 'module' ,
displayName : 'Foobar II'
} ,
{
'textRaw' : 'Deprecated thingy' ,
'name' : 'deprecated_thingy' ,
'meta' : {
'added' : [ 'v1.0.0' ] ,
'deprecated' : [ 'v2.0.0' ]
textRaw : 'Deprecated thingy' ,
name : 'deprecated_thingy' ,
meta : {
added : [ 'v1.0.0' ] ,
deprecated : [ 'v2.0.0' ]
} ,
'desc' : '<p>Describe <code>Deprecated thingy</code> in more ' +
desc : '<p>Describe <code>Deprecated thingy</code> in more ' +
'detail here.</p>\n' ,
'type' : 'module' ,
'displayName' : 'Deprecated thingy'
type : 'module' ,
displayName : 'Deprecated thingy'
} ,
{
'textRaw' : 'Something' ,
'name' : 'something' ,
'desc' : '<!-- This is not a metadata comment -->\n<p>' +
textRaw : 'Something' ,
name : 'something' ,
desc : '<!-- This is not a metadata comment -->\n<p>' +
'Describe <code>Something</code> in more detail here.</p>\n' ,
'type' : 'module' ,
'displayName' : 'Something'
type : 'module' ,
displayName : 'Something'
}
] ,
'type' : 'module' ,
'displayName' : 'Sample Markdown with YAML info'
type : 'module' ,
displayName : 'Sample Markdown with YAML info'
}
]
}