match.go

package pathmatch

import (
	"github.com/tsdkv/pathmatch/internal/match"
	"github.com/tsdkv/pathmatch/pathmatchpb/v1"
)

type MatchOption func(*match.MatchOptions)

// WithCaseInsensitive sets the match options to be case-insensitive.
func WithCaseInsensitive() MatchOption {
	return func(opts *match.MatchOptions) {
		opts.CaseInsensitive = true
	}
}

// WithKeepFirstVariable sets the variable merging policy. If true, when a
// variable name is encountered more than once, the value from the first
// match is kept. If false (default), the last match overwrites previous values.
func WithKeepFirstVariable() MatchOption {
	return func(opts *match.MatchOptions) {
		opts.KeepFirstVariable = true
	}
}

// Matches path to a parsed template path
// path cant contain wildcards or variables, only literal segments
//
// /path/*/to matches /path/any/to
// /path/{var} matches /path/to and returns map[string]string{"var": "to"}
// /path/{var=**} matches /path/to/with/more and returns map[string]string{"var": "to/with/more"}
func Match(template *pathmatchpb.PathTemplate, path string, opts ...MatchOption) (matched bool, vars map[string]string, err error) {
	mopts := &match.MatchOptions{
		CaseInsensitive: false, // Default to case-sensitive matching
	}
	for _, opt := range opts {
		opt(mopts)
	}

	return match.StrictMatch(template, path, mopts)
}