diff options
author | Kirill Podoprigora <kirill.bast9@mail.ru> | 2024-02-01 16:56:24 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-02-01 16:56:24 (GMT) |
commit | 6d7ad57385e6c18545f19714b8f520644d305715 (patch) | |
tree | ed9b4c965c676c5ff1495aadc07b3368a0dfc4d4 /Tools/cases_generator | |
parent | 2dea1cf7fd9b1f6a914e363ecb17a853f4b99b6b (diff) | |
download | cpython-6d7ad57385e6c18545f19714b8f520644d305715.zip cpython-6d7ad57385e6c18545f19714b8f520644d305715.tar.gz cpython-6d7ad57385e6c18545f19714b8f520644d305715.tar.bz2 |
Update outdated info in ``Tools/cases_generator/README.md`` (#114844)
Diffstat (limited to 'Tools/cases_generator')
-rw-r--r-- | Tools/cases_generator/README.md | 28 |
1 files changed, 21 insertions, 7 deletions
diff --git a/Tools/cases_generator/README.md b/Tools/cases_generator/README.md index ed802e4..7fec8a8 100644 --- a/Tools/cases_generator/README.md +++ b/Tools/cases_generator/README.md @@ -5,16 +5,30 @@ Documentation for the instruction definitions in `Python/bytecodes.c` What's currently here: +- `analyzer.py`: code for converting `AST` generated by `Parser` + to more high-level structure for easier interaction - `lexer.py`: lexer for C, originally written by Mark Shannon - `plexer.py`: OO interface on top of lexer.py; main class: `PLexer` -- `parsing.py`: Parser for instruction definition DSL; main class `Parser` -- `generate_cases.py`: driver script to read `Python/bytecodes.c` and +- `parsing.py`: Parser for instruction definition DSL; main class: `Parser` +- `parser.py` helper for interactions with `parsing.py` +- `tierN_generator.py`: a couple of driver scripts to read `Python/bytecodes.c` and write `Python/generated_cases.c.h` (and several other files) -- `analysis.py`: `Analyzer` class used to read the input files -- `flags.py`: abstractions related to metadata flags for instructions -- `formatting.py`: `Formatter` class used to write the output files -- `instructions.py`: classes to analyze and write instructions -- `stacking.py`: code to handle generalized stack effects +- `stack.py`: code to handle generalized stack effects +- `cwriter.py`: code which understands tokens and how to format C code; + main class: `CWriter` +- `generators_common.py`: helpers for generators +- `opcode_id_generator.py`: generate a list of opcodes and write them to + `Include/opcode_ids.h` +- `opcode_metadata_generator.py`: reads the instruction definitions and + write the metadata to `Include/internal/pycore_opcode_metadata.h` +- `py_metadata_generator.py`: reads the instruction definitions and + write the metadata to `Lib/_opcode_metadata.py` +- `target_generator.py`: generate targets for computed goto dispatch and + write them to `Python/opcode_targets.h` +- `uop_id_generator.py`: generate a list of uop IDs and write them to + `Include/internal/pycore_uop_ids.h` +- `uop_metadata_generator.py`: reads the instruction definitions and + write the metadata to `Include/internal/pycore_uop_metadata.h` Note that there is some dummy C code at the top and bottom of `Python/bytecodes.c` |