types.go

package swampi

import "fmt"

// APICall represents a type string indicating various APIs and their paths
type APICall string

// String implements the stringer interface
// but also returns the http path for this api
func (a APICall) String() string {
	return string(a)
}

// Method returns the http method associated with the call
func (a APICall) Method() string {
	switch a {
	// this case also matches TarStreamUpload
	case SingleFileUpload:
		return "POST"
	default:
		return ""
	}
}

// ContentType returns the content type associated with this request
func (a APICall) ContentType(isTar bool) string {
	switch a {
	case SingleFileUpload:
		// can't have multiple cases of the same string content
		// so we need to short circuit specific uploads with manual checks
		if isTar {
			return "application/x-tar"
		}
		return "text/plain"
	default:
		return ""
	}
}

// ParseArgs is used to format request arguments
func (a APICall) ParseArgs(args ...interface{}) string {
	switch a {
	case SingleFileUpload:
		return a.String()
	case SingleFileDownload, ListFiles:
		return fmt.Sprintf(a.String(), args...)
	default:
		return ""
	}
}

// Response returns the object associated with the api calls response
func (a APICall) Response() interface{} {
	switch a {
	case ListFiles:
		return &BZZList{}
	default:
		return nil
	}
}

const (
	// SingleFileUpload is an api to upload a singular file
	SingleFileUpload = APICall("/bzz:/")
	// SingleFileDownload is used to download a singular file from swarm
	SingleFileDownload = APICall("/bzz:/%s/")
	// ListFiles is used to list files in a particular manifest
	ListFiles = APICall("/bzz-list:/%s/")
	// TarStreamUpload is used to upload tar files
	TarStreamUpload = APICall("/bzz:/")
)

var (
	// APICalls is just a helper slice containing all known API calls
	APICalls = []APICall{SingleFileUpload, SingleFileDownload, TarStreamUpload, ListFiles}
)