context

README

tinywasm/context

Minimalist context library for TinyGo.

Features

• No Maps: Uses a fixed array of structs to avoid dynamic allocations.
• Minimal Footprint: Designed to keep binary size at a minimum.
• TinyGo Compatible: Fully compatible with TinyGo and WASM environments.
• Fixed Capacity: Maximum of 16 key-value pairs (prioritizes latest values).

Installation

go get github.com/tinywasm/context

Usage

import "github.com/tinywasm/context"

// Create background context
ctx := context.Background()

// Add values (Keys and Values must be strings)
ctx, _ = context.WithValue(ctx, "user_id", "123")
ctx, _ = context.WithValue(ctx, "role", "admin")

// Retrieve values
user := ctx.Value("user_id") // returns "123"
role := ctx.Value("role")    // returns "admin"
missing := ctx.Value("none") // returns ""

Constraints

• Keys and Values are restricted to string type for performance and simplicity.
• Maximum capacity of 16 key-value pairs. Exceeding this will return an error.

Documentation

Index

• Variables
• type Context
  • func Background() *Context
  • func TODO() *Context
  • func WithValue(parent *Context, key, value string) (*Context, error)
  • func (c *Context) Value(key string) string

Variables

var ErrCapacityExceeded = errors.New("context: max 16 values exceeded")

ErrCapacityExceeded is returned when the context reaches its maximum capacity of 16 pairs.

Types

type Context

type Context struct {
	// contains filtered or unexported fields
}

Context is a minimalist context compatible with TinyGo. No maps, no channels, uses a fixed array of 16 key-value pairs.

func Background

func Background() *Context

Background returns an empty Context (equivalent to context.Background).

func TODO

func TODO() *Context

TODO returns an empty Context (equivalent to context.TODO).

func WithValue

func WithValue(parent *Context, key, value string) (*Context, error)

WithValue creates a new Context with the additional key-value pair. Returns ErrCapacityExceeded if the capacity of 16 pairs is exceeded.

func (*Context) Value

func (c *Context) Value(key string) string

Value searches for the value associated with key (reverse search to prioritize latest values).