generate_jupyter.py

import nbformat
import re
import sys

weeks = [int(a) for a in sys.argv[1:]]
if len(weeks) == 0:
    weeks = range(8)


FIRST_CELL = '''############## PLEASE RUN THIS CELL FIRST! ###################

# import everything and define a test runner function
from importlib import reload
from helper import run
'''

UNITTEST_TEMPLATE_1 = '''### Exercise {exercise_number}

{instructions}

#### Make [this test](/edit/{path}/{module}.py) pass: `{module}.py:{test_suite}:{test}`'''


UNITTEST_TEMPLATE_2 = '''# Exercise {exercise_number}

reload({module})
run({module}.{test_suite}('{test}'))'''


EXERCISE_TEMPLATE_1 = '''### Exercise {exercise_number}
{instructions}'''


EXERCISE_TEMPLATE_2 = '''# Exercise {exercise_number}

{code}'''


for week in weeks:
    notebook = nbformat.v4.new_notebook()
    notebook_complete = nbformat.v4.new_notebook()
    cells = notebook['cells']
    cells_complete = notebook_complete['cells']
    if week == 0:
        path = 'practice'
    else:
        path = 'week{}'.format(week)
    with open('{}/answers.py'.format(path), 'r') as f:
        current = ''
        cell_type = None
        exercise_number = 1
        first_code_cell = True
        for l in f:
            line = l.strip()
            if line in ('#markdown', '#code', '#exercise', '#unittest'):
                cell_type = line[1:]
            elif line == '#end{}'.format(cell_type):
                if cell_type == 'markdown':
                    markdown_cell = nbformat.v4.new_markdown_cell(current)
                    cells.append(markdown_cell)
                    cells_complete.append(markdown_cell)
                elif cell_type == 'code':
                    # only take >>> or ... lines
                    lines = []
                    for line in current.split('\n'):
                        if line.startswith('>>> ') or line.startswith('... '):
                            line = re.sub(r'\\\\x', r'\\x', line)
                            lines.append(line[4:])
                    if first_code_cell:
                        code = FIRST_CELL + '\n'.join(lines)
                        first_code_cell = False
                    else:
                        code = '\n'.join(lines)
                    code_cell = nbformat.v4.new_code_cell(code)
                    cells.append(code_cell)
                    cells_complete.append(code_cell)
                elif cell_type == 'exercise':
                    instructions, code = current.split('---')
                    markdown = EXERCISE_TEMPLATE_1.format(
                        exercise_number=exercise_number,
                        instructions=instructions,
                    )
                    markdown_cell = nbformat.v4.new_markdown_cell(markdown)
                    cells.append(markdown_cell)
                    cells_complete.append(markdown_cell)
                    lines = []
                    lines_complete = []
                    for line in code.split('\n'):
                        if line.startswith('>>> ') or line.startswith('... '):
                            line = re.sub(r'\\\\x', r'\\x', line)
                            start_alt = line.find('  #/')
                            if start_alt == -1:
                                lines.append(line[4:])
                                lines_complete.append(line[4:])
                            else:
                                lines.append(line[start_alt+4:])
                                lines_complete.append(line[4:start_alt])
                    code_1 = EXERCISE_TEMPLATE_2.format(
                        code='\n'.join(lines),
                        exercise_number=exercise_number,
                    )
                    code_cell_1 = nbformat.v4.new_code_cell(code_1)
                    cells.append(code_cell_1)
                    code_2 = EXERCISE_TEMPLATE_2.format(
                        code='\n'.join(lines_complete),
                        exercise_number=exercise_number,
                    )
                    code_cell_2 = nbformat.v4.new_code_cell(code_2)
                    cells_complete.append(code_cell_2)
                    exercise_number += 1
                elif cell_type == 'unittest':
                    module, test_suite, test, instructions = current.split(':', 3)
                    markdown = UNITTEST_TEMPLATE_1.format(
                        exercise_number=exercise_number,
                        instructions=instructions,
                        module=module,
                        path=path,
                        test=test,
                        test_suite=test_suite,
                    )
                    markdown_cell = nbformat.v4.new_markdown_cell(markdown)
                    cells.append(markdown_cell)
                    cells_complete.append(markdown_cell)
                    code = UNITTEST_TEMPLATE_2.format(
                        exercise_number=exercise_number,
                        module=module,
                        path=path,
                        test=test,
                        test_suite=test_suite,
                    )
                    code_cell = nbformat.v4.new_code_cell(code)
                    cells.append(code_cell)
                    cells_complete.append(code_cell)
                    exercise_number += 1
                current = ''
                cell_type = None
            elif cell_type:
                current += line + '\n'
    nbformat.write(notebook, '{}/{}.ipynb'.format(path, path))
    nbformat.write(notebook_complete, '{}/complete/{}.ipynb'.format(path, path))