framework

type Colon struct {
	Literal         func(s string) (string, error)
	Name            func(name string) string
	Wildcard        string
	IsWildcardNamed bool
	IsPrefixAllowed bool
}

type Conflict struct {
	Route  Route
	Reason string
}

type Framework interface {
	Name() string
	Imports() []gomodel.Import
	// RoutePattern writes an operation's method and OpenAPI path as the router takes them, or
	// fails for a method or a path the router rejects.
	RoutePattern(method, path string) (string, error)
	// Conflicts drops every route the router cannot hold next to an earlier one, with the reason.
	Conflicts(routes []Route) ([]Route, []Conflict)
	// Handler is the shape of the adapter's handlers, with the framework's types written as the
	// file of s spells them.
	Handler(s *gocode.Scope) Handler
	// PathParam writes the expression that reads a path parameter in a handler, where r is the
	// request and c the framework's context, when the handler has one.
	PathParam(s *gocode.Scope, name string) string
	// Templates holds templates/router.tmpl, the template of the router part.
	Templates() fs.FS
}

type Handler struct {
	Signature             string
	Writer                string
	Request               string
	Epilogue              string
	ServeSignature        string
	Context               string
	ContextServeSignature string
}

type Route struct {
	Operation string
	Method    string
	Path      string
	Pattern   string
	Names     []string
}