tiny.python.object

Defined in tiny.python.

The package's runtime values: one tagged union that covers each kind of Python value the package supports, and a heap that owns the objects those values point to.

API (13)

Types and contracts

Public types and contracts.

• Builtin: The builtin functions that the package provides, one tag each, named after the function: dict, enumerate, iter, len, list, next, range, reversed and tuple.
• Dict: A Python dictionary that keeps insertion order: an array of key and value entries, in the order the keys first arrived, and a hash table from each key to its entry's position.
• DictEntry: One key and its value in a dictionary.
• DictView: A live view of one dictionary.
• DictViewKind: The part of a dictionary a view shows, one tag each, named after the Python method that returns the view: keys, values and items.
• Heap: The allocator and, for each kind of object, one list holding every object the virtual machine created.
• List: A Python list, as a Zig growable array of values.
• NativeMethod: A list or dictionary method bound to the object it was read from, as a tagged union with one tag per method.
• Range: A Python range: the integers from start toward stop in steps of step, with the count of elements stored.
• Tuple: A Python tuple, as a fixed slice of values.
• Value: One Python value, as a tagged union of thirteen kinds.

Namespaces

Public namespaces.

• heap: The heap owns every object the virtual machine creates while it runs a program: lists, tuples, dictionaries, ranges, copied strings, iterators, bound methods and dictionary views.
• value: Every Python value the package handles is one tagged union: None, booleans and integers are held in the value itself, a string is a slice of bytes held elsewhere, and lists, tuples, dictionaries, ranges and the other objects are pointers to objects held elsewhere.

Source

Source: lib/python/src/object/root.zig

1//! The package's runtime values: one tagged union that covers each kind of Python value the package2//! supports, and a heap that owns the objects those values point to. A value has to be cheap to3//! copy between the virtual machine's stack, its variables and its containers, and Python's rules4//! for truth, equality, hashing and identity have to hold across all of the value types.5//!6//! The file `value` defines `Value` and the object types it points to, and the file `heap` defines7//! `Heap`, which creates those objects and frees them together. The namespace re-exports `Value`,8//! `Builtin`, `NativeMethod`, `List`, `Tuple`, `Dict`, `DictEntry`, `DictView`, `DictViewKind`,9//! `Range` and `Heap`. The iterator types are reached through `value` alone.10pub const value = @import("value.zig");11pub const heap = @import("heap.zig");1213pub const Value = value.Value;14pub const Builtin = value.Builtin;15pub const NativeMethod = value.NativeMethod;16pub const List = value.List;17pub const Tuple = value.Tuple;18pub const Dict = value.Dict;19pub const DictEntry = value.DictEntry;20pub const DictView = value.DictView;21pub const DictViewKind = value.DictViewKind;22pub const Range = value.Range;23pub const Heap = heap.Heap;

Source: lib/python/src/root.zig:90

1pub const object = @import("object/root.zig");

Audit