codegen

type HandlerStubOptions struct {
	Package      string // e.g. "api" (default "api")
	SkipPrologue bool   // don't write package & imports
	// StubNaming is an optional handler func naming (if nil, the default naming is used)
	//
	// If StubNaming is provided but returns an empty string, the default naming is used
	StubNaming  StubNaming
	PublicFuncs bool   // pubic handler funcs
	Receiver    string // sets the receiver for handler funcs (e.g. "(api *MyApi)" - empty string for no receiver)
	PathParams  bool   // if true, writes vars for path params
	GoDoc       bool   // if true, writes a godoc comment for each handler
	// Format if set, formats output in canonical gofmt style (and checks syntax)
	//
	// Note: using this option means the output will be buffered before writing to the final writer
	Format  bool
	UseCRLF bool // true to use \r\n as the line terminator
}

type ItemType interface {
	chioas.Definition | *chioas.Definition |
		chioas.Path | *chioas.Path |
		chioas.Paths |
		chioas.Method | *chioas.Method |
		chioas.Schema | *chioas.Schema |
		chioas.Components | *chioas.Components
}

type Options struct {
	Package         string // e.g. "api" (default "api")
	VarName         string // e.g. "Spec" (default "definition" - or "Definition" when PublicVars is true)
	ImportAlias     string // e.g. "ch" (default none - i.e. "chioas")
	SkipPrologue    bool   // don't write package & imports
	OmitZeroValues  bool   // skip zero-valued fields
	HoistPaths      bool   // make top-level vars for root paths
	HoistComponents bool   // make top-level vars for named components (Schemas/Parameters/Responses/Requests/Examples)
	PublicVars      bool   // top-level vars are public (for paths & components)
	UseHttpConsts   bool   // if set, "GET" becomes http.MethodGet, 400 becomes http.StatusBadRequest etc.
	InlineHandlers  bool   // if set, generates stub inline handler funcs within the definition code
	// Format if set, formats output in canonical gofmt style (and checks syntax)
	//
	// Note: using this option means the output will be buffered before writing to the final writer
	Format  bool
	UseCRLF bool // true to use \r\n as the line terminator
}

type SchemaStructOptions struct {
	Package       string // e.g. "api" (default "api")
	SkipPrologue  bool   // don't write package & imports
	PublicStructs bool   // public schema structs
	NoRequests    bool   // suppresses schema structs for method requests
	NoResponses   bool   // suppresses schema structs for method responses
	OASTags       bool   // if true, writes `oas:"..."` tags for fields
	GoDoc         bool   // if true, writes a godoc comment for each schema struct (indicating its usage)
	// Components is the components to use for $ref resolution
	//
	// Usage:
	//   - if generating schema structs (GenerateSchemaStructs) with chioas.Components, this field is not used
	//   - if generating schema structs (GenerateSchemaStructs) with chioas.Definition, this field (if non-nil) overrides the Definition.Components
	//   - for other types passed to GenerateSchemaStructs, this chioas.Components is used to resolve schema $ref
	//
	Components *chioas.Components
	// KeepComponentProperties if true (and Components supplied), is used to make
	// struct fields for properties that have an object schema - reference another generated struct
	KeepComponentProperties bool
	// Format if set, formats output in canonical gofmt style (and checks syntax)
	//
	// Note: using this option means the output will be buffered before writing to the final writer
	Format  bool
	UseCRLF bool // true to use \r\n as the line terminator

}

type StructItemType interface {
	chioas.Definition | *chioas.Definition |
		chioas.Path | *chioas.Path |
		chioas.Method | *chioas.Method |
		chioas.Paths |
		chioas.Schema | *chioas.Schema |
		chioas.Components | *chioas.Components
}

type StubItemType interface {
	chioas.Definition | *chioas.Definition |
		chioas.Path | *chioas.Path |
		chioas.Method | *chioas.Method |
		chioas.Paths
}

type StubNaming interface {
	Name(path string, method string, def chioas.Method) string
}