Teaching cpython solution #1
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- CLAUDE.md: Teaching mode instructions and architecture overview - teaching-todo.md: 5-phase curriculum building toward Record type - teaching-notes.md: Detailed implementation notes (for Claude reference) The learning project implements a Record type (immutable named container) and BUILD_RECORD opcode, covering PyObject fundamentals, type slots, the evaluation loop, and build system integration.
Add a new immutable Record type with named fields (similar to namedtuple but implemented entirely in C). This serves as a teaching reference implementation demonstrating core CPython concepts: - PyVarObject with variable-length data (r_values array) - Type slots: tp_repr, tp_hash, tp_richcompare, tp_dealloc, tp_traverse - Sequence protocol: sq_length, sq_item - Attribute access: tp_getattro for field name lookup - GC integration with _PyObject_GC_TRACK and Py_TRASHCAN_* - Bytecode evaluation loop (BUILD_RECORD opcode) Features: - Attribute access: r.field_name - Indexing: r[0], r[1], r[-1], len(r) - Hashing: hash(r) - usable as dict key - Equality: r1 == r2 (compares both names and values) - Python constructor: Record(x=10, y=20) Files added: - Include/recordobject.h: Header with RecordObject struct and API - Objects/recordobject.c: Full implementation (~490 lines) Files modified: - Lib/opcode.py: Added BUILD_RECORD opcode (166) - Include/opcode.h: Regenerated with BUILD_RECORD - Python/opcode_targets.h: Regenerated opcode jump table - Python/ceval.c: Added BUILD_RECORD handler in eval loop - Makefile.pre.in: Added recordobject.o and header - Objects/object.c: Added PyRecord_Type initialization - Python/bltinmodule.c: Exposed Record as builtin
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Claude Teach-in
I wanted to learn about CPython internals so then I had Claude step me through some essential parts of the repo, then I completed a project to finish implementing a record type.