eve

Public EVE package surface.

This module provides the stable, minimal public API for EVE:

  • Layer 1 (Core): EventLoop, Timers, Signals, Watchers, Cancellation
  • Layer 2 (Async I/O): TCP, UDP, Unix Sockets, Pipes, Files, DNS, Shutdown
  • Common types: IpAddress, AddressFamily, Result enums

Layer 3 (Runtime/Concurrency) is intentionally NOT included in this default import. Layer 3 provides higher-level abstractions like Futures, Channels, Fibers, and Thread Pools that include blocking operations. To use Layer 3, explicitly import it:

import eve.rt;

This separation ensures that:

  1. Users cannot accidentally block event-loop threads with blocking Channel operations (send/receive) when using the default import.
  2. The default API surface remains stable and minimal.
  3. Layer 3's stable-but-opt-in status is clear through explicit opt-in.

See also:

  • eve.core: Layer 1 core loop primitives
  • eve.aio: Layer 2 async I/O primitives
  • eve.rt: Layer 3 runtime/concurrency (opt-in)
No exported symbols.