meili

Documentation

Index

• type Options
• type SearchResponse
• type Service
  • func Connect(ctx context.Context, conf *cfg.SearchConfig, log *zerolog.Logger, ...) (*Service, error)
  • func (s *Service) CreateAllIndexes(ctx context.Context) error
  • func (s *Service) HandleSearch(c *fiber.Ctx) error
  • func (s *Service) RunQuery(opts *Options) (categorisedResult map[string][]meilisearch.SearchResponse, err error)

Types

type Options

type Options struct {
	// Query is the search query used for a text search.
	Query string `json:"query" query:"q" default:""`

	// Sort is the field, that should be sorted by.
	// When left empty, the default sorting is used.
	Sort string `json:"sort,omitempty" query:"sort,omitempty" validate:"oneof=score added modified name"`

	// SortDescending defines the sort order.
	SortDescending bool `json:"sortDescending" query:"desc" default:"true"`

	// Fuzzy defines whether to use fuzzy or wildcard search.
	Fuzzy bool `json:"fuzzy,omitempty" query:"fuzzy" default:"false"`

	// Page is current page.
	Page uint `json:"page" query:"page" default:"0"`

	// PageSize defines the number of hits returned per page.
	//
	// PageSize is infinite when set to 0 (i.e. infinite scroll).
	PageSize int64 `json:"pageSize" query:"pageSize" default:"10" validate:"gte=0,lte=180"`

	// Categories are the categories to search in. By default,
	// a Union category is performed to search in all categories.
	Categories []target.Category `json:"categories" query:"category" validate:"unique,dive" default:"union"`
}

Options defines a set of optional search parameters.

type SearchResponse

type SearchResponse struct {
	Categories     []string                 `json:"categories"`
	TotalHits      int64                    `json:"totalHits"`
	ProcessingTime int64                    `json:"processingTime"`
	Page           int64                    `json:"page"`
	TotalPages     int64                    `json:"totalPages"`
	HitsPerPage    int64                    `json:"hitsPerPage"`
	Data           []map[string]interface{} `json:"data"`
}

type Service

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

func Connect

func Connect(
	ctx context.Context,
	conf *cfg.SearchConfig,
	log *zerolog.Logger,
	v *validator.Validate,
	searchStorage *searchdb.Storage,
) (*Service, error)

func (*Service) CreateAllIndexes

func (s *Service) CreateAllIndexes(ctx context.Context) error

func (*Service) HandleSearch

func (s *Service) HandleSearch(c *fiber.Ctx) error

@Summary Perform a search for the given query and options @Description Search for media, users, posts, artists, etc. @Tags search,media,metadata,users,posts,reviews @Param X-CSRF-Token header string false "CSRF token. Required when using POST." @Param q query string false "The search query. Falls back to a wildcard query if not provided." @Param category query string false "The category to search in" Enums(union,members,artists,media,ratings,genres) @Param fuzzy query boolean false "Whether to perform a fuzzy search" @Param sort query string false "The field to sort the results by" Enums(score,added,modified,name) @Param desc query boolean false "Whether to sort the results in descending order" @Param page query integer false "The page to return" @Param pageSize query integer false "The number of results to return per page" @Accept json @Router /search [post] @Router /search [get]

func (*Service) RunQuery

func (s *Service) RunQuery(opts *Options) (
	categorisedResult map[string][]meilisearch.SearchResponse, err error)