orchestra

package

v0.8.0 Latest Latest Go to latest Published: Mar 9, 2020 License: BSD-3-Clause Imports: 13 Imported by: 0

Details

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

Repository

github.com/ooni/probe-engine

Links

Open Source Insights

Documentation ¶

Overview ¶

Package orchestra contains common orchestra code. Orchestra is a set of OONI APIs for probe orchestration. You can find code implementing each specific API into a subpackage of this package. This package contains the toplevel orchestra client that the session should use.

Index ¶

type Client
- func NewClient(httpClient *http.Client, logger model.Logger, userAgent string, ...) *Client

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Client ¶

type Client struct {
	HTTPClient         *http.Client
	Logger             model.Logger
	OrchestrateBaseURL string
	RegistryBaseURL    string
	StateFile          *statefile.StateFile
	UserAgent          string
	// contains filtered or unexported fields
}

Client is a client for OONI orchestra

func NewClient ¶

func NewClient(
	httpClient *http.Client, logger model.Logger,
	userAgent string, stateFile *statefile.StateFile,
) *Client

NewClient creates a new client.

func (*Client) FetchPsiphonConfig ¶

func (c *Client) FetchPsiphonConfig(ctx context.Context) ([]byte, error)

FetchPsiphonConfig fetches psiphon config from authenticated OONI orchestra.

func (*Client) FetchTorTargets ¶ added in v0.5.0

func (c *Client) FetchTorTargets(ctx context.Context) (map[string]model.TorTarget, error)

FetchTorTargets returns the targets for the tor experiment.

func (*Client) MaybeLogin ¶

func (c *Client) MaybeLogin(ctx context.Context) error

MaybeLogin performs login if necessary

func (*Client) MaybeRegister ¶

func (c *Client) MaybeRegister(
	ctx context.Context, metadata metadata.Metadata,
) error

MaybeRegister registers this client if not already registered

func (*Client) Update ¶

func (c *Client) Update(
	ctx context.Context, metadata metadata.Metadata,
) error

Update updates the state of a probe

Source Files ¶

View all Source files

orchestra.go

Directories ¶

Path	Synopsis
login Package login contains code to login with OONI orchestra.	Package login contains code to login with OONI orchestra.
metadata Package metadata contains metadata about a probe	Package metadata contains metadata about a probe
register Package register contains code to register to the OONI orchestra.	Package register contains code to register to the OONI orchestra.
statefile Package statefile defines the state file	Package statefile defines the state file
testlists
psiphon Package psiphon implements fetching psiphon config using orchestra	Package psiphon implements fetching psiphon config using orchestra
tor Package tor contains code to fetch targets for the tor experiment.	Package tor contains code to fetch targets for the tor experiment.
urls Package urls queries orchestra test-lists/urls API	Package urls queries orchestra test-lists/urls API
testorchestra Package testorchestra contains code to simplify testing	Package testorchestra contains code to simplify testing
update Package update contains code to update the probe state with orchestra	Package update contains code to update the probe state with orchestra

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