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_begin_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 Node) – The parsed node.