route

package

v1.1.0 Latest Latest Go to latest Published: Sep 28, 2026 License: Apache-2.0 Imports: 5 Imported by: 0

Details

Package route owns immutable route metadata and pure method/path matching. HTTP request mechanics belong to gateway/http.

This section is empty.

This section is empty.

This section is empty.

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

func NewBundle(components []*spec.Component) (*Bundle, error)

func (b *Bundle) AllowedMethodsForPath(path string) []string

func (b *Bundle) ComponentByKey(key spec.Key) (*spec.Component, bool)

func (b *Bundle) ComponentByRoute(method, path string) (*spec.Component, bool)

func (b *Bundle) ComponentByRouteWithParams(method, path string) (*spec.Component, map[string]string, bool)

func (b *Bundle) RouteByMethodPath(method, path string) (*spec.Route, bool)

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

Exposure selects public package import paths independently of dependency loading. An empty include list exposes nothing. Exclusions take precedence.

func NewExposure(include, exclude []string) (*Exposure, error)

func (p *Exposure) Allows(packagePath string) bool

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

PathTemplate is an immutable compiled route path.

func CompilePathTemplate(path string) (*PathTemplate, error)

CompilePathTemplate compiles an authored absolute route path.

func (t *PathTemplate) EscapedTemplatePath() string

EscapedTemplatePath returns an RFC6570-compatible escaped path while preserving authored placeholders.

func (t *PathTemplate) MatchEscapedPath(escapedPath string) (map[string]string, bool, error)

MatchEscapedPath matches an escaped path and decodes every segment exactly once.

func (t *PathTemplate) Parameters() []string

Parameters returns placeholder names in authored order.

func (t *PathTemplate) Path() string

Path returns the authored path.