sthttp

Documentation

Index

• Variables
• func DownloadSpeed(url string) (speed float64, err error)
• func GetLatency(server Server, url string, numtests int) (result float64, err error)
• func GetLatencyURL(server Server) string
• func UploadSpeed(url string, mimetype string, data []byte) (speed float64, err error)
• type ByDistance
  • func (server ByDistance) Len() int
  • func (server ByDistance) Less(i, j int) bool
  • func (server ByDistance) Swap(i, j int)
• type ByLatency
  • func (server ByLatency) Len() int
  • func (server ByLatency) Less(i, j int) bool
  • func (server ByLatency) Swap(i, j int)
• type Config
  • func GetConfig(url string) (c Config, err error)
• type Server
  • func GetClosestServers(servers []Server, lat float64, lon float64) []Server
  • func GetFastestServer(servers []Server) Server
  • func GetServers(url string, blacklist string) (servers []Server, err error)

Variables

var HTTPConfigTimeout = time.Duration(viper.GetDuration("httpconfigtimeout") * time.Second)

HTTPConfigTimeout is how long we'll wait for a config download to timeout

var HTTPDownloadTimeout = time.Duration(viper.GetDuration("httpdownloadtimeout") * time.Minute)

HTTPDownloadTimeout is how long we'll wait for a download to timeout

var HTTPLatencyTimeout = time.Duration(viper.GetDuration("httplatencytimeout") * time.Second)

HTTPLatencyTimeout is how long we'll wait for a ping to timeout

Functions

func DownloadSpeed

func DownloadSpeed(url string) (speed float64, err error)

DownloadSpeed measures the mbps of downloading a URL

func GetLatency

func GetLatency(server Server, url string, numtests int) (result float64, err error)

GetLatency will test the latency (ping) the given server NUMLATENCYTESTS times and return either the lowest or average depending on what algorithm is set

func GetLatencyURL

func GetLatencyURL(server Server) string

GetLatencyURL will return the proper url for the latency test file when given a server name

func UploadSpeed

func UploadSpeed(url string, mimetype string, data []byte) (speed float64, err error)

UploadSpeed measures the mbps to http.Post to a URL

Types

type ByDistance

type ByDistance []Server

ByDistance allows us to sort servers by distance

func (ByDistance) Len

func (server ByDistance) Len() int

func (ByDistance) Less

func (server ByDistance) Less(i, j int) bool

func (ByDistance) Swap

func (server ByDistance) Swap(i, j int)

type ByLatency

type ByLatency []Server

ByLatency allows us to sort servers by latency

func (ByLatency) Len

func (server ByLatency) Len() int

func (ByLatency) Less

func (server ByLatency) Less(i, j int) bool

func (ByLatency) Swap

func (server ByLatency) Swap(i, j int)

type Config

type Config struct {
	IP  string
	Lat float64
	Lon float64
	Isp string
}

Config struct holds our config (users current ip, lat, lon and isp)

var CONFIG Config

CONFIG is our global config space

func GetConfig

func GetConfig(url string) (c Config, err error)

GetConfig downloads the master config from speedtest.net

type Server

type Server struct {
	URL      string
	Lat      float64
	Lon      float64
	Name     string
	Country  string
	CC       string
	Sponsor  string
	ID       string
	Distance float64
	Latency  float64
}

Server struct is a speedtest candidate server

func GetClosestServers

func GetClosestServers(servers []Server, lat float64, lon float64) []Server

GetClosestServers takes the full server list and sorts by distance

func GetFastestServer

func GetFastestServer(servers []Server) Server

GetFastestServer test all servers until we find numServers that respond, then find the fastest of them. Some servers show up in the master list but timeout or are "corrupt" therefore we bump their latency to something really high (1 minute) and they will drop out of this test

func GetServers

func GetServers(url string, blacklist string) (servers []Server, err error)

GetServers will get the full server list