art

Documentation

Overview

Package art provides functionalities related to Art and Variant of the game, including serving them, manipulating them and keep them persisted.

This package exposes its main interfaces by fx via FxModule function. However, it is still easy to instantiate an art.Service by simply creating it.

Index

• Constants
• Variables
• func FxModule() fx.Option
• type Art
  • func NewArt(id string, category string) *Art
• type Content
  • func (s *Content) Check() (*image.Config, error)
  • func (s *Content) PathRel() string
  • func (s *Content) String() string
• type ContentParams
• type Service
  • func (s *Service) Authenticate(uuid uuid.UUID) *infra.User
  • func (s *Service) SelectArt(id string) (*Art, error)
  • func (s *Service) SelectArts(category *string) ([]*Art, error)
  • func (s *Service) SelectArtsWhoseVariantAbsent(variation string) ([]*Art, error)
  • func (s *Service) SelectVariant(id string, kind string) (*Variant, error)
  • func (s *Service) SelectVariants(id string) ([]*Variant, error)
  • func (s *Service) StoreContent(id string, variation string, content []byte) (err error)
  • func (s *Service) TakeContent(id string, variation string) (content []byte, err error)
  • func (s *Service) UpsertArts(arts ...*Art) error
  • func (s *Service) UpsertVariants(variants ...*Variant) error
• type Variant
  • func NewVariant(id string, variation string) *Variant
  • func (v *Variant) String() string

Constants

const (
	CategoryImage      string = "image"
	CategoryBackground string = "background"
	CategoryItem       string = "item"
	CategoryCharacter  string = "character"
)

const (
	VariationOrigin     string = "origin"
	VariationThumbnail  string = "thumbnail"
	VariationRealEsrgan string = "real-esrgan"
)

Variables

var (
	ErrNotFound = errors.New("the resource with the identifier(s) is not found")
)

Functions

func FxModule

func FxModule() fx.Option

FxModule teaches a fx.App how to instantiate an art.Service, and also optionally register its HTTP endpoints on api.V1 if provided.

Types

type Art

type Art struct {
	ID       string `gorm:"primaryKey;type:text COLLATE numeric" json:"id" validate:""`
	Category string `gorm:"" json:"category" validate:"oneof=image background item character"`

	Variants []Variant `gorm:"" json:"variants,omitempty" validate:""`
}

func NewArt

func NewArt(id string, category string) *Art

type Content

type Content struct {
	ID        string
	Category  string
	Variation string
	Content   []byte
}

Content helps store and take the content of a variant to or from the filesystem.

func (*Content) Check

func (s *Content) Check() (*image.Config, error)

func (*Content) PathRel

func (s *Content) PathRel() string

func (*Content) String

func (s *Content) String() string

type ContentParams

type ContentParams struct {
	ID        string `param:"id"`
	Variation string `param:"variation"`
}

type Service

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

func (*Service) Authenticate

func (s *Service) Authenticate(uuid uuid.UUID) *infra.User

func (*Service) SelectArt

func (s *Service) SelectArt(id string) (*Art, error)

func (*Service) SelectArts

func (s *Service) SelectArts(category *string) ([]*Art, error)

func (*Service) SelectArtsWhoseVariantAbsent

func (s *Service) SelectArtsWhoseVariantAbsent(variation string) ([]*Art, error)

func (*Service) SelectVariant

func (s *Service) SelectVariant(id string, kind string) (*Variant, error)

func (*Service) SelectVariants

func (s *Service) SelectVariants(id string) ([]*Variant, error)

func (*Service) StoreContent

func (s *Service) StoreContent(id string, variation string, content []byte) (err error)

func (*Service) TakeContent

func (s *Service) TakeContent(id string, variation string) (content []byte, err error)

func (*Service) UpsertArts

func (s *Service) UpsertArts(arts ...*Art) error

func (*Service) UpsertVariants

func (s *Service) UpsertVariants(variants ...*Variant) error

type Variant

type Variant struct {
	ArtID     string `gorm:"primaryKey;type:text COLLATE numeric" json:"artID"`
	Variation string `gorm:"primaryKey" json:"variation,omitempty"`

	ContentPresent bool `gorm:"" json:"contentPresent"`
	ContentWidth   *int `gorm:"" json:"contentWidth,omitempty"`
	ContentHeight  *int `gorm:"" json:"contentHeight,omitempty"`
}

func NewVariant

func NewVariant(id string, variation string) *Variant

func (*Variant) String

func (v *Variant) String() string