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.split_code_and_text_blocks(source_file, return_node=False)[source]

Return list with source file separated into code and text blocks.

Parameters:
  • source_file (str) – Path to the source file.
  • return_node (bool) – If True, return the ast node.
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.