showdoc

Display symbol documentation in notebook and website

Documentation For An Object

Render the signature as well as the docments to show complete documentation for an object.

source

BasicMarkdownRenderer

def BasicMarkdownRenderer(
    sym, name:str | None=None, title_level:int=3, maxline:int=110
):

Markdown renderer for show_doc

source

show_doc

def show_doc(
    sym, # Symbol to document
    renderer:NoneType=None, # Optional renderer (defaults to markdown)
    name:str | None=None, # Optionally override displayed name of `sym`
    title_level:int=3, # Heading level to use for symbol name
):

Show signature and docstring for sym

You can use show_doc to document apis of functions, classes or methods.

Numpy Docstrings

if you have numpy docstrings instead of docments, show_doc will attempt to parse and render those just like docments.

Warning

Numpy docstring formatting is very strict. If your docstrings do not strictly adhere to the numpy format, it will not be parsed properly and information about parameters and return values may not properly be rendered in the table below the signature. Where possible, we recommend using docments to annonate your function instead.

show_doc on Classes

show_doc works on Classes, too, including when you use @patch.

You can define methods for the class Foo with @patch which is convenient in allowing you to break up code for documentation in notebooks.

Class properties also work with showdoc.

source

doc

def doc(
    elt
):

Show show_doc info along with link to docs

source

showdoc_nm

def showdoc_nm(
    tree
):

Get the fully qualified name for showdoc.

Other helpers

source

colab_link('index')

Open index in Colab