Skip to content

Simple script for creation python code documentation in Markdown

Notifications You must be signed in to change notification settings

ownport/pydoc2md

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 

Repository files navigation

module pydoc2md

Name

pydoc2md - pydoc2md.py

Description

Simple script for creation python code documentation in Markdown format

how to use

$ ./pydoc2md pydoc2md > README.md

links

Classes Tree

+-- __builtin__.object
|  +-- TextDoc2Markdown(pydoc.TextDoc, __builtin__.object)
+-- pydoc.TextDoc(pydoc.Doc)
|  +-- TextDoc2Markdown(pydoc.TextDoc, __builtin__.object)

Classes

class TextDoc2Markdown(pydoc.TextDoc, builtin.object)

PyDoc in Markdown format

bold(self, text)

Format a string in bold

docclass(self, object, name=None, mod=None)

Produce text documentation for a given class object.

docdata(self, object, name=None, mod=None, cl=None)

Produce text documentation for a data descriptor.

docmodule(self, object, name=None, mod=None)

Produce text documentation for a given module object.

docother(self, object, name=None, mod=None, parent=None, maxlen=None, doc=None)

Produce text documentation for a data object.

docproperty(self, object, name=None, mod=None, cl=None)

Produce text documentation for a property.

docroutine(self, object, name=None, mod=None, cl=None)

Produce text documentation for a function or method object.

document(self, object, name=None, *args)

Generate documentation for an object.

fail(self, object, name=None, *args)

Raise an exception for unimplemented types.

formattree(self, tree, modname, parent=None, prefix='+-- ')

Render in text a class tree as returned by inspect.getclasstree().

formatvalue(self, object)

Format an argument default value as text.

getdocloc(self, object)

Return the location of module docs or None

indent(self, text, prefix='')

Indent text by prepending a given prefix to each line.

repr(self, x) from pydoc.TextRepr

section(self, title, contents)

Format a section with a given heading.

Functions

cli()

Command-line interface (looks at sys.argv to decide what to do).

Version

0.1

Author

Andrey Usov https://github.com/ownport/pydoc2md

About

Simple script for creation python code documentation in Markdown

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages