KOS_OP_IMPORT_STAR

  • Style: EXTRA (CONST, COUNT, NOARG, NOARG). Row: a0 = cpool module name str (or None), a1 = level.

  • Stack: no effect.

  • Semantics: Import the leaf module and bind its public names into the current frame namespace, matching Python’s from MODULE import *. Name selection follows CPython’s import_all_from: when the module defines __all__ (a sequence of str; a non-str entry is a TypeError) exactly those names are bound; otherwise every dir(module) name that does not start with an underscore. Existing bindings are overwritten.

  • Compiler restriction: the import-all-from special emits this opcode only at module top level; it is a compile error inside a function, lambda, let, or class body.

  • Invariants: a0 is a str or None.

  • Compiler form: Pre-compile extra operand is a 4-tuple (name, level, 0, 0).

  • Implementation: koskari/lib/opcode/IMPORT_STAR.c

Example: (import-all-from os.path) – bind os.path’s public names. Extra row: ("os.path", 0, 0, 0).

index

opcode

arg

arg view

comment

0

IMPORT_STAR

0

0 (“os.path”, 0, …)

bind public names; stack: […]

1

CONST

1

1 (None)

statement value

2

RETURN

1

1

Note: There is no KOS_OP_CAPTURE_FRAME (or similar) in koskari/lib/opcodes.incl today. Any future stack/frame introspection opcode would be added there first, then documented here.