devil.utils.markdown

This page was autogenerated by devil/utils/markdown.py --module-link https://github.com/catapult-project/catapult/blob/master/devil/devil/utils/markdown.py

MarkdownHelpAction

MarkdownHelpAction.__init__

MarkdownHelpAction.__call__

MarkdownHelpFormatter

A really bare-bones argparse help formatter that generates valid markdown.

  This will generate something like:

  usage

  # **section heading**:

  ## **--argument-one**

  \`\`\`
  argument-one help text
  \`\`\`

MarkdownHelpFormatter.format_help

MarkdownHelpFormatter.start_section

md_bold

Returns markdown-formatted bold text.

md_code

Returns a markdown-formatted code block in the given language.

md_escape

Escapes * and _.

md_heading

Returns markdown-formatted heading.

md_inline_code

Returns markdown-formatted inline code.

md_italic

Returns markdown-formatted italic text.

md_link

returns a markdown-formatted link.

add_md_help_argument

Adds --md-help to the given argparse.ArgumentParser.

  Running a script with --md-help will print the help text for that script
  as valid markdown.

  Args:
    parser: The ArgumentParser to which --md-help should be added.

load_module_from_path

Load a module given only the path name.

  Also loads package modules as necessary.

  Args:
    module_path: An absolute path to a python module.
  Returns:
    The module object for the given path.

md_module

Write markdown documentation for a class.

  Documents public classes and functions.

  Args:
    class_obj: a types.TypeType object for the class that should be
      documented.
  Returns:
    A list of markdown-formatted lines.

md_class

Write markdown documentation for a class.

  Documents public methods. Does not currently document subclasses.

  Args:
    class_obj: a types.TypeType object for the class that should be
      documented.
  Returns:
    A list of markdown-formatted lines.

md_docstring

Write a markdown-formatted docstring.

  Returns:
    A list of markdown-formatted lines.

md_function

Write markdown documentation for a function.

  Args:
    func_obj: a types.FunctionType object for the function that should be
      documented.
  Returns:
    A list of markdown-formatted lines.

main

Write markdown documentation for the module at the provided path.

  Args:
    raw_args: the raw command-line args. Usually sys.argv[1:].
  Returns:
    An integer exit code. 0 for success, non-zero for failure.