go-interfaces

Design small Go interfaces by defining consumer-owned contracts in the package that uses them, returning concrete types from constructors, and keeping abstractions minimal to reduce coupling and prevent accidental API leaks.

Define interfaces in the consumer package in Go to avoid producer-owned abstractions and oversized contracts. This consumer-defined approach ensures interfaces are extracted only when multiple implementations are needed, improving testability.

The best way to choose between pointer and value receivers in Go is to keep the selection deliberate and consistent across a type's methods. This prevents inconsistent receiver patterns and avoids compile-time interface satisfaction issues.

Use compile-time interface checks safely in Go by assigning a concrete type to an interface variable at package scope. Apply comma-ok type assertions during runtime checks to prevent unexpected panics and verify type implementations.

Use struct embedding deliberately in Go to compose types while keeping interfaces minimal. This approach ensures package boundaries remain clean and prevents embedding mistakes that are difficult to unwind in production Go code.

Use struct embedding deliberately in Go to compose types while keeping interfaces minimal. This approach ensures package boundaries remain clean and prevents embedding mistakes that are difficult to unwind in production Go code.