panicguard

Documentation

Overview

Package panicguard runs background work in a goroutine with a recovery frame.

The gRPC recovery middleware only wraps the request handler's own stack. A goroutine spawned from a handler escapes it, so an unrecovered panic there terminates the whole process. Any request-spawned goroutine must therefore run through this package instead of a bare `go`.

Index

• func Go(logger *log.Helper, task string, fn func())
• func Recover(logger *log.Helper, task string, fn func())

Functions

func Go

func Go(logger *log.Helper, task string, fn func())

Go runs fn in a new goroutine with a recovery frame. A recovered panic is logged with its stack and swallowed so it cannot crash the process.

func Recover

func Recover(logger *log.Helper, task string, fn func())

Recover runs fn in the current goroutine with a recovery frame. It is the synchronous core of Go, exposed for callers that already own a goroutine and for tests.