runtimeerror

Documentation

Overview

Package runtimeerror adds safe context at runtime boundaries.

Index

• func Wrap(operation string, identity SafeIdentity, cause error) error
• type SafeIdentity
  • func NewSafeIdentity(value string) (SafeIdentity, error)
  • func (identity SafeIdentity) LogValue() slog.Value
  • func (identity SafeIdentity) String() string

Functions

func Wrap

func Wrap(operation string, identity SafeIdentity, cause error) error

Wrap annotates cause with a safe operation and identity while preserving errors.Is and errors.As.

Types

type SafeIdentity

type SafeIdentity struct {
	// contains filtered or unexported fields
}

SafeIdentity is bounded ASCII text approved for errors and logs.

func NewSafeIdentity

func NewSafeIdentity(value string) (SafeIdentity, error)

NewSafeIdentity validates a diagnostic identity before use.

func (SafeIdentity) LogValue

func (identity SafeIdentity) LogValue() slog.Value

LogValue implements slog.LogValuer using only validated safe text.

func (SafeIdentity) String

func (identity SafeIdentity) String() string

String returns the validated safe value.