api.gen.go

// Package api provides primitives to interact with the openapi HTTP API.
//
// Code generated by github.com/discord-gophers/goapi-gen version v0.3.0 DO NOT EDIT.
package api

import (
	"bytes"
	"compress/gzip"
	"encoding/base64"
	"encoding/json"
	"encoding/xml"
	"fmt"
	"net/http"
	"net/url"
	"path"
	"strings"

	"github.com/discord-gophers/goapi-gen/runtime"
	"github.com/getkin/kin-openapi/openapi3"
	"github.com/go-chi/chi/v5"
	"github.com/go-chi/render"
)

// Ability defines model for Ability.
type Ability struct {
	Description *string `json:"description,omitempty"`
	Name        *string `json:"name,omitempty"`
}

// Allegiance defines model for Allegiance.
type Allegiance struct {
	ID            *string `bun:"id,pk" json:"_id,omitempty"`
	Description   *string `json:"description,omitempty"`
	GrandAlliance *string `json:"grand_alliance,omitempty"`
	MortalRealm   *string `json:"mortal_realm,omitempty"`
	Name          string  `json:"name"`
}

// Army defines model for Army.
type Army struct {
	ID    *string `bun:"id,pk" json:"_id,omitempty"`
	Name  string  `json:"name"`
	Units []Unit  `json:"units,omitempty"`
}

// City defines model for City.
type City struct {
	ID          *string `bun:"id,pk" json:"_id,omitempty"`
	Description *string `json:"description,omitempty"`
	Name        *string `json:"name,omitempty"`
}

// DamageTable defines model for DamageTable.
type DamageTable struct {
	ID                 *string `bun:"id,pk" json:"_id,omitempty"`
	MinWoundsSuffered  *int64  `json:"min_wounds_suffered,omitempty"`
	Move               *string `json:"move,omitempty"`
	WoundTrackPosition *int64  `json:"wound_track_position,omitempty"`
}

// Error defines model for Error.
type Error struct {
	Code    int32  `json:"code"`
	Message string `json:"message"`
}

// GrandAlliance defines model for GrandAlliance.
type GrandAlliance struct {
	ID          *string `bun:",pk" json:"_id,omitempty"`
	Description *string `json:"description,omitempty"`
	Name        string  `json:"name"`
}

// GrandStrategy defines model for GrandStrategy.
type GrandStrategy struct {
	ID          *string `bun:",pk" json:"_id,omitempty"`
	Description *string `json:"description,omitempty"`
	Name        string  `json:"name"`
}

// Health defines model for Health.
type Health struct {
	Status string `json:"status"`
}

// Unit defines model for Unit.
type Unit struct {
	ID               *string       `bun:"id,pk" json:"_id,omitempty"`
	Abilities        []Ability     `json:"abilities,omitempty"`
	Bravery          *int64        `json:"bravery,omitempty"`
	Champion         *string       `json:"champion,omitempty"`
	CommandAbilities []Ability     `json:"command_abilities,omitempty"`
	DamageTable      []DamageTable `json:"damage_table,omitempty"`
	Description      *string       `json:"description,omitempty"`
	GrandAlliance    *string       `json:"grand_alliance,omitempty"`
	Keywords         []string      `json:"keywords,omitempty"`
	Magic            []Ability     `json:"magic,omitempty"`
	MeleeWeapons     []Weapon      `json:"melee_weapons,omitempty"`
	MissileWeapons   []Weapon      `json:"missile_weapons,omitempty"`
	Models           *int64        `json:"models,omitempty"`
	Move             *string       `json:"move,omitempty"`
	Name             string        `json:"name"`
	Points           *int64        `json:"points,omitempty"`
	Save             *int64        `json:"save,omitempty"`
	Size             *string       `json:"size,omitempty"`
	Wounds           *int64        `json:"wounds,omitempty"`
}

// Warscroll defines model for Warscroll.
type Warscroll struct {
	ID              *string        `bun:",pk" json:"_id,omitempty"`
	Allegiance      *Allegiance    `json:"allegiance,omitempty"`
	AllegianceID    *string        `json:"allegiance_id,omitempty"`
	BattlefieldRole *string        `json:"battlefield_role,omitempty"`
	GrandAlliance   *GrandAlliance `json:"grand_alliance,omitempty"`
	GrandAllianceID *string        `json:"grand_alliance_id,omitempty"`
	Name            *string        `json:"name,omitempty"`
	Notes           *string        `json:"notes,omitempty"`
	Points          *int64         `json:"points,omitempty"`
	Size            *int64         `json:"size,omitempty"`
}

// Weapon defines model for Weapon.
type Weapon struct {
	ID      *string `bun:",pk" json:"_id,omitempty"`
	Attacks *string `json:"attacks,omitempty"`
	Damage  *string `json:"damage,omitempty"`
	Name    *string `json:"name,omitempty"`
	Range   *string `json:"range,omitempty"`
	Rend    *string `json:"rend,omitempty"`
	ToHit   *string `json:"to_hit,omitempty"`
	ToWound *string `json:"to_wound,omitempty"`
}

// WeaponsGroup defines model for WeaponsGroup.
type WeaponsGroup struct {
	MeleeWeapons   []Weapon `json:"melee_weapons,omitempty"`
	MissileWeapons []Weapon `json:"missile_weapons,omitempty"`
}

// GetAllegiancesParams defines parameters for GetAllegiances.
type GetAllegiancesParams struct {
	// number of allegiances to return
	Limit *int `json:"limit,omitempty"`

	// number of allegiances to skip
	Offset *int `json:"offset,omitempty"`

	// name of allegiance to filter by
	Name *string `json:"name,omitempty"`

	// id of grand alliance to filter by
	GrandAlliance *string `json:"grand_alliance,omitempty"`
}

// GetCitiesParams defines parameters for GetCities.
type GetCitiesParams struct {
	// number of cities to return
	Limit *int `json:"limit,omitempty"`

	// number of cities to skip
	Offset *int `json:"offset,omitempty"`

	// name of city to filter by
	Name *string `json:"name,omitempty"`
}

// GetUnitsParams defines parameters for GetUnits.
type GetUnitsParams struct {
	// number of units to return
	Limit *int `json:"limit,omitempty"`

	// number of units to skip
	Offset *int `json:"offset,omitempty"`

	// name of unit to filter by
	Name *string `json:"name,omitempty"`

	// grand alliance of unit to filter by
	GrandAlliance *string `json:"grand_alliance,omitempty"`

	// grand strategy of unit to filter by
	GrandStrategy *string `json:"grand_strategy,omitempty"`

	// points of unit to filter by
	Points *int `json:"points,omitempty"`
}

// GetWarscrollsParams defines parameters for GetWarscrolls.
type GetWarscrollsParams struct {
	// number of warscrolls to return
	Limit *int `json:"limit,omitempty"`

	// number of warscrolls to skip
	Offset *int `json:"offset,omitempty"`

	// name of warscroll to filter by
	Name *string `json:"name,omitempty"`

	// points of warscroll to filter by
	Points *int `json:"points,omitempty"`

	// battlefield_role of warscroll to filter by
	BattlefieldRole *string `json:"battlefield_role,omitempty"`

	// size of warscroll to filter by
	Size *string `json:"size,omitempty"`

	// notes of warscroll to filter by
	Notes *string `json:"notes,omitempty"`
}

// Response is a common response struct for all the API calls.
// A Response object may be instantiated via functions for specific operation responses.
// It may also be instantiated directly, for the purpose of responding with a single status code.
type Response struct {
	body        interface{}
	Code        int
	contentType string
}

// Render implements the render.Renderer interface. It sets the Content-Type header
// and status code based on the response definition.
func (resp *Response) Render(w http.ResponseWriter, r *http.Request) error {
	w.Header().Set("Content-Type", resp.contentType)
	render.Status(r, resp.Code)
	return nil
}

// Status is a builder method to override the default status code for a response.
func (resp *Response) Status(code int) *Response {
	resp.Code = code
	return resp
}

// ContentType is a builder method to override the default content type for a response.
func (resp *Response) ContentType(contentType string) *Response {
	resp.contentType = contentType
	return resp
}

// MarshalJSON implements the json.Marshaler interface.
// This is used to only marshal the body of the response.
func (resp *Response) MarshalJSON() ([]byte, error) {
	return json.Marshal(resp.body)
}

// MarshalXML implements the xml.Marshaler interface.
// This is used to only marshal the body of the response.
func (resp *Response) MarshalXML(e *xml.Encoder, start xml.StartElement) error {
	return e.Encode(resp.body)
}

// GetAllegiancesJSON200Response is a constructor method for a GetAllegiances response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAllegiancesJSON200Response(body []Allegiance) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetAllegiancesJSON404Response is a constructor method for a GetAllegiances response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAllegiancesJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetAllegianceByIDJSON200Response is a constructor method for a GetAllegianceByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAllegianceByIDJSON200Response(body Allegiance) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetAllegianceByIDJSON404Response is a constructor method for a GetAllegianceByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAllegianceByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetArmiesJSON200Response is a constructor method for a GetArmies response.
// A *Response is returned with the configured status code and content type from the spec.
func GetArmiesJSON200Response(body []Army) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetArmiesJSON404Response is a constructor method for a GetArmies response.
// A *Response is returned with the configured status code and content type from the spec.
func GetArmiesJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetArmyByIDJSON200Response is a constructor method for a GetArmyByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetArmyByIDJSON200Response(body Army) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetArmyByIDJSON404Response is a constructor method for a GetArmyByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetArmyByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetCitiesJSON200Response is a constructor method for a GetCities response.
// A *Response is returned with the configured status code and content type from the spec.
func GetCitiesJSON200Response(body []City) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetCitiesJSON404Response is a constructor method for a GetCities response.
// A *Response is returned with the configured status code and content type from the spec.
func GetCitiesJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetCityByIDJSON200Response is a constructor method for a GetCityByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetCityByIDJSON200Response(body City) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetCityByIDJSON404Response is a constructor method for a GetCityByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetCityByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetDocsJSON404Response is a constructor method for a GetDocs response.
// A *Response is returned with the configured status code and content type from the spec.
func GetDocsJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetGrandAlliancesJSON200Response is a constructor method for a GetGrandAlliances response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandAlliancesJSON200Response(body []GrandAlliance) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetGrandAlliancesJSON404Response is a constructor method for a GetGrandAlliances response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandAlliancesJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetGrandAllianceByIDJSON200Response is a constructor method for a GetGrandAllianceByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandAllianceByIDJSON200Response(body GrandAlliance) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetGrandAllianceByIDJSON404Response is a constructor method for a GetGrandAllianceByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandAllianceByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetGrandStrategiesJSON200Response is a constructor method for a GetGrandStrategies response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandStrategiesJSON200Response(body []GrandStrategy) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetGrandStrategiesJSON404Response is a constructor method for a GetGrandStrategies response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandStrategiesJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetGrandStrategyByIDJSON200Response is a constructor method for a GetGrandStrategyByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandStrategyByIDJSON200Response(body GrandStrategy) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetGrandStrategyByIDJSON404Response is a constructor method for a GetGrandStrategyByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetGrandStrategyByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetHealthzJSON200Response is a constructor method for a GetHealthz response.
// A *Response is returned with the configured status code and content type from the spec.
func GetHealthzJSON200Response(body Health) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetHealthzJSON404Response is a constructor method for a GetHealthz response.
// A *Response is returned with the configured status code and content type from the spec.
func GetHealthzJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetUnitsJSON200Response is a constructor method for a GetUnits response.
// A *Response is returned with the configured status code and content type from the spec.
func GetUnitsJSON200Response(body []Unit) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetUnitsJSON404Response is a constructor method for a GetUnits response.
// A *Response is returned with the configured status code and content type from the spec.
func GetUnitsJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetUnitByIDJSON200Response is a constructor method for a GetUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetUnitByIDJSON200Response(body Unit) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetUnitByIDJSON404Response is a constructor method for a GetUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetUnitByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetAbilitiesForUnitByIDJSON200Response is a constructor method for a GetAbilitiesForUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAbilitiesForUnitByIDJSON200Response(body []Ability) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetAbilitiesForUnitByIDJSON404Response is a constructor method for a GetAbilitiesForUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetAbilitiesForUnitByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetWeaponsForUnitByIDJSON200Response is a constructor method for a GetWeaponsForUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWeaponsForUnitByIDJSON200Response(body WeaponsGroup) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetWeaponsForUnitByIDJSON404Response is a constructor method for a GetWeaponsForUnitByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWeaponsForUnitByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetWarscrollsJSON200Response is a constructor method for a GetWarscrolls response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWarscrollsJSON200Response(body []Warscroll) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetWarscrollsJSON404Response is a constructor method for a GetWarscrolls response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWarscrollsJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// GetWarscrollByIDJSON200Response is a constructor method for a GetWarscrollByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWarscrollByIDJSON200Response(body Warscroll) *Response {
	return &Response{
		body:        body,
		Code:        200,
		contentType: "application/json",
	}
}

// GetWarscrollByIDJSON404Response is a constructor method for a GetWarscrollByID response.
// A *Response is returned with the configured status code and content type from the spec.
func GetWarscrollByIDJSON404Response(body Error) *Response {
	return &Response{
		body:        body,
		Code:        404,
		contentType: "application/json",
	}
}

// ServerInterface represents all server handlers.
type ServerInterface interface {
	// Get all allegiances
	// (GET /allegiances)
	GetAllegiances(w http.ResponseWriter, r *http.Request, params GetAllegiancesParams) *Response
	// Get allegiance by id
	// (GET /allegiances/{id})
	GetAllegianceByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get all armies
	// (GET /armies)
	GetArmies(w http.ResponseWriter, r *http.Request) *Response
	// Get army by id
	// (GET /armies/{id})
	GetArmyByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get all cities
	// (GET /cities)
	GetCities(w http.ResponseWriter, r *http.Request, params GetCitiesParams) *Response
	// Get city by id
	// (GET /cities/{id})
	GetCityByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get API documentation
	// (GET /docs)
	GetDocs(w http.ResponseWriter, r *http.Request) *Response
	// Get all grand alliances
	// (GET /grand-alliances)
	GetGrandAlliances(w http.ResponseWriter, r *http.Request) *Response
	// Get grand alliance by id
	// (GET /grand-alliances/{id})
	GetGrandAllianceByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get all grand strategies
	// (GET /grand-strategies)
	GetGrandStrategies(w http.ResponseWriter, r *http.Request) *Response
	// Get grand strategy by id
	// (GET /grand-strategies/{id})
	GetGrandStrategyByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get health status
	// (GET /healthz)
	GetHealthz(w http.ResponseWriter, r *http.Request) *Response
	// Get all units
	// (GET /units)
	GetUnits(w http.ResponseWriter, r *http.Request, params GetUnitsParams) *Response
	// Get unit by id
	// (GET /units/{id})
	GetUnitByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get abilities for unit by id
	// (GET /units/{id}/abilities)
	GetAbilitiesForUnitByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get weapons for unit by id
	// (GET /units/{id}/weapons)
	GetWeaponsForUnitByID(w http.ResponseWriter, r *http.Request, id string) *Response
	// Get all warscrolls
	// (GET /warscrolls)
	GetWarscrolls(w http.ResponseWriter, r *http.Request, params GetWarscrollsParams) *Response
	// Get warscroll by id
	// (GET /warscrolls/{id})
	GetWarscrollByID(w http.ResponseWriter, r *http.Request, id string) *Response
}

// ServerInterfaceWrapper converts contexts to parameters.
type ServerInterfaceWrapper struct {
	Handler          ServerInterface
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

// GetAllegiances operation middleware
func (siw *ServerInterfaceWrapper) GetAllegiances(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// Parameter object where we will unmarshal all parameters from the context
	var params GetAllegiancesParams

	// ------------- Optional query parameter "limit" -------------

	if err := runtime.BindQueryParameter("form", true, false, "limit", r.URL.Query(), &params.Limit); err != nil {
		err = fmt.Errorf("invalid format for parameter limit: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "limit"})
		return
	}

	// ------------- Optional query parameter "offset" -------------

	if err := runtime.BindQueryParameter("form", true, false, "offset", r.URL.Query(), &params.Offset); err != nil {
		err = fmt.Errorf("invalid format for parameter offset: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "offset"})
		return
	}

	// ------------- Optional query parameter "name" -------------

	if err := runtime.BindQueryParameter("form", true, false, "name", r.URL.Query(), &params.Name); err != nil {
		err = fmt.Errorf("invalid format for parameter name: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "name"})
		return
	}

	// ------------- Optional query parameter "grand_alliance" -------------

	if err := runtime.BindQueryParameter("form", true, false, "grand_alliance", r.URL.Query(), &params.GrandAlliance); err != nil {
		err = fmt.Errorf("invalid format for parameter grand_alliance: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "grand_alliance"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetAllegiances(w, r, params)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetAllegianceByID operation middleware
func (siw *ServerInterfaceWrapper) GetAllegianceByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetAllegianceByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetArmies operation middleware
func (siw *ServerInterfaceWrapper) GetArmies(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetArmies(w, r)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetArmyByID operation middleware
func (siw *ServerInterfaceWrapper) GetArmyByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetArmyByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetCities operation middleware
func (siw *ServerInterfaceWrapper) GetCities(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// Parameter object where we will unmarshal all parameters from the context
	var params GetCitiesParams

	// ------------- Optional query parameter "limit" -------------

	if err := runtime.BindQueryParameter("form", true, false, "limit", r.URL.Query(), &params.Limit); err != nil {
		err = fmt.Errorf("invalid format for parameter limit: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "limit"})
		return
	}

	// ------------- Optional query parameter "offset" -------------

	if err := runtime.BindQueryParameter("form", true, false, "offset", r.URL.Query(), &params.Offset); err != nil {
		err = fmt.Errorf("invalid format for parameter offset: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "offset"})
		return
	}

	// ------------- Optional query parameter "name" -------------

	if err := runtime.BindQueryParameter("form", true, false, "name", r.URL.Query(), &params.Name); err != nil {
		err = fmt.Errorf("invalid format for parameter name: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "name"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetCities(w, r, params)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetCityByID operation middleware
func (siw *ServerInterfaceWrapper) GetCityByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetCityByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetDocs operation middleware
func (siw *ServerInterfaceWrapper) GetDocs(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetDocs(w, r)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetGrandAlliances operation middleware
func (siw *ServerInterfaceWrapper) GetGrandAlliances(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetGrandAlliances(w, r)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetGrandAllianceByID operation middleware
func (siw *ServerInterfaceWrapper) GetGrandAllianceByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetGrandAllianceByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetGrandStrategies operation middleware
func (siw *ServerInterfaceWrapper) GetGrandStrategies(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetGrandStrategies(w, r)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetGrandStrategyByID operation middleware
func (siw *ServerInterfaceWrapper) GetGrandStrategyByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetGrandStrategyByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetHealthz operation middleware
func (siw *ServerInterfaceWrapper) GetHealthz(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetHealthz(w, r)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetUnits operation middleware
func (siw *ServerInterfaceWrapper) GetUnits(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// Parameter object where we will unmarshal all parameters from the context
	var params GetUnitsParams

	// ------------- Optional query parameter "limit" -------------

	if err := runtime.BindQueryParameter("form", true, false, "limit", r.URL.Query(), &params.Limit); err != nil {
		err = fmt.Errorf("invalid format for parameter limit: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "limit"})
		return
	}

	// ------------- Optional query parameter "offset" -------------

	if err := runtime.BindQueryParameter("form", true, false, "offset", r.URL.Query(), &params.Offset); err != nil {
		err = fmt.Errorf("invalid format for parameter offset: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "offset"})
		return
	}

	// ------------- Optional query parameter "name" -------------

	if err := runtime.BindQueryParameter("form", true, false, "name", r.URL.Query(), &params.Name); err != nil {
		err = fmt.Errorf("invalid format for parameter name: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "name"})
		return
	}

	// ------------- Optional query parameter "grand_alliance" -------------

	if err := runtime.BindQueryParameter("form", true, false, "grand_alliance", r.URL.Query(), &params.GrandAlliance); err != nil {
		err = fmt.Errorf("invalid format for parameter grand_alliance: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "grand_alliance"})
		return
	}

	// ------------- Optional query parameter "grand_strategy" -------------

	if err := runtime.BindQueryParameter("form", true, false, "grand_strategy", r.URL.Query(), &params.GrandStrategy); err != nil {
		err = fmt.Errorf("invalid format for parameter grand_strategy: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "grand_strategy"})
		return
	}

	// ------------- Optional query parameter "points" -------------

	if err := runtime.BindQueryParameter("form", true, false, "points", r.URL.Query(), &params.Points); err != nil {
		err = fmt.Errorf("invalid format for parameter points: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "points"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetUnits(w, r, params)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetUnitByID operation middleware
func (siw *ServerInterfaceWrapper) GetUnitByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetUnitByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetAbilitiesForUnitByID operation middleware
func (siw *ServerInterfaceWrapper) GetAbilitiesForUnitByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetAbilitiesForUnitByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetWeaponsForUnitByID operation middleware
func (siw *ServerInterfaceWrapper) GetWeaponsForUnitByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetWeaponsForUnitByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetWarscrolls operation middleware
func (siw *ServerInterfaceWrapper) GetWarscrolls(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// Parameter object where we will unmarshal all parameters from the context
	var params GetWarscrollsParams

	// ------------- Optional query parameter "limit" -------------

	if err := runtime.BindQueryParameter("form", true, false, "limit", r.URL.Query(), &params.Limit); err != nil {
		err = fmt.Errorf("invalid format for parameter limit: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "limit"})
		return
	}

	// ------------- Optional query parameter "offset" -------------

	if err := runtime.BindQueryParameter("form", true, false, "offset", r.URL.Query(), &params.Offset); err != nil {
		err = fmt.Errorf("invalid format for parameter offset: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "offset"})
		return
	}

	// ------------- Optional query parameter "name" -------------

	if err := runtime.BindQueryParameter("form", true, false, "name", r.URL.Query(), &params.Name); err != nil {
		err = fmt.Errorf("invalid format for parameter name: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "name"})
		return
	}

	// ------------- Optional query parameter "points" -------------

	if err := runtime.BindQueryParameter("form", true, false, "points", r.URL.Query(), &params.Points); err != nil {
		err = fmt.Errorf("invalid format for parameter points: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "points"})
		return
	}

	// ------------- Optional query parameter "battlefield_role" -------------

	if err := runtime.BindQueryParameter("form", true, false, "battlefield_role", r.URL.Query(), &params.BattlefieldRole); err != nil {
		err = fmt.Errorf("invalid format for parameter battlefield_role: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "battlefield_role"})
		return
	}

	// ------------- Optional query parameter "size" -------------

	if err := runtime.BindQueryParameter("form", true, false, "size", r.URL.Query(), &params.Size); err != nil {
		err = fmt.Errorf("invalid format for parameter size: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "size"})
		return
	}

	// ------------- Optional query parameter "notes" -------------

	if err := runtime.BindQueryParameter("form", true, false, "notes", r.URL.Query(), &params.Notes); err != nil {
		err = fmt.Errorf("invalid format for parameter notes: %w", err)
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "notes"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetWarscrolls(w, r, params)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

// GetWarscrollByID operation middleware
func (siw *ServerInterfaceWrapper) GetWarscrollByID(w http.ResponseWriter, r *http.Request) {
	ctx := r.Context()

	// ------------- Path parameter "id" -------------
	var id string

	if err := runtime.BindStyledParameter("simple", false, "id", chi.URLParam(r, "id"), &id); err != nil {
		siw.ErrorHandlerFunc(w, r, &InvalidParamFormatError{err, "id"})
		return
	}

	var handler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		resp := siw.Handler.GetWarscrollByID(w, r, id)
		if resp != nil {
			if resp.body != nil {
				render.Render(w, r, resp)
			} else {
				w.WriteHeader(resp.Code)
			}
		}
	})

	handler(w, r.WithContext(ctx))
}

type UnescapedCookieParamError struct {
	err       error
	paramName string
}

// Error implements error.
func (err UnescapedCookieParamError) Error() string {
	return fmt.Sprintf("error unescaping cookie parameter %s: %v", err.paramName, err.err)
}

func (err UnescapedCookieParamError) Unwrap() error { return err.err }

type UnmarshalingParamError struct {
	err       error
	paramName string
}

// Error implements error.
func (err UnmarshalingParamError) Error() string {
	return fmt.Sprintf("error unmarshaling parameter %s as JSON: %v", err.paramName, err.err)
}

func (err UnmarshalingParamError) Unwrap() error { return err.err }

type RequiredParamError struct {
	err       error
	paramName string
}

// Error implements error.
func (err RequiredParamError) Error() string {
	if err.err == nil {
		return fmt.Sprintf("query parameter %s is required, but not found", err.paramName)
	} else {
		return fmt.Sprintf("query parameter %s is required, but errored: %s", err.paramName, err.err)
	}
}

func (err RequiredParamError) Unwrap() error { return err.err }

type RequiredHeaderError struct {
	paramName string
}

// Error implements error.
func (err RequiredHeaderError) Error() string {
	return fmt.Sprintf("header parameter %s is required, but not found", err.paramName)
}

type InvalidParamFormatError struct {
	err       error
	paramName string
}

// Error implements error.
func (err InvalidParamFormatError) Error() string {
	return fmt.Sprintf("invalid format for parameter %s: %v", err.paramName, err.err)
}

func (err InvalidParamFormatError) Unwrap() error { return err.err }

type TooManyValuesForParamError struct {
	NumValues int
	paramName string
}

// Error implements error.
func (err TooManyValuesForParamError) Error() string {
	return fmt.Sprintf("expected one value for %s, got %d", err.paramName, err.NumValues)
}

// ParameterName is an interface that is implemented by error types that are
// relevant to a specific parameter.
type ParameterError interface {
	error
	// ParamName is the name of the parameter that the error is referring to.
	ParamName() string
}

func (err UnescapedCookieParamError) ParamName() string  { return err.paramName }
func (err UnmarshalingParamError) ParamName() string     { return err.paramName }
func (err RequiredParamError) ParamName() string         { return err.paramName }
func (err RequiredHeaderError) ParamName() string        { return err.paramName }
func (err InvalidParamFormatError) ParamName() string    { return err.paramName }
func (err TooManyValuesForParamError) ParamName() string { return err.paramName }

type ServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type ServerOption func(*ServerOptions)

// Handler creates http.Handler with routing matching OpenAPI spec.
func Handler(si ServerInterface, opts ...ServerOption) http.Handler {
	options := &ServerOptions{
		BaseURL:    "/",
		BaseRouter: chi.NewRouter(),
		ErrorHandlerFunc: func(w http.ResponseWriter, r *http.Request, err error) {
			http.Error(w, err.Error(), http.StatusBadRequest)
		},
	}

	for _, f := range opts {
		f(options)
	}

	r := options.BaseRouter
	wrapper := ServerInterfaceWrapper{
		Handler:          si,
		ErrorHandlerFunc: options.ErrorHandlerFunc,
	}

	r.Route(options.BaseURL, func(r chi.Router) {
		r.Get("/allegiances", wrapper.GetAllegiances)
		r.Get("/allegiances/{id}", wrapper.GetAllegianceByID)
		r.Get("/armies", wrapper.GetArmies)
		r.Get("/armies/{id}", wrapper.GetArmyByID)
		r.Get("/cities", wrapper.GetCities)
		r.Get("/cities/{id}", wrapper.GetCityByID)
		r.Get("/docs", wrapper.GetDocs)
		r.Get("/grand-alliances", wrapper.GetGrandAlliances)
		r.Get("/grand-alliances/{id}", wrapper.GetGrandAllianceByID)
		r.Get("/grand-strategies", wrapper.GetGrandStrategies)
		r.Get("/grand-strategies/{id}", wrapper.GetGrandStrategyByID)
		r.Get("/healthz", wrapper.GetHealthz)
		r.Get("/units", wrapper.GetUnits)
		r.Get("/units/{id}", wrapper.GetUnitByID)
		r.Get("/units/{id}/abilities", wrapper.GetAbilitiesForUnitByID)
		r.Get("/units/{id}/weapons", wrapper.GetWeaponsForUnitByID)
		r.Get("/warscrolls", wrapper.GetWarscrolls)
		r.Get("/warscrolls/{id}", wrapper.GetWarscrollByID)
	})
	return r
}

func WithRouter(r chi.Router) ServerOption {
	return func(s *ServerOptions) {
		s.BaseRouter = r
	}
}

func WithServerBaseURL(url string) ServerOption {
	return func(s *ServerOptions) {
		s.BaseURL = url
	}
}

func WithErrorHandler(handler func(w http.ResponseWriter, r *http.Request, err error)) ServerOption {
	return func(s *ServerOptions) {
		s.ErrorHandlerFunc = handler
	}
}

// Base64 encoded, gzipped, json marshaled Swagger object
var swaggerSpec = []string{

	"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",
	"evj68G8AAAD///z9HZ4YNwAA",
}

// GetSwagger returns the content of the embedded swagger specification file
// or error if failed to decode
func decodeSpec() ([]byte, error) {
	zipped, err := base64.StdEncoding.DecodeString(strings.Join(swaggerSpec, ""))
	if err != nil {
		return nil, fmt.Errorf("error base64 decoding spec: %s", err)
	}
	zr, err := gzip.NewReader(bytes.NewReader(zipped))
	if err != nil {
		return nil, fmt.Errorf("error decompressing spec: %s", err)
	}
	var buf bytes.Buffer
	_, err = buf.ReadFrom(zr)
	if err != nil {
		return nil, fmt.Errorf("error decompressing spec: %s", err)
	}

	return buf.Bytes(), nil
}

var rawSpec = decodeSpecCached()

// a naive cached of a decoded swagger spec
func decodeSpecCached() func() ([]byte, error) {
	data, err := decodeSpec()
	return func() ([]byte, error) {
		return data, err
	}
}

// Constructs a synthetic filesystem for resolving external references when loading openapi specifications.
func PathToRawSpec(pathToFile string) map[string]func() ([]byte, error) {
	var res = make(map[string]func() ([]byte, error))
	if len(pathToFile) > 0 {
		res[pathToFile] = rawSpec
	}

	return res
}

// GetSwagger returns the Swagger specification corresponding to the generated code
// in this file. The external references of Swagger specification are resolved.
// The logic of resolving external references is tightly connected to "import-mapping" feature.
// Externally referenced files must be embedded in the corresponding golang packages.
// Urls can be supported but this task was out of the scope.
func GetSwagger() (swagger *openapi3.T, err error) {
	var resolvePath = PathToRawSpec("")

	loader := openapi3.NewLoader()
	loader.IsExternalRefsAllowed = true
	loader.ReadFromURIFunc = func(loader *openapi3.Loader, url *url.URL) ([]byte, error) {
		var pathToFile = url.String()
		pathToFile = path.Clean(pathToFile)
		getSpec, ok := resolvePath[pathToFile]
		if !ok {
			err1 := fmt.Errorf("path not found: %s", pathToFile)
			return nil, err1
		}
		return getSpec()
	}
	var specData []byte
	specData, err = rawSpec()
	if err != nil {
		return
	}
	swagger, err = loader.LoadFromData(specData)
	if err != nil {
		return
	}
	return
}