`flare.net.error`

Typed network errors for flare.

Every error type implements Writable so it can be used with print() and String(). All types also implement Copyable and Movable because errors are often returned from functions, stored in Result types, or logged.

Design principle: every error instance carries enough context to understand the failure without a stack trace. Include the peer address, hostname, or port wherever relevant.

Structs

`NetworkError`

struct NetworkError

Generic network error — a catch-all for OS errors without a more specific typed variant.

Fields: message: Human-readable description (from strerror or caller). code: OS errno value (0 if not applicable).

Example:

raise NetworkError("connect failed", 111)

Implements Copyable, Movable, Writable

Fields: message: String; code: Int

`init`

def __init__(out self, message: String, code: Int = Int(0))

Initialise a NetworkError.

Args: message: Human-readable description of the failure.; code: OS errno value. Defaults to 0 (not an OS error).

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write a one-line description to writer.

Args: writer: Destination writer (e.g. stdout, a String).

`ConnectionRefused`

struct ConnectionRefused

Raised when a TCP connect() fails with ECONNREFUSED.

Fields: addr: String representation of the refused address (e.g. "127.0.0.1:8080"). code: OS errno value (always ECONNREFUSED).

Example:

raise ConnectionRefused("127.0.0.1:8080", 111)

Implements Copyable, Movable, Writable

Fields: addr: String; code: Int

`init`

def __init__(out self, addr: String, code: Int = Int(0))

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write "ConnectionRefused: addr" to writer.

Args: writer: Destination writer.

`ConnectionTimeout`

struct ConnectionTimeout

Raised when a TCP connect() times out (ETIMEDOUT).

Fields: addr: The target address that timed out. code: OS errno value.

Example:

raise ConnectionTimeout("10.0.0.1:443", 110)

Implements Copyable, Movable, Writable

Fields: addr: String; code: Int

`init`

def __init__(out self, addr: String, code: Int = Int(0))

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write "ConnectionTimeout: addr" to writer.

Args: writer: Destination writer.

`ConnectionReset`

struct ConnectionReset

Raised when the peer forcibly closes a connection (ECONNRESET).

Fields: addr: The remote address that sent a TCP RST. code: OS errno value.

Implements Copyable, Movable, Writable

Fields: addr: String; code: Int

`init`

def __init__(out self, addr: String, code: Int = Int(0))

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write a description to writer.

Args: writer: Destination writer.

`AddressInUse`

struct AddressInUse

Raised when bind() fails because the port is in use (EADDRINUSE).

Fields: addr: The address that could not be bound. code: OS errno value.

Example:

raise AddressInUse("0.0.0.0:8080", 98)

Implements Copyable, Movable, Writable

Fields: addr: String; code: Int

`init`

def __init__(out self, addr: String, code: Int = Int(0))

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write a description to writer.

Args: writer: Destination writer.

`AddressParseError`

struct AddressParseError

Raised when an address string cannot be parsed.

Fields: input: The invalid input string.

Example:

raise AddressParseError("not_an_ip")

Implements Copyable, Movable, Writable

Fields: input: String

`init`

def __init__(out self, input: String)

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write a description to writer.

Args: writer: Destination writer.

`BrokenPipe`

struct BrokenPipe

Raised on write to a connection whose read end is closed (EPIPE).

Fields: addr: The remote address of the closed connection (may be empty). code: OS errno value.

Implements Copyable, Movable, Writable

Fields: addr: String; code: Int

`init`

def __init__(out self, addr: String = "", code: Int = Int(0))

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write a description to writer.

Args: writer: Destination writer.

`Timeout`

struct Timeout

Raised when a blocking I/O operation exceeds its timeout.

Fields: op: Name of the operation that timed out (e.g. "recv"). ms: Timeout in milliseconds that was set (0 if unknown).

Example:

raise Timeout("recv", 5000)

Implements Copyable, Movable, Writable

Fields: op: String; ms: Int

`init`

def __init__(out self, op: String, ms: Int = Int(0))

Initialise a Timeout error.

Args: op: The operation that timed out.; ms: The configured timeout in milliseconds.

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write "Timeout: op" to writer.

Args: writer: Destination writer.

`DnsError`

struct DnsError

Raised when DNS resolution fails.

Fields: host: The hostname that could not be resolved. code: The getaddrinfo error code (from gai_strerror). reason: Human-readable reason from gai_strerror.

Example:

raise DnsError("notexist.example.com", 8, "Servname not supported")

Implements Copyable, Movable, Writable

Fields: host: String; code: Int; reason: String

`init`

def __init__(out self, host: String, code: Int = Int(0), reason: String = "")

`write_to`

def write_to[W: Writer](self, mut writer: W)

Write "DnsError(host): reason" to writer.

Args: writer: Destination writer.