$ show quii/learn-go-with-tests
This repository is an educational book/course titled 'Learn Go with Tests' by Chris James. It teaches the Go programming language through test-driven development (TDD), building small but complete example applications incrementally. The code is organized by chapter with progressive versions (v1, v2, ...) that demonstrate the TDD red-green-refactor cycle. The primary example application is a poker/league scoring system with an HTTP server, JSON file persistence, a CLI interface, and WebSocket support for real-time games. Other examples include an SVG analog clock generator, a blog post renderer using HTML templates, a dictionary with CRUD operations, and various standalone concept demonstrations (concurrency, context, reflection, generics). The repository is not a single production application but a collection of well-tested, pedagogical code that illustrates idiomatic Go patterns, interface-based design, dependency injection, and testing strategies (unit tests, acceptance tests, property-based tests, and test doubles).
The LLM identified 4 files worth highlighting for reuse:
A generic Stack[T any] implementation with Push, Pop, and IsEmpty methods. It is fully self-contained, uses no internal imports beyond the standard library, and demonstrates Go generics in a clean, reusable way. Can be extracted into any Go project needing a type-safe stack.
A library that generates SVG markup for an analog clock face given a time.Time value. It computes hand angles using trigonometric functions and outputs SVG line/circle elements. The package is isolated (depends only on standard library and its own clockface angle functions) and can be reused in any project needing clock visualization or SVG generation from geometric calculations.
A cancellable io.Reader that wraps another io.Reader and respects context cancellation. It reads into a buffer and checks the context's Done channel, returning early if cancelled. This pattern is reusable for any I/O operation that needs to be interruptible, and it demonstrates non-obvious skill in combining context with streaming reads.
A blog post renderer that converts a Post struct into HTML using Go's html/template with embedded templates (via //go:embed). It supports rendering a single post and an index of posts. The package is self-contained, uses only standard library, and can be extracted to render any structured content into HTML with custom templates.