artifacts

type BaseArtifact struct {
	Name    string
	Expires tcclient.Time
}

type ErrorArtifact struct {
	*BaseArtifact
	Path    string
	Message string
	Reason  string
}

type LinkArtifact struct {
	*BaseArtifact
	Artifact    string
	ContentType string
}

type Logger interface {
	// Infof formats and lots a message at the info level
	Infof(format string, a ...interface{})

	// Errorf formats and lots a message at the error level
	Errorf(format string, a ...interface{})
}

type ObjectArtifact struct {
	*BaseArtifact
	// Path is the task-directory-relative path to the file (as given in
	// the task description, for example)
	Path string
	// RawContentFile is the filename of the file containing the data
	// for this artifact.
	RawContentFile string
	// ContentType is used in the Content-Type header.
	ContentType string
}

type RedirectArtifact struct {
	*BaseArtifact
	URL         string
	ContentType string
}

type S3Artifact struct {
	*BaseArtifact
	// Path is the task-directory-relative path to the file (as given in
	// the task description, for example)
	Path string
	// RawContentFile is the filename of the file containing the data
	// for this artifact.
	RawContentFile  string
	ContentEncoding string
	ContentType     string
}

type TaskArtifact interface {

	// RequestObject returns a pointer to a go type containing the data for
	// marshaling into tcqueue.PostArtifactRequest for passing to
	// tcqueue.CreateArtifact.
	//
	// For example, this is a *tcqueue.S3ArtifactRequest for type
	// S3Artifact.
	RequestObject() interface{}

	// ResponseObject returns a pointer to an empty go type for
	// unmarshaling the result of a tcqueue.CreateArtifact API call into.
	//
	// For example, this would be new(tcqueue.RedirectArtifactRequest) for
	// RedirectArtifact.
	ResponseObject() interface{}

	// ProcessResponse is a callback for performing actions after
	// tcqueue.CreateArtifact API is called. response is the object
	// returned by ResponseObject(), but populated with the result of
	// tcqueue.CreateArtifact.
	//
	// For example, ProcessResponse for S3Artifact uploads the artifact to
	// S3, since the tcqueue.CreateArtifact API call only informs the Queue
	// that the artifact exists without uploading it.
	//
	// ProcessResponse can be an empty method if no post
	// tcqueue.CreateArtifact steps are required.
	ProcessResponse(response interface{}, logger Logger, serviceFactory tc.ServiceFactory, config *gwconfig.Config) error

	// FinishArtifact calls queue.FinishArtifact if necessary for the artifact type
	FinishArtifact(response interface{}, queue tc.Queue, taskID, runID, name string) error

	// Base returns a *BaseArtifact which stores the properties common to
	// all implementations
	Base() *BaseArtifact
}