Automating Diagrams for Core cPython Grammar Docs

blaise · June 6, 2024, 10:23pm

This ongoing livestream meets Weds, to expand the work initiated in the thread:

generate diagrams from the python grammar

Read the grammar:

python/cpython/blob/main/Grammar/python.gram#L30


      
              } else if (p->start_rule == Py_func_type_input) {
                  result = func_type_rule(p);
              }
          
              return result;
          }
          '''
          
          # ========================= START OF THE GRAMMAR =========================
          
          # General grammatical elements and rules:
          #
          # * Strings with double quotes (") denote SOFT KEYWORDS
          # * Strings with single quotes (') denote KEYWORDS
          # * Upper case names (NAME) denote tokens in the Grammar/Tokens file
          # * Rule names starting with "invalid_" are used for specialized syntax errors
          #     - These rules are NOT used in the first pass of the parser.
          #     - Only if the first pass fails to parse, a second pass including the invalid
          #       rules will be executed.
          #     - If the parser fails in the second phase with a generic syntax error, the
          #       location of the generic failure of the first pass will be used (this avoids

Use rST directives to simply the grammar into ebnf blocks:

Publish the recorded the sessions:

Playlist for videos: https://www.youtube.com/playlist?list=PLFt-PM7J_H3G1jKBDZqeApPHtcOJOYwe5