media

Documentation

Index

• type Client
  • func Open(ctx context.Context, conf Config) (Client, error)
• type Config
  • func (c *Config) ValidAndRepair() error
• type ImageType

Types

type Client

type Client interface {
	// Put returns link {Domain}/{Bucket}/{Category}/{RandPrefix}/{Filename}
	Put(ctx context.Context, category, filename string, size int64, body io.Reader) (link string, err error)
	// PutFile is alias Put with opening local file
	PutFile(ctx context.Context, category, filepath string) (link string, err error)
	// PutData is alias Put
	PutData(ctx context.Context, category, filename string, data []byte) (link string, err error)
	// PutImage ...
	PutImage(
		ctx context.Context, category, filename string, img image.Image, typ ImageType) (link string, err error)
	// PutMultipartThumbnail ...
	PutMultipartThumbnail(
		ctx context.Context, category string,
		file *multipart.FileHeader, typ ImageType, maxPixelSize uint) (link string, err error)
}

Client of S3 storage

For opening use func Open

func Open

func Open(ctx context.Context, conf Config) (Client, error)

Open local or s3 storage

required fields:

for remote storage: AccessKey, SecretKey, Region, EndPoint, Domain, Bucket

for local storage: Local, LocalDir, LocalURL, Bucket (optional)

type Config

type Config struct {
	RandPrefixLen int `desc:"rand file prefix for safe"`

	Local    bool   `desc:"enable local storage for files"`
	LocalDir string `desc:"local storage directory"`
	LocalURL string `desc:"target url file prefix"`

	S3AccessKey config.AES `desc:"access key or login or user, for example: 32423_goservice"`
	S3SecretKey config.AES `desc:"secret key or password"`
	S3AuthToken config.AES `desc:"optional"`

	S3EndPoint string `desc:"provider api url, for example: s3.selcdn.ru"`
	S3Domain   string `desc:"storage domain, for example: https://56756.selcdn.ru"`
	S3Region   string `desc:"for example: ru-1a"`
	S3Bucket   string `desc:"service bucket root, for example: goservice"`
	S3Insecure bool
}

Config for local storage or s3 connection

func (*Config) ValidAndRepair

func (c *Config) ValidAndRepair() error

ValidAndRepair config

type ImageType

type ImageType int

const (
	ImageJPG ImageType = iota
	ImagePNG
)