Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

brownout

package module

Go to main page

Versions in this module

v0

v0.1.3

Oct 21, 2026

v0.1.1

Oct 13, 2026

Changes in this version

+ type Controller struct

+ func New(opts ...Option) *Controller

+ func (c *Controller) AdminHandler() http.Handler

+ func (c *Controller) Check(req *http.Request) (Rule, bool)

+ func (c *Controller) Clear()

+ func (c *Controller) LoadFile(path string) error

+ func (c *Controller) Middleware(next http.Handler) http.Handler

+ func (c *Controller) Remove(id string) bool

+ func (c *Controller) Replace(rules []Rule) error

+ func (c *Controller) Rule(id string) (Rule, bool)

+ func (c *Controller) Rules() []Rule

+ func (c *Controller) Set(rule Rule) error

+ func (c *Controller) WatchFile(ctx context.Context, path string, interval time.Duration, onError func(error)) error

+ type Option func(*Controller)

+ func WithClock(now func() time.Time) Option

+ func WithDefaultStatus(code int) Option

+ func WithOnShed(fn func(req *http.Request, rule Rule)) Option

+ func WithResponder(fn Responder) Option

+ type Responder func(w http.ResponseWriter, req *http.Request, rule Rule)

+ type Rule struct

+ AllowPercent float64

+ ExpiresAt time.Time

+ ID string

+ Message string

+ Methods []string

+ Path string

+ RetryAfterSeconds int

+ StatusCode int

+ func (r Rule) Matches(req *http.Request, now time.Time) bool

+ func (r Rule) Validate() error

v0.1.0

Oct 13, 2026