Extract code samples from SR docs

generate-code-examples.sh

#!/bin/bash

git ls -r |\
    grep '\.md$' |\
    grep -vP '(troubleshooting/python.md|programming/sr/(compass|radio)/index.md)' |\
    xargs ./get-code-chunks.py |\
    grep -vP 'R\..+\.something(\.\.\.)?$' > code-examples.py

get-code-chunks.py

#!/usr/bin/env python3

import argparse
import subprocess
from pathlib import Path

import pandocfilters as pf  # https://pypi.org/project/pandocfilters/


def code_blocks(key, value, format, meta):
    if key != 'CodeBlock':
        return {}

    (_, tags, _), content = value
    if 'python' in tags:
        print(content)
        print()


def parse_args() -> argparse.Namespace:
    parser = argparse.ArgumentParser()
    parser.add_argument(
        'file_paths',
        metavar='file_path',
        type=Path,
        nargs=argparse.ONE_OR_MORE,
    )
    return parser.parse_args()


def main(args: argparse.Namespace) -> None:
    for path in args.file_paths:
        ast_source = subprocess.check_output([
            'pandoc',
            '-t',
            'json',
            '-s',
            str(path),
        ])
        print(f'# {path}\n')
        pf.applyJSONFilters([code_blocks], ast_source, '')
        print()


if __name__ == '__main__':
    main(parse_args())