name: golang.org/x/net/context
description: Package context defines the Context type, which carries deadlines,
cancelation signals, and other request-scoped values across API boundaries
and between processes.
As of Go 1.7 this package is available in the standard library under the
name context.  https://golang.org/pkg/context.

Incoming requests to a server should create a Context, and outgoing calls to
servers should accept a Context. The chain of function calls between must
propagate the Context, optionally replacing it with a modified copy created
using WithDeadline, WithTimeout, WithCancel, or WithValue.

Programs that use Contexts should follow these rules to keep interfaces
consistent across packages and enable static analysis tools to check context
propagation:

Do not store Contexts inside a struct type; instead, pass a Context
explicitly to each function that needs it. The Context should be the first
parameter, typically named ctx:

Do not pass a nil Context, even if a function permits it. Pass context.TODO
if you are unsure about which Context to use.

Use context Values only for request-scoped data that transits processes and
APIs, not for passing optional parameters to functions.

The same Context may be passed to functions running in different goroutines;
Contexts are safe for simultaneous use by multiple goroutines.

See http://blog.golang.org/context for example code for a server that uses
Contexts.
license_spdx: BSD-3-Clause
spec_version: 1.0
home_url: https://cs.opensource.google/go/x/net
date: 2023-10-12
about_resource: NONE
libraries_io_url: https://libraries.io/go/golang.org%2Fx%2Fnet%2Fcontext
