tmrts/go-patterns

Curated list of Go design patterns, recipes and idioms

28,257

63 commits

updated May 14, 2024

tmrts.com/go-patterns

See the code

README

Go Patterns

A curated collection of idiomatic design & application patterns for Go language.

Creational Patterns

Pattern	Description	Status
Abstract Factory	Provides an interface for creating families of releated objects	✘
Builder	Builds a complex object using simple objects	✔
Factory Method	Defers instantiation of an object to a specialized function for creating instances	✔
Object Pool	Instantiates and maintains a group of objects instances of the same type	✔
Singleton	Restricts instantiation of a type to one object	✔

Structural Patterns

Pattern	Description	Status
Bridge	Decouples an interface from its implementation so that the two can vary independently	✘
Composite	Encapsulates and provides access to a number of different objects	✘
Decorator	Adds behavior to an object, statically or dynamically	✔
Facade	Uses one type as an API to a number of others	✘
Flyweight	Reuses existing instances of objects with similar/identical state to minimize resource usage	✘
Proxy	Provides a surrogate for an object to control it's actions	✔

Behavioral Patterns

Pattern	Description	Status
Chain of Responsibility	Avoids coupling a sender to receiver by giving more than object a chance to handle the request	✘
Command	Bundles a command and arguments to call later	✘
Mediator	Connects objects and acts as a proxy	✘
Memento	Generate an opaque token that can be used to go back to a previous state	✘
Observer	Provide a callback for notification of events/changes to data	✔
Registry	Keep track of all subclasses of a given class	✘
State	Encapsulates varying behavior for the same object based on its internal state	✘
Strategy	Enables an algorithm's behavior to be selected at runtime	✔
Template	Defines a skeleton class which defers some methods to subclasses	✘
Visitor	Separates an algorithm from an object on which it operates	✘

Synchronization Patterns

Pattern	Description	Status
Condition Variable	Provides a mechanism for threads to temporarily give up access in order to wait for some condition	✘
Lock/Mutex	Enforces mutual exclusion limit on a resource to gain exclusive access	✘
Monitor	Combination of mutex and condition variable patterns	✘
Read-Write Lock	Allows parallel read access, but only exclusive access on write operations to a resource	✘
Semaphore	Allows controlling access to a common resource	✔

Concurrency Patterns

Pattern	Description	Status
N-Barrier	Prevents a process from proceeding until all N processes reach to the barrier	✘
Bounded Parallelism	Completes large number of independent tasks with resource limits	✔
Broadcast	Transfers a message to all recipients simultaneously	✘
Coroutines	Subroutines that allow suspending and resuming execution at certain locations	✘
Generators	Yields a sequence of values one at a time	✔
Reactor	Demultiplexes service requests delivered concurrently to a service handler and dispatches them syncronously to the associated request handlers	✘
Parallelism	Completes large number of independent tasks	✔
Producer Consumer	Separates tasks from task executions	✘

Messaging Patterns

Pattern	Description	Status
Fan-In	Funnels tasks to a work sink (e.g. server)	✔
Fan-Out	Distributes tasks among workers (e.g. producer)	✔
Futures & Promises	Acts as a place-holder of a result that is initially unknown for synchronization purposes	✘
Publish/Subscribe	Passes information to a collection of recipients who subscribed to a topic	✔
Push & Pull	Distributes messages to multiple workers, arranged in a pipeline	✘

Stability Patterns

Pattern	Description	Status
Bulkheads	Enforces a principle of failure containment (i.e. prevents cascading failures)	✘
Circuit-Breaker	Stops the flow of the requests when requests are likely to fail	✔
Deadline	Allows clients to stop waiting for a response once the probability of response becomes low (e.g. after waiting 10 seconds for a page refresh)	✘
Fail-Fast	Checks the availability of required resources at the start of a request and fails if the requirements are not satisfied	✘
Handshaking	Asks a component if it can take any more load, if it can't, the request is declined	✘
Steady-State	For every service that accumulates a resource, some other service must recycle that resource	✘

Profiling Patterns

Pattern	Description	Status
Timing Functions	Wraps a function and logs the execution	✔

Idioms

Pattern	Description	Status
Functional Options	Allows creating clean APIs with sane defaults and idiomatic overrides	✔

Anti-Patterns

Pattern	Description	Status
Cascading Failures	A failure in a system of interconnected parts in which the failure of a part causes a domino effect	✘

awesome

design-patterns

design-patterns-for-humans

golang

idioms

patterns

Significant stargazers

(top 24 of 217)

Ettore Di Giacinto

2,576 followers · starred Sep 2016

Oleksandr Redko

283 followers · starred Dec 2025

Márk Sági-Kazár

1,389 followers · starred Sep 2019

Antonio Ojea

599 followers · starred May 2020

Similar repos

senghoo/golang-design-pattern

设计模式 Golang实现－《研磨设计模式》读书笔记

9,030

faif/python-patterns

A collection of design patterns/idioms in Python

43,045

lpxxn/rust-design-pattern

rust design patterns

1,435

nilbuild/design-patterns-for-humans

An ultra-simplified explanation to design patterns

48,896

fadeevab/design-patterns-rust

Rust examples for all 23 classic GoF design patterns, and even a little more

1,059

betty200744/ultimate-go

This repo contains my notes on working with Go and computer systems.

1,936

wesdoyle/design-patterns-explained-with-food

GoF Design Patterns with "Real-World" examples involving Food-Related Businesses and mock…

2,434

lotusirous/go-concurrency-patterns

Concurrency patterns in Go

3,121