go-patterns

What problem does it solve?

Writing clean, efficient, and concurrent Go code requires adherence to idiomatic patterns and best practices. Without clear guidance, Go projects can suffer from goroutine leaks, race conditions, and poor error handling.

Core Features & Use Cases

• Interface Design: Master small, focused interfaces and the "accept interfaces, return structs" principle.
• Error Handling: Implement robust error wrapping, sentinel errors, and custom error types for clear diagnostics.
• Concurrency Patterns: Safely use goroutines with WaitGroup, worker pools, and context for cancellation and deadlines.
• Testing Patterns: Write effective table-driven tests, test helpers, and interface-based mocking for comprehensive coverage.
• Functional Options: Design configurable constructors for flexible and extensible APIs.
• Use Case: Design a concurrent worker pool, implement robust error handling for an API, or write a table-driven test for a utility function.

Quick Start

Implement a Go function that reads from an io.Reader and returns an error, demonstrating proper error wrapping and context propagation.