🤖 provisiontest

amadan.net/rastrillo/rastrillo/provision/provisiontest

Use provisiontest to test code that uses provision, with no network. New returns a fake console and edge that give the platform's own answers.

Pass p.Client() as Config.HTTP and to the probes, and p.Console() as Config.Console.

Set it up as a person sets up the platform. Enable turns instances on for an app, Credential makes an app-bound credential with a role, Attach gives the hub app its product hostname, and Serve sets what the app's instances run.

Tenant(slug) and Hub() are handlers that answer /api/version and name themselves, as NameInstance does. With slug set, a tenant also answers under /<slug>. With "", it answers 404 there, which CheckRoute reads as NoBasePath.

Use instance domains under AppsDomain, such as bdf.oncarlos.test. An unknown host there gets the setting-up page. Any other unknown host gets a 404.

Release sets the version header on an app's answers. Give the hub and the tenant different versions to test FellThrough and NoBasePath.

To test what can go wrong, Script queues answers for the next creates, and ScriptPaths for the next publishes. A Reply with Record set writes first, then answers, as a lost answer after the write does. One with Hang waits until the request's context ends. Every other Reply needs a Status, or Script panics.

Unready(n) makes each new instance answer its first n requests with the setting-up page. OtherBox moves an instance to another box, so a path to it falls through to the hub.

Instances, Paths and Calls show what your code did. Calls leaves out query strings.

API

const AppsDomain = "oncarlos.test"

type Platform struct{ /* unexported */ }
type Reply struct {
	Status     int
	RetryAfter string
	Hang       bool
	Record     bool
}

func New() *Platform
func Tenant(slug string) func(host string) http.Handler
func Hub() func(host string) http.Handler

func (p *Platform) RoundTrip(req *http.Request) (*http.Response, error)
func (p *Platform) Client() *http.Client
func (p *Platform) Console() string
func (p *Platform) Enable(account, app, domain string)
func (p *Platform) Credential(account, app, role string) string
func (p *Platform) Release(account, app, version string)
func (p *Platform) Serve(account, app string, h func(host string) http.Handler)
func (p *Platform) Attach(account, app, host string)
func (p *Platform) OtherBox(host string)
func (p *Platform) Unready(n int)
func (p *Platform) Script(replies ...Reply)
func (p *Platform) ScriptPaths(replies ...Reply)
func (p *Platform) Instances(account, app string) []string
func (p *Platform) Paths(host string) map[string]string
func (p *Platform) Calls() []string

Read this page as markdown — exact, unstyled, and cheap for an agent to fetch.