c/ucall/, and enums mirror C enums, never strings.
Every one of the 55 exported functions is bound, and so are both callback types, the log sink and the peer authorizer; typed JSON handlers stay Python’s, and Mojo handlers read and write bytes.thin abi("C") trampoline is instantiated per handler, and the context the library passes back addresses the Server, which is not Movable for that reason.Optional[Pointer], a view carries the origin of what it borrows, and only opaque handles and void * state cross as an integer Address.LibraryA reference to the loaded library, cheap to copy and shared by everything it creates.13struct LibraryEvery handle carries one, which is what keeps the shared object mapped for as long as anything can still call into it.
shared | ArcPointer[_Loaded] | The handle and its symbols, refcounted so the last holder unmaps the object. |
|---|
Copyable, Deinitable, ImplicitlyCopyable, Movable__init__Opens the shared object and resolves it, which every handle then shares.def __init__(out self)LIBRARY_MISSING, when nothing is on the loader path, with VERSION_MISMATCH when what loaded is another major version, or with SYMBOL_MISSING when it does not export an entry point the binding needs.symbolsThe resolved entry points, borrowed rather than copied on every call.def symbols(self) -> ref[self.shared.symbols] SymbolsLibrary is held.versionThe linked library's major, minor and patch. Calls ucall_version.def version(self) -> Tuple[Int, Int, Int]version_nameThe linked library's version, including a release-candidate suffix. Calls ucall_version_name.def version_name(self) -> Stringstatus_nameThe library's spelling of a status, as OUT_OF_MEMORY spells "out-of-memory". Calls ucall_status_name.def status_name(self, status: Status) -> Stringstatus_from_nameReads a spelling back; INVALID_ARGUMENT when unrecognized. Calls ucall_status_from_name.def status_from_name(self, name: StringSpan) -> Statusio_backend_nameThe library's spelling of an I/O backend, as LINUX_URING618 spells "linux-uring618". Calls ucall_io_backend_name.def io_backend_name(self, backend: Backend) -> Stringio_backend_from_nameReads a spelling back; AUTOMATIC when unrecognized. Calls ucall_io_backend_from_name.def io_backend_from_name(self, name: StringSpan) -> Backendcpu_class_nameThe library's spelling of a CPU class, as AWS_G5 spells "aws-g5". Calls ucall_cpu_class_name.def cpu_class_name(self, cpu_class: CPUClass) -> Stringcpu_class_from_nameReads a spelling back; UNKNOWN when unrecognized. Calls ucall_cpu_class_from_name.def cpu_class_from_name(self, name: StringSpan) -> CPUClassdecode_percentDecodes the %XX escapes of encoded, like a query value, and '+' as a space in QUERY mode. Calls ucall_decode_percent.def decode_percent(self, encoded: Span[UInt8], mode: PercentMode) -> List[UInt8]encodedSpan[UInt8] | A path or a query value, still percent-encoded. | |
|---|---|---|
modePercentMode | Whether a '+' is itself or a space. |
Error with INVALID_ARGUMENT on a '%' without two hexadecimal digits.generate_noise_keypairDraws a fresh static keypair from the operating system's entropy. Calls ucall_noise_key_generate.def generate_noise_keypair(self) -> Tuple[SIMD[.uint8, 32], SIMD[.uint8, 32]]Error if the operating system offers no entropy.derive_noise_public_keyThe public key of a stored private key, as peers see it during the handshake. Calls ucall_noise_key_derive.