files

README

Static File Upload Client

Usage

Setup

Local:

c := files.NewAPIClient("http://localhost:26900")

Remote:

c := files.NewAPIClient("http://localhost:12700")

Set collection ID

err := c.SetCollectionID(context.Background(), "testing/test.txt", "123456789")

if err != nil {
	...
}

Documentation

Index

• Variables
• type Client
  • func NewAPIClient(filesAPIURL, authToken string) *Client
  • func NewWithHealthClient(hcCli *healthcheck.Client) *Client
  • func (c *Client) Checker(ctx context.Context, check *health.CheckState) error
  • func (c *Client) GetFile(ctx context.Context, path string, authToken string) (FileMetaData, error)
  • func (c *Client) PublishCollection(ctx context.Context, collectionID string) error
  • func (c *Client) SetCollectionID(ctx context.Context, filepath, collectionID string) error
• type FileMetaData

Variables

var (
	ErrFileNotFound            = errors.New("file not found on dp-files-api")
	ErrFileAlreadyInCollection = errors.New("file collection ID already set")
	ErrNoFilesInCollection     = errors.New("no file in the collection")
	ErrInvalidState            = errors.New("files in an invalid state to publish")
	ErrNotAuthorized           = errors.New("you are not authorized for this action")
)

Types

type Client

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

Client is an files API client which can be used to make requests to the server. It extends the generic healthcheck Client structure.

func NewAPIClient

func NewAPIClient(filesAPIURL, authToken string) *Client

NewAPIClient creates a new instance of files Client with a given image API URL

func NewWithHealthClient

func NewWithHealthClient(hcCli *healthcheck.Client) *Client

NewWithHealthClient creates a new instances of files Client using healthcheck client

func (*Client) Checker

func (c *Client) Checker(ctx context.Context, check *health.CheckState) error

Checker calls image api health endpoint and returns a check object to the caller.

func (*Client) GetFile

func (c *Client) GetFile(ctx context.Context, path string, authToken string) (FileMetaData, error)

func (*Client) PublishCollection

func (c *Client) PublishCollection(ctx context.Context, collectionID string) error

func (*Client) SetCollectionID

func (c *Client) SetCollectionID(ctx context.Context, filepath, collectionID string) error

type FileMetaData

type FileMetaData struct {
	Path          string  `json:"path"`
	IsPublishable bool    `json:"is_publishable"`
	CollectionID  *string `json:"collection_id,omitempty"`
	Title         string  `json:"title"`
	SizeInBytes   uint64  `json:"size_in_bytes"`
	Type          string  `json:"type"`
	Licence       string  `json:"licence"`
	LicenceUrl    string  `json:"licence_url"`
	State         string  `json:"state"`
	Etag          string  `json:"etag"`
}