Module context.onecontext stdlib

context.onecontext
Version:
0.3.3
License:
MIT
Dependencies from vmod:
0
Imports:
4
Imported by:
0
Repository:
OS-specific
Show selected OS-specific symbols.
Backend-specific
Show selected Backend-specific symbols.

Dependencies defined in v.mod

This section is empty.

Imports

Imported by

This section is empty.

Overview

A library to merge existing V contexts.

Overview

Have you ever faced the situation where you have to merge multiple existing contexts? If not, then you might, eventually.

For example, we can face the situation where we are building an application using a library that gives us a global context. This context expires once the application is stopped.

Meanwhile, we are exposing a service like this:

fn (f Foo) get(ctx context.Context, bar Bar) ?Baz {
    . . .
}

Here, we receive another context provided by the service.

Then, in the get implementation, we want for example to query a database and we must provide a context for that.

Ideally, we would like to provide a merged context that would expire either:

  • When the application is stopped
  • Or when the received service context expires

This is exactly the purpose of this library.

In our case, we can now merge the two contexts in a single one like this:

ctx, cancel := onecontext.merge(ctx1, ctx2)

This returns a merged context that we can now propagate

Aliases

This section is empty.

Constants

#constant canceled

pub const canceled = error('canceled context')

canceled is the error returned when the cancel function is called on a merged context

Sum types

This section is empty.

Functions

#fn merge

fn merge(ctx context.Context, ctxs []context.Context) (context.Context, context.CancelFn)

merge allows to merge multiple contexts it returns the merged context

Structs

This section is empty.

Interfaces

This section is empty.

Enums

This section is empty.