actor

package

v0.3.0 Latest Latest Go to latest Published: Nov 5, 2026 License: MIT Imports: 2 Imported by: 0

Details

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

Repository

github.com/jtarchie/steps

Links

Open Source Insights

Documentation ¶

Overview ¶

Package actor names who or what caused something steps records: a person, or the automatic thing that stood in for one. It is a stdlib-only leaf so the request that learns the person and the page that shows them can share one vocabulary without either importing the other.

The serialized form ("kind:id") is what the state database stores, so the store stays a string column and never learns this type.

Index ¶

func With(ctx context.Context, a Actor) context.Context
type Actor

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func With ¶

func With(ctx context.Context, a Actor) context.Context

With carries the actor a request was made by into everything it calls.

Types ¶

type Actor ¶

type Actor struct {
	Kind string
	ID   string
}

Actor is a kind and an id within it. The zero value is "nobody recorded", which every reader treats as absent rather than as a name.

func Backlog ¶

func Backlog() Actor

Backlog is a job queueing itself again for versions a build left waiting.

func Check ¶

func Check(resource string) Actor

Check is a new version of a resource starting work.

func From ¶

func From(ctx context.Context) Actor

From is the actor ctx carries, zero when none was set.

func Local ¶

func Local(name string) Actor

Local is a person who signed in with one of the daemon's own accounts.

func OS ¶

func OS(user string) Actor

OS is a person named only by the environment of a command run on the daemon's machine. Nothing verified it, and every rendering says so.

func Parse ¶

func Parse(stored string) Actor

Parse reads the stored form back. A value with no colon is a name written before actors existed (approvals recorded "web"), kept as an id with no kind rather than guessed at.