apitesting

Documentation

Index

• type AsyncResponse
• type Client
  • func New(url string, username string, accessKey string, timeout time.Duration) Client
  • func (c *Client) GetEventResult(ctx context.Context, hookID string, eventID string) (TestResult, error)
  • func (c *Client) GetHooks(ctx context.Context, projectID string) ([]Hook, error)
  • func (c *Client) GetProject(ctx context.Context, hookID string) (Project, error)
  • func (c *Client) GetProjects(ctx context.Context) ([]Project, error)
  • func (c *Client) GetTest(ctx context.Context, hookID string, testID string) (Test, error)
  • func (c *Client) RunAllAsync(ctx context.Context, hookID string, buildID string, tunnel config.Tunnel, ...) (AsyncResponse, error)
  • func (c *Client) RunEphemeralAsync(ctx context.Context, hookID string, buildID string, tunnel config.Tunnel, ...) (AsyncResponse, error)
  • func (c *Client) RunTagAsync(ctx context.Context, hookID string, testTag string, buildID string, ...) (AsyncResponse, error)
  • func (c *Client) RunTestAsync(ctx context.Context, hookID string, testID string, buildID string, ...) (AsyncResponse, error)
• type Hook
• type Project
• type PublishedTest
• type Test
• type TestRequest
• type TestResult

Types

type AsyncResponse

type AsyncResponse struct {
	ContextIDs []string `json:"contextIds,omitempty"`
	EventIDs   []string `json:"eventIds,omitempty"`
	TaskID     string   `json:"taskId,omitempty"`
	TestIDs    []string `json:"testIds,omitempty"`
}

AsyncResponse describes the json response from the async api endpoints.

type Client

type Client struct {
	HTTPClient *http.Client
	URL        string
	Username   string
	AccessKey  string
}

Client describes an interface to the api-testing rest endpoints.

func New

func New(url string, username string, accessKey string, timeout time.Duration) Client

New returns a apitesting.Client

func (*Client) GetEventResult

func (c *Client) GetEventResult(ctx context.Context, hookID string, eventID string) (TestResult, error)

func (*Client) GetHooks

func (c *Client) GetHooks(ctx context.Context, projectID string) ([]Hook, error)

GetHooks returns the list of hooks available.

func (*Client) GetProject

func (c *Client) GetProject(ctx context.Context, hookID string) (Project, error)

GetProject returns Project metadata for a given hookID.

func (*Client) GetProjects

func (c *Client) GetProjects(ctx context.Context) ([]Project, error)

GetProjects returns the list of Project available.

func (*Client) GetTest

func (c *Client) GetTest(ctx context.Context, hookID string, testID string) (Test, error)

func (*Client) RunAllAsync

func (c *Client) RunAllAsync(ctx context.Context, hookID string, buildID string, tunnel config.Tunnel, test TestRequest) (AsyncResponse, error)

RunAllAsync runs all the tests for the project described by hookID and returns without waiting for their results.

func (*Client) RunEphemeralAsync

func (c *Client) RunEphemeralAsync(ctx context.Context, hookID string, buildID string, tunnel config.Tunnel, taskID string, test TestRequest) (AsyncResponse, error)

RunEphemeralAsync runs the tests for the project described by hookID and returns without waiting for their results.

func (*Client) RunTagAsync

func (c *Client) RunTagAsync(ctx context.Context, hookID string, testTag string, buildID string, tunnel config.Tunnel, test TestRequest) (AsyncResponse, error)

RunTagAsync runs all the tests for a testTag for a project described by hookID and returns without waiting for results.

func (*Client) RunTestAsync

func (c *Client) RunTestAsync(ctx context.Context, hookID string, testID string, buildID string, tunnel config.Tunnel, test TestRequest) (AsyncResponse, error)

RunTestAsync runs a single test described by testID for the project described by hookID and returns without waiting for results.

type Hook

type Hook struct {
	Identifier string `json:"identifier,omitempty"`
	Name       string `json:"name,omitempty"`
}

Hook describes the metadata for a hook.

type Project

type Project struct {
	ID   string `json:"id,omitempty"`
	Name string `json:"name,omitempty"`
}

Project describes the metadata for an api testing project.

type PublishedTest

type PublishedTest struct {
	Published Test
}

PublishedTest describes a published test.

type Test

type Test struct {
	ID   string `json:"id,omitempty"`
	Name string `json:"name,omitempty"`
}

Test describes a single test.

type TestRequest

type TestRequest struct {
	Name   string            `json:"name"`
	Tags   []string          `json:"tags"`
	Input  string            `json:"input"`
	Unit   string            `json:"unit"`
	Params map[string]string `json:"params"`
}

TestRequest represent a test to be executed

type TestResult

type TestResult struct {
	EventID              string  `json:"_id,omitempty"`
	FailuresCount        int     `json:"failuresCount,omitempty"`
	Project              Project `json:"project,omitempty"`
	Test                 Test    `json:"test,omitempty"`
	ExecutionTimeSeconds int     `json:"executionTimeSeconds,omitempty"`
	Async                bool    `json:"-"`
	TimedOut             bool    `json:"-"`
}

TestResult describes the result from running an api test.