sphinx_gallery.py_source_parser#
Parser for python source files.
Functions#
- sphinx_gallery.py_source_parser.extract_file_config(content)[source]#
Pull out the file-specific config specified in the docstring.
- sphinx_gallery.py_source_parser.parse_source_file(filename)[source]#
Parse source file into AST node.
- Parameters:
filename (str) – File path
- Returns:
node (AST node)
content (utf-8 encoded string)
- sphinx_gallery.py_source_parser.remove_config_comments(code_block)[source]#
Return the content of code_block with in-file config comments removed.
Comment lines of the pattern ‘# sphinx_gallery_[option] = [val]’ are removed, but surrounding empty lines are preserved.
- Parameters:
code_block (str) – A code segment.
- sphinx_gallery.py_source_parser.remove_ignore_blocks(code_block)[source]#
Return the content of code_block with ignored areas removed.
An ignore block starts with # sphinx_gallery_start_ignore, and ends with # sphinx_gallery_end_ignore. These lines and anything in between them will be removed, but surrounding empty lines are preserved.
- Parameters:
code_block (str) – A code segment.
- sphinx_gallery.py_source_parser.split_code_and_text_blocks(source_file, return_node=False)[source]#
Return list with source file separated into code and text blocks.
- Parameters:
- Returns:
file_conf (dict) – File-specific settings given in source file comments as:
# sphinx_gallery_<name> = <value>blocks (list) – (label, content, line_number) List where each element is a tuple with the label (‘text’ or ‘code’), the corresponding content string of block and the leading line number.
node (ast.Module) – The parsed ast node.
