Go Raw Errors and Well-Formed Errors

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

  • Concurrency in Go by Katherine Cox-Buday, Chapter 5. "Concurrency At Scale", Section "Error Propagation"

Internal

Overview

This error handling pattern is built around the fact that all errors belong to one of two categories: bugs and known edge cases (disk full, network failure, etc.).

The pattern requires to represent the known edge cases as "well-formed" errors and declare them package-exported. When declared as such, errors become part of the package's public API and must be treated with as much care as any other part of the public API would be treated. All other errors are "raw errors" and represent bugs.

Further explore and document here if I find a use case.