device-detector-go

README

device-detector-go

Pure-Go User-Agent and Client Hints parser. The initial rule set detects common browsers, operating systems, Android/iOS devices and major crawlers.

d := detector.New()
result := d.Parse(r.UserAgent(), detector.ClientHintsFromHeader(r.Header))

For net/http, wrap your handler with d.Middleware(handler) and read the parsed result using detector.FromContext(r.Context()).

Matomo-compatible rule corpus

The checked-in rules/matomo directory is a snapshot of the upstream rule corpus; its exact source revision is recorded in rules/matomo/UPSTREAM. It is embedded in the published Go module, so applications load it once at startup without shipping a runtime rule directory:

d := detector.New()
report, err := d.LoadEmbeddedMatomoRules()
if err != nil { panic(err) }
// report.PCREFallback lists patterns routed to the compatibility engine.

LoadMatomoRules(path) remains available when an application needs to load a newer external rule snapshot without rebuilding its binary.

This parser preserves the upstream matching order for bots, browsers, operating systems and device vendors/models. Standard rules use Go's fast RE2 engine; rules with PCRE lookarounds use a timeout-protected compatibility engine.

Inspect the exact skipped rules with:

go run ./cmd/rule-report > docs/pcre-fallback-rules.md

License

Licensed under LGPL-3.0-or-later. This includes the bundled Matomo rule corpus; see NOTICE and rules/matomo/UPSTREAM for its source revision.