transcribe

Macro transcription utilities.

class macro_polo.transcribe.MacroTransciberSubstitution

A variable substitution in a transcriber.

__init__(name)
Parameters:

name (str)

Return type:

None

name: str

The name of the variable to substitute.

class macro_polo.transcribe.MacroTranscriber

Transcribes a macro match to an output token stream.

transcribe(captures, repitition_path=())

Transcribe the given match to an output token stream.

Parameters:

  • captures (MacroMatchCaptures)

  • repitition_path (tuple[int, ...])

Return type:

Iterator[Token]

class macro_polo.transcribe.MacroTranscriberRepeater

A repeated sub-transcriber.

__init__(transcriber, sep=None)
Parameters:
Return type:

None

sep: Token | None

An optional separator token.

transcribe(captures, repitition_path=())

Transcribe the given match to an output token stream.

Parameters:

  • captures (MacroMatchCaptures)

  • repitition_path (tuple[int, ...])

Return type:

Iterator[Token]

transcriber: MacroTranscriber

The transcriber to repeat.

exception macro_polo.transcribe.MacroTranscriptionError

Exception raised for macro transcription errors.