README
¶
UserAgent eXPLain library.
Go port of device-detector library. Designed to use in high-load.
Library doesn't provide 100% match with original PHP library due to different Regexp engine (Go regexp vs PHP PCRE). Difference is ~ 5%.
Usage
ctx := uaxpl.Acquire()
defer uaxpl.Release(ctx)
ctx.SetUserAgentStr("Mozilla/5.0 (Linux; U; Android 9; RMX1941 Build/PPR1.180610.011) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/53.0.2785.134 Mobile Safari/537.36 RealmeBrowser/35.5.0.8")
fmt.Println("client type:", ctx.GetClientType()) // browser
fmt.Println("browser:", ctx.GetBrowser()) // Realme Browser
fmt.Println("browser version:", ctx.GetBrowserVersionString()) // 35.5.0.8
fmt.Println("browser version full:", ctx.GetBrowserVersion()) // 35.5.0.8
fmt.Println("engine:", ctx.GetEngine()) // WebKit
fmt.Println("engine version:", ctx.GetEngineVersionString()) // 537.36
fmt.Println("engine version full:", ctx.GetEngineVersion()) // 537.36.0.0
fmt.Println("device type:", ctx.GetDeviceType()) // smartphone
fmt.Println("brand:", ctx.GetBrand()) // Realme
fmt.Println("model:", ctx.GetModel()) // C2
fmt.Println("OS:", ctx.GetOS()) // Android
fmt.Println("OS version:", ctx.GetOSVersionString()) // 9
fmt.Println("OS version full:", ctx.GetOSVersion()) // 9.0.0.0
CLI Installation
uaxpl has two cli commands: uaxpl and uaxplc. First on is a simple cli tool to parse UA in
terminals.
uaxplc uses to recompile internal repositories from device-detector's
YAML files.
To install the tool run
go install github.com/koykov/uaxpl/cmd/uaxplc
As result, you must have binary $GOPATH/bin/uaxplc.
Then recompile the repos
go get github.com/koykov/uaxpl
cd $GOPATH/src/github.com/koykov/uaxpl
go generate
Run tests to make sure repos were compiled successfully.
Documentation
¶
Index ¶
- Constants
- func Release(ctx *Ctx)
- type ClientType
- type Ctx
- func (c *Ctx) FilterClientType(mask ClientType) *Ctx
- func (c *Ctx) FilterDeviceType(mask DeviceType) *Ctx
- func (c *Ctx) GetBrand() string
- func (c *Ctx) GetBrowser() string
- func (c *Ctx) GetBrowserVersion() *Version
- func (c *Ctx) GetBrowserVersionString() string
- func (c *Ctx) GetClientType() ClientType
- func (c *Ctx) GetDeviceType() DeviceType
- func (c *Ctx) GetEngine() string
- func (c *Ctx) GetEngineVersion() *Version
- func (c *Ctx) GetEngineVersionString() string
- func (c *Ctx) GetModel() string
- func (c *Ctx) GetOS() string
- func (c *Ctx) GetOSVersion() *Version
- func (c *Ctx) GetOSVersionString() string
- func (c *Ctx) GetUserAgent() string
- func (c *Ctx) Reset()
- func (c *Ctx) SetRequestedWith(header string) *Ctx
- func (c *Ctx) SetUserAgent(src []byte) *Ctx
- func (c *Ctx) SetUserAgentStr(src string) *Ctx
- type DeviceType
- type Pool
- type Version
Constants ¶
View Source
const (
Unknown = "UNK"
)
Variables ¶
This section is empty.
Functions ¶
Types ¶
type ClientType ¶
type ClientType uint8
const ( ClientTypeBrowser ClientType = 1 << iota ClientTypeMobileApp ClientTypeLibrary ClientTypeFeedReader ClientTypeMediaPlayer ClientTypePIM ClientTypeAll = ClientTypeBrowser | ClientTypeMobileApp | ClientTypeLibrary | ClientTypeFeedReader | ClientTypeMediaPlayer | ClientTypePIM )
func (ClientType) String ¶
func (t ClientType) String() string
type Ctx ¶
func AcquireWithSrc ¶
func AcquireWithSrcStr ¶
func NewCtxWithSrc ¶
func NewCtxWithSrcStr ¶
func (*Ctx) FilterClientType ¶
func (c *Ctx) FilterClientType(mask ClientType) *Ctx
func (*Ctx) FilterDeviceType ¶
func (c *Ctx) FilterDeviceType(mask DeviceType) *Ctx
func (*Ctx) GetBrowser ¶
func (*Ctx) GetBrowserVersion ¶
func (*Ctx) GetBrowserVersionString ¶
func (*Ctx) GetClientType ¶
func (c *Ctx) GetClientType() ClientType
func (*Ctx) GetDeviceType ¶
func (c *Ctx) GetDeviceType() DeviceType
func (*Ctx) GetEngineVersion ¶
func (*Ctx) GetEngineVersionString ¶
func (*Ctx) GetOSVersion ¶
func (*Ctx) GetOSVersionString ¶
func (*Ctx) GetUserAgent ¶
func (*Ctx) SetRequestedWith ¶
func (*Ctx) SetUserAgent ¶
func (*Ctx) SetUserAgentStr ¶
type DeviceType ¶
type DeviceType uint16
const ( DeviceTypeNotebook DeviceType = 1 << iota DeviceTypeMobile DeviceTypePhablet DeviceTypeTablet DeviceTypeConsole DeviceTypeTV DeviceTypeShellTV DeviceTypeCamera DeviceTypeCarBrowser DeviceTypePortableMediaPlayer DeviceTypeAll = DeviceTypeTV | DeviceTypeShellTV | DeviceTypeNotebook | DeviceTypeConsole | DeviceTypeCarBrowser | DeviceTypeCamera | DeviceTypePortableMediaPlayer | DeviceTypeMobile | DeviceTypePhablet | DeviceTypeTablet )
func (DeviceType) String ¶
func (t DeviceType) String() string
type Pool ¶
type Pool struct {
// contains filtered or unexported fields
}
var ( // P is a default instance of the pool. // Just call uaxpl.Acquire() and uaxpl.Release(). P Pool )
Source Files
¶
Directories
Click to show internal directories.
Click to hide internal directories.