errors

README

errors

errors is a wrapper around the standard errors.New and fmt.Errorf functions. It unifies their APIs, allowing you to create new errors or wrap existing ones with rich context (formatted message with arguments).

It provides two core functions:

errors.New(format string, args ...any) error
errors.Wrap(err error, format string, args ...any) error

While it previously had more features, I eventually realized that, in most cases, anything beyond simple error wrapping is an overcomplication.

Documentation

Overview

Package errors is a minimal wrapper around the standard library errors package. It changes the API from New(msg string) and fmt.Errorf(format string, args ...any) to unified New(format string, args ...any) and Wrap(err error, format string, args ...any) functions.

Index

• func As(err error, target any) bool
• func Is(err, target error) bool
• func New(format string, args ...any) error
• func Unwrap(err error) error
• func Wrap(err error, format string, args ...any) error

Functions

func As

func As(err error, target any) bool

func Is

func Is(err, target error) bool

func New

func New(format string, args ...any) error

func Unwrap

func Unwrap(err error) error

func Wrap

func Wrap(err error, format string, args ...any) error