This course covers several topics

• Python decorators
• The python object system / meta classes
• Iterators, generators and asyncio
• Also see my text on Python import system /different repo/
• An introduction to the Python bytecode /different repo/
• Writing a python tracer /different repo/

Each lesson is a python program, the output of that program is the rendered markdown text that makes up the lesson. This approach gives me some confidence about the quality of the material.

This repository contains the course material implemented as executable Python programs. Each lesson is written as a Python script which, when executed, produces the rendered Markdown text for that lesson as its output.

The general workflow for using this repository is:

1. Inspect the lesson source files to understand the presented topic and examples.
2. Run a lesson script using Python 3 to generate its Markdown output.
3. Use the generated Markdown as the rendered course material.

The lesson scripts make use of the mdpyformat package provided in this repository to render code snippets, evaluate Python code, and include both standard output and standard error in the generated Markdown.

• Python 3.x
• The mdpyformat package (can be installed via pip3 install mdpyformat)

Depending on the lesson, additional Python standard library modules may be required.

This approach allows the lesson content and its rendered documentation to stay closely aligned, as the Markdown output is generated directly from executable code.

I am using a kind of literate programming tool developed for this course. The tool is right here in this repository, in the mdpyformat package

The main function of the mdpyformat package is eval_and_quote(string_arg). This function does the following steps:

1. Renders the argument string as a code snippet
2. Evaluates the string argument as a python script, with the global variable context of the calling module
3. Renders the result of evaluating the code (both standard output and standard error)

There is also print_md(*args) - this shows the outut as a markdown regular text section

header_md(line, nesting=1) - this renders the line as a header

print_quoted(*args) - shows the aguments as markdown quoted text

The mdpyformat library can be installed via pip

pip3 install mdpyformat

Here is the link to pypi

The mdpyformat package contains a script for the generation of table of contents in the generated markdown files.

To invoke this script run

python3 -m mdpyformat.tocgen MARKDOWN_INPUT_FILE MARKDOWN_OUTPUT_WITH_ADDED_TABLE_OF_CONTENT

The script has beend derived from this gist Thanks!