conditionalflowapi

package
v1.31.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 16, 2026 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Index

Constants

View Source
const Hostname = "conditionalflow.verify"

Hostname is the default hostname of the microservice.

Variables

View Source
var (
	// HINT: Insert endpoint definitions here
	TaskA       = Def{Method: "POST", Route: ":428/task-a"}     // MARKER: TaskA
	TaskHigh    = Def{Method: "POST", Route: ":428/task-high"}  // MARKER: TaskHigh
	TaskLow     = Def{Method: "POST", Route: ":428/task-low"}   // MARKER: TaskLow
	TaskC       = Def{Method: "POST", Route: ":428/task-c"}     // MARKER: TaskC
	Conditional = Def{Method: "GET", Route: ":428/conditional"} // MARKER: Conditional
)

Functions

This section is empty.

Types

type Client

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

Client is a lightweight proxy for making unicast calls to the microservice.

func NewClient

func NewClient(caller service.Publisher) Client

NewClient creates a new unicast client proxy to the microservice.

func (Client) ForHost

func (_c Client) ForHost(host string) Client

ForHost returns a copy of the client with a different hostname to be applied to requests.

func (Client) WithOptions

func (_c Client) WithOptions(opts ...pub.Option) Client

WithOptions returns a copy of the client with options to be applied to requests.

type ConditionalIn

type ConditionalIn struct {
	Score int `json:"score,omitzero"`
}

ConditionalIn are the input arguments of Conditional.

type ConditionalOut

type ConditionalOut struct {
	FinalBranch string `json:"finalBranch,omitzero"`
}

ConditionalOut are the output arguments of Conditional.

type Def

type Def struct {
	Method string
	Route  string
}

Def is the routing identity of an endpoint exposed by this microservice.

func (Def) URL

func (d Def) URL() string

URL is the full URL of the endpoint, joined with the package-level Hostname.

type Executor

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

Executor runs tasks and workflows synchronously, blocking until termination. It is primarily intended for integration tests.

func NewExecutor

func NewExecutor(caller service.Publisher) Executor

NewExecutor creates a new executor proxy to the microservice.

func (Executor) Conditional

func (_c Executor) Conditional(ctx context.Context, score int) (finalBranch string, status string, err error)

Conditional creates and runs the Conditional workflow, blocking until termination.

func (Executor) ForHost

func (_c Executor) ForHost(host string) Executor

ForHost returns a copy of the executor with a different hostname to be applied to requests.

func (Executor) TaskA

func (_c Executor) TaskA(ctx context.Context, score int) (scoreOut int, err error)

TaskA creates and runs the TaskA task.

func (Executor) TaskC

func (_c Executor) TaskC(ctx context.Context, branch string) (finalBranch string, err error)

TaskC creates and runs the TaskC task.

func (Executor) TaskHigh

func (_c Executor) TaskHigh(ctx context.Context, score int) (branch string, err error)

TaskHigh creates and runs the TaskHigh task.

func (Executor) TaskLow

func (_c Executor) TaskLow(ctx context.Context, score int) (branch string, err error)

TaskLow creates and runs the TaskLow task.

func (Executor) WithInputFlow

func (_c Executor) WithInputFlow(flow *workflow.Flow) Executor

WithInputFlow returns a copy of the executor with an input flow to use for task execution. The input flow's state is available to the task in addition to the typed input arguments.

func (Executor) WithOptions

func (_c Executor) WithOptions(opts ...pub.Option) Executor

WithOptions returns a copy of the executor with options to be applied to requests.

func (Executor) WithOutputFlow

func (_c Executor) WithOutputFlow(flow *workflow.Flow) Executor

WithOutputFlow returns a copy of the executor with an output flow to populate after task execution. The output flow captures the full flow state including control signals (Goto, Retry, Interrupt, Sleep).

func (Executor) WithWorkflowRunner

func (_c Executor) WithWorkflowRunner(runner WorkflowRunner) Executor

WithWorkflowRunner returns a copy of the executor with a workflow runner for executing workflows. foremanapi.NewClient(svc) satisfies the WorkflowRunner interface.

type Hook

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

Hook assists in the subscription to the events of the microservice.

func NewHook

func NewHook(listener service.Subscriber) Hook

NewHook creates a new hook to the events of the microservice.

func (Hook) ForHost

func (c Hook) ForHost(host string) Hook

ForHost returns a copy of the hook with a different hostname to be applied to the subscription.

func (Hook) WithOptions

func (c Hook) WithOptions(opts ...sub.Option) Hook

WithOptions returns a copy of the hook with options to be applied to subscriptions.

type MulticastClient

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

MulticastClient is a lightweight proxy for making multicast calls to the microservice.

func NewMulticastClient

func NewMulticastClient(caller service.Publisher) MulticastClient

NewMulticastClient creates a new multicast client proxy to the microservice.

func (MulticastClient) ForHost

func (_c MulticastClient) ForHost(host string) MulticastClient

ForHost returns a copy of the client with a different hostname to be applied to requests.

func (MulticastClient) WithOptions

func (_c MulticastClient) WithOptions(opts ...pub.Option) MulticastClient

WithOptions returns a copy of the client with options to be applied to requests.

type MulticastTrigger

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

MulticastTrigger is a lightweight proxy for triggering the events of the microservice.

func NewMulticastTrigger

func NewMulticastTrigger(caller service.Publisher) MulticastTrigger

NewMulticastTrigger creates a new multicast trigger of events of the microservice.

func (MulticastTrigger) ForHost

func (_c MulticastTrigger) ForHost(host string) MulticastTrigger

ForHost returns a copy of the trigger with a different hostname to be applied to requests.

func (MulticastTrigger) WithOptions

func (_c MulticastTrigger) WithOptions(opts ...pub.Option) MulticastTrigger

WithOptions returns a copy of the trigger with options to be applied to requests.

type TaskAIn

type TaskAIn struct {
	Score int `json:"score,omitzero"`
}

TaskAIn are the input arguments of TaskA.

type TaskAOut

type TaskAOut struct {
	ScoreOut int `json:"score,omitzero"`
}

TaskAOut are the output arguments of TaskA.

type TaskCIn

type TaskCIn struct {
	Branch string `json:"branch,omitzero"`
}

TaskCIn are the input arguments of TaskC.

type TaskCOut

type TaskCOut struct {
	FinalBranch string `json:"finalBranch,omitzero"`
}

TaskCOut are the output arguments of TaskC.

type TaskHighIn

type TaskHighIn struct {
	Score int `json:"score,omitzero"`
}

TaskHighIn are the input arguments of TaskHigh.

type TaskHighOut

type TaskHighOut struct {
	Branch string `json:"branch,omitzero"`
}

TaskHighOut are the output arguments of TaskHigh.

type TaskLowIn

type TaskLowIn struct {
	Score int `json:"score,omitzero"`
}

TaskLowIn are the input arguments of TaskLow.

type TaskLowOut

type TaskLowOut struct {
	Branch string `json:"branch,omitzero"`
}

TaskLowOut are the output arguments of TaskLow.

type WorkflowRunner

type WorkflowRunner interface {
	Run(ctx context.Context, workflowName string, initialState any) (status string, state map[string]any, err error)
}

WorkflowRunner executes a workflow by name with initial state, blocking until termination. foremanapi.Client satisfies this interface.

Jump to

Keyboard shortcuts

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