#!/usr/bin/env python3 # A little wrapper around pycco, to add Rust support. import pycco, pycco_resources from pygments import lexers, formatters import sys, re # helper functions def patch_html(source, marker, new_text): '''Find the [marker] in [source], and insert [new_text] after it.''' assert source.count(marker) == 1 return source.replace(marker, marker + new_text, 1) # now, monkey-patch pycco for Rust support pycco.main.supported_languages[".rs"] = { "name": "rust", "comment_symbol": "//"} for ext, l in pycco.main.supported_languages.items(): # Does the line begin with a comment? l["comment_matcher"] = re.compile(r"^\s*" + l["comment_symbol"] + "\s?") # The dividing token we feed into Pygments, to delimit the boundaries between # sections. l["divider_text"] = "\n" + l["comment_symbol"] + "DIVIDER\n" # The mirror of `divider_text` that we expect Pygments to return. We can split # on this to recover the original sections. l["divider_html"] = re.compile(r'\n*' + l["comment_symbol"] + 'DIVIDER\n*') # Get the Pygments Lexer for this language. l["lexer"] = lexers.get_lexer_by_name(l["name"]) # and monkey-patch the function generating the output to do some post-processing generate_documentation_orig = pycco.main.generate_documentation generate_documentation_called = False def generate_documentation(*args, **kwargs): global generate_documentation_called generate_documentation_called = True result = generate_documentation_orig(*args, **kwargs) # now patch it result = patch_html(result, b'', b'') result = patch_html(result, b'
()?