contextx

package

v0.2.12 Latest Latest Go to latest Published: Jan 19, 2026 License: MIT Imports: 5 Imported by: 3

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/xoctopus/x

Links

Open Source Insights

Documentation ¶

Index ¶

func WithValue(parent context.Context, k, v any) context.Context
type Carrier
- func Compose(carriers ...Carrier) Carrier
type Context
- func NewT[T any](options ...Option[T]) Context[T]
- func NewV[T any](v T) Context[T]
type Option
- func WithDefault[T any](v T) Option[T]
- func WithOnce[T any]() Option[T]
type Valuer

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func WithValue ¶

func WithValue(parent context.Context, k, v any) context.Context

WithValue like context.WithValue but faster🤏

Example ¶

var ctx context.Context

type key1 struct{}
type key2 struct{}
type key3 struct{}
type key4 struct{}

ctx = contextx.WithValue(MockContext{}, key1{}, "1")
fmt.Println(ctx)
ctx = contextx.WithValue(ctx, key2{}, "2")
fmt.Println(ctx)
ctx = contextx.WithValue(ctx, key3{}, net.IPv4(1, 1, 1, 1))
fmt.Println(ctx)
ctx = contextx.WithValue(ctx, key4{}, 4)
fmt.Println(ctx)

fmt.Println("context value key1:", ctx.Value(key1{}))
fmt.Println("context value key2:", ctx.Value(key2{}))
fmt.Println("context value key3:", ctx.Value(key3{}))
fmt.Println("context value key4:", ctx.Value(key4{}))

Output:

contextx_test.MockContext.WithValue(key:contextx_test.key1, val:1)
contextx_test.MockContext.WithValue(key:contextx_test.key1, val:1).WithValue(key:contextx_test.key2, val:2)
contextx_test.MockContext.WithValue(key:contextx_test.key1, val:1).WithValue(key:contextx_test.key2, val:2).WithValue(key:contextx_test.key3, val:1.1.1.1)
contextx_test.MockContext.WithValue(key:contextx_test.key1, val:1).WithValue(key:contextx_test.key2, val:2).WithValue(key:contextx_test.key3, val:1.1.1.1).WithValue(key:contextx_test.key4, val:<not Stringer>)
context value key1: 1
context value key2: 2
context value key3: 1.1.1.1
context value key4: 4

Types ¶

type Carrier ¶ added in v0.2.1

type Carrier func(context.Context) context.Context

func Compose ¶ added in v0.0.25

func Compose(carriers ...Carrier) Carrier

Example ¶

c1 := contextx.NewT[string]()
c2 := contextx.NewT[int]()
c3 := contextx.NewT[fmt.Stringer]()

ctx := contextx.Compose(
	c1.Carry("1"),
	c2.Carry(2),
	c3.Carry(net.IPv4(1, 1, 1, 1)),
)(context.Background())
fmt.Println(ctx)
fmt.Println(c1.MustFrom(ctx))
fmt.Println(c2.MustFrom(ctx))
fmt.Println(c3.MustFrom(ctx))

Output:

context.Background.WithValue(key:*contextx.ctx[string], val:1).WithValue(key:*contextx.ctx[int], val:<not Stringer>).WithValue(key:*contextx.ctx[fmt.Stringer], val:1.1.1.1)
1
2
1.1.1.1

type Context ¶ added in v0.0.21

type Context[T any] interface {
	With(context.Context, T) context.Context
	From(context.Context) (T, bool)
	MustFrom(context.Context) T
	Carry(v T) Carrier
}

func NewT ¶ added in v0.0.25

func NewT[T any](options ...Option[T]) Context[T]

func NewV ¶ added in v0.0.25

func NewV[T any](v T) Context[T]

type Option ¶ added in v0.0.21

type Option[T any] func(*ctx[T])

func WithDefault ¶ added in v0.0.25

func WithDefault[T any](v T) Option[T]

func WithOnce ¶ added in v0.2.1

func WithOnce[T any]() Option[T]

type Valuer ¶ added in v0.0.21

type Valuer[T any] func() T

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL