Documentation

reflect.Package

An isolated runtime-compiled package.

Reference version

Signature

class reflect.Package

An isolated runtime-compiled package.

Source:<builtin>/reflect/reflect.bamlbytes 9508–13746

Fields

_inner

unknown

Static methods

function

_finish

(
packages: map<string, reflect.Package>
) -> reflect.Package throws unknown
function

compile

(
files: map<string, string>,
packages: map<string, reflect.Package> = …
) -> reflect.Package throws unknown

Compiles files into an isolated package, resolving its dependencies against packages.

Parameters

  • files: source text keyed by path, as the package's baml_src.
  • packages: packages the source may depend on, keyed by the alias it imports them under.

Throws

  • reflect.errors.CompilationError if the source does not compile.
  • anything the package's top-level initialization throws, which is why the clause is unknown.
function

current

() -> reflect.Package throws never

The package lexically enclosing this call site.

Instance methods

function

classes

(self) -> map<string, reflect.class.Type> throws never

Exported class types, keyed by package-local name.

function

diagnostics

(self) -> reflect.Diagnostic[] throws never

Diagnostics produced while compiling this package.

function

enums

(self) -> map<string, reflect.enum.Type> throws never

Exported enum types, keyed by package-local name.

function

functions

(self) -> map<string, reflect.function.Type> throws never

Exported free-function signatures, keyed by package-local name.

function

get_class

(self, name: string) -> reflect.class.Type | null throws never

The exported class called name, or null if the package exports none.

function

get_enum

(self, name: string) -> reflect.enum.Type | null throws never

The exported enum called name, or null if the package exports none.

function

get_function

<F>(self, name: string) -> F | null throws reflect.errors.CompilationError

Extract an exported function through an ordinary function-type contract.

A lookup by name has nowhere to put type arguments, so an unspecialized generic function is refused here.

function

get_interface

(self, name: string) -> reflect.interface.Type | null throws never

The exported interface called name, or null if the package exports none.

function

interfaces

(self) -> map<string, reflect.interface.Type> throws never

Exported interface types, keyed by package-local name.

function

tests

(self) -> map<string, () -> null throws unknown> throws unknown

Bundled tests as directly invocable zero-argument callables.

function

with_types

(
self,
types: map<string, reflect.Type | reflect.TypeView>
) -> reflect.Package throws reflect.errors.CompilationError

A package that exports everything this one does, plus types under the given names, for a later Package.compile to mount: a bare class, enum, interface, or alias declaration is re-exported under its name (the same declaration, so a consumer that mounts both packages sees one type), any other type is declared as an alias, and every declaration a mounted type reaches is exported under its own name. A name this package already exports is refused.

Implementations

reflect.AnyClass for T

Instance methods

function

attributes

(self) -> reflect.Meta throws never

The class declaration's schema metadata, or empty metadata when the runtime type is not a class.

function

get

<T>(self, name: string) -> T | null throws reflect.errors.TypeMismatch

Read a field as T. A missing field returns null; use has_field to distinguish that case from a present field whose value is null.

function

get_field

(self, name: string) -> reflect.class.Field | null throws never

Return a value-bound field handle, or null when no such field exists.

function

has_field

(self, name: string) -> bool throws never

Whether this value's runtime class declares a field called name. false when the runtime type is not a class.

function

list_fields

(self) -> reflect.class.Field[] throws never

Reflected fields bound to this value for Field.value<T>().

function

name

(self) -> string throws never

The rendered name of this value's concrete runtime type.

function

type

(self) -> reflect.Type throws never

This value's concrete runtime type.

Source:<builtin>/reflect/reflect.bamlbytes 7833–7863