ws/internal/uri/parser/public.go

package parser

import (
	"fmt"
	"strings"
)

// Build builds an URI scheme from a pattern string
func Build(s string) (*Scheme, error) {

	/* (1) Manage '/' at the start */
	if len(s) < 1 || s[0] != '/' {
		return nil, fmt.Errorf("URI must begin with '/'")
	}

	/* (2) Split by '/' */
	parts := strings.Split(s, "/")

	/* (3) Max exceeded */
	if len(parts)-2 > maxMatch {
		for i, p := range parts {
			fmt.Printf("%d: '%s'\n", i, p)
		}
		return nil, fmt.Errorf("URI must not exceed %d slash-separated components, got %d", maxMatch, len(parts))
	}

	/* (4) Build for each part */
	sch, err := buildScheme(parts)
	if err != nil {
		return nil, err
	}

	/* (5) Optimise structure */
	opti, err := sch.optimise()
	if err != nil {
		return nil, err
	}

	return &opti, nil

}

// Match returns if the given URI is matched by the scheme
func (s Scheme) Match(str string) bool {

	/* (1) Nothing -> match all */
	if len(s) == 0 {
		return true
	}

	/* (2) Check for string match */
	clearURI, match := s.matchString(str)
	if !match {
		return false
	}

	/* (3) Check for non-string match (wildcards) */
	match = s.matchWildcards(clearURI)
	if !match {
		return false
	}

	return true
}

// GetMatch returns the indexed match (excluding string matchers)
func (s Scheme) GetMatch(n uint8) ([]string, error) {

	/* (1) Index out of range */
	if n > uint8(len(s)) {
		return nil, fmt.Errorf("Index out of range")
	}

	/* (2) Iterate to find index (exclude strings) */
	ni := -1
	for _, m := range s {

		// ignore strings
		if len(m.pat) > 0 {
			continue
		}

		// increment match counter : ni
		ni++

		// if expected index -> return matches
		if uint8(ni) == n {
			return m.buf, nil
		}

	}

	/* (3) If nothing found -> return empty set */
	return nil, fmt.Errorf("Index out of range (max: %d)", ni)

}

// GetAllMatch returns all the indexed match (excluding string matchers)
func (s Scheme) GetAllMatch() [][]string {

	match := make([][]string, 0, len(s))

	for _, m := range s {

		// ignore strings
		if len(m.pat) > 0 {
			continue
		}

		match = append(match, m.buf)

	}

	return match

}