/whois

Whois client for Go.

Primary LanguageGoMIT LicenseMIT

Whois GoDoc Project Status

go get github.com/domainr/whois

Whois client for Go (golang), inspired by Ruby Whois.

Design

func whois.Whois(query string) *whois.Record  // Fetches and returns a fully-parsed whois.Record

request = whois.NewRequest(query)             // Returns a prepared whois.Request
response = request.Fetch()                    // Fetches the request, returns a whois.Response
record = response.Parse()                     // Parses the response, returns a whois.Record

whois.Request — represents a qualified whois request, including server, URL, and request body
whois.Response — intermediate record, raw response from a whois server for a given query
whois.Record — parsed whois response; structured data

Logic

query := "domai.nr"
request, err := whois.NewRequest(query)
response, err := request.Fetch()
record, err := response.Parse()
if record.Refer != "" {
  response = whois.FetchRefer(record)
}

TODO

  • Create whois.Client
  • Embed an http.Client in whois.Client to reuse state
  • Implementations for known HTTP-based whois servers
  • Parsers