MCPcopy Create free account
hub / github.com/AdaCompNUS/summit / gen_body

Method gen_body

PythonAPI/docs/doc_gen.py:441–473  ·  view source on GitHub ↗

Generates the documentation body

(self)

Source from the content-addressed store, hash-verified

439 return md.data()
440
441 def gen_body(self):
442 """Generates the documentation body"""
443 md = MarkdownFile()
444 md.first_title()
445 for module_name in sorted(self.master_dict):
446 module = self.master_dict[module_name]
447 module_key = module_name
448 # Generate class doc (if any)
449 if valid_dic_val(module, 'classes'):
450 for cl in sorted(module['classes'], key = lambda i: i['class_name']):
451 class_name = cl['class_name']
452 class_key = join([module_key, class_name], '.')
453 current_title = module_name+'.'+class_name
454 md.title(2, join([current_title,'<a name="'+current_title+'"></a>']))
455 inherits = ''
456 if valid_dic_val(cl, 'parent'):
457 inherits = italic(create_hyperlinks(cl['parent']))
458 md.inherit_join(inherits)
459 # Class main doc
460 if valid_dic_val(cl, 'doc'):
461 md.textn(create_hyperlinks(md.prettify_doc(cl['doc'])))
462 # Generate instance variable doc (if any)
463 if valid_dic_val(cl, 'instance_variables'):
464 md.title_html(3, 'Instance Variables')
465 for inst_var in cl['instance_variables']:
466 add_doc_inst_var(md, inst_var, class_key)
467 # Generate method doc (if any)
468 if valid_dic_val(cl, 'methods'):
469 md.title_html(3, 'Methods')
470 for method in cl['methods']:
471 add_doc_method(md, method, class_key)
472 md.separator()
473 return md.data().strip()
474
475 def gen_markdown(self):
476 """Generates the whole markdown file"""

Callers 1

gen_markdownMethod · 0.95

Calls 15

first_titleMethod · 0.95
titleMethod · 0.95
inherit_joinMethod · 0.95
textnMethod · 0.95
prettify_docMethod · 0.95
title_htmlMethod · 0.95
separatorMethod · 0.95
dataMethod · 0.95
create_hyperlinksFunction · 0.85
add_doc_inst_varFunction · 0.85
add_doc_methodFunction · 0.85
MarkdownFileClass · 0.70

Tested by

no test coverage detected