httpspeed

Documentation

Overview

Package httpspeed implements core.SpeedTester against Cloudflare's public speed-test endpoint. No API key or self-hosted server required.

Index

• type Tester
  • func New() Tester
  • func (t Tester) Colo(ctx context.Context) string
  • func (t Tester) Download(ctx context.Context, size int64) (time.Duration, error)
  • func (t Tester) Upload(ctx context.Context, size int64) (time.Duration, error)

Types

type Tester

type Tester struct {
	Client  *http.Client
	BaseURL string // overridable for tests; defaults to Cloudflare in New().
}

Tester times HTTP transfers against a speed-test server.

func New

func New() Tester

func (Tester) Colo

func (t Tester) Colo(ctx context.Context) string

Colo returns the three-letter code of the Cloudflare datacenter that answered (e.g. "GRU" for São Paulo), or "" if it can't be determined. speed.cloudflare.com is anycast: the same URL always routes to whichever of Cloudflare's ~300 edges is closest, so this exists to make that concrete instead of asserting it — hits Cloudflare's public trace endpoint, which every Cloudflare-proxied hostname serves.

func (Tester) Download

func (t Tester) Download(ctx context.Context, size int64) (time.Duration, error)

Download fetches size bytes and reports how long the transfer took.

func (Tester) Upload

func (t Tester) Upload(ctx context.Context, size int64) (time.Duration, error)

Upload sends size bytes and reports how long the transfer took.