netaddr

What

This is a package containing a new IP address type for Go.

golang/go#18804 ("net: reconsider representation of IP")
golang/go#18757 ("net: ParseIP should return an error, like other Parse functions")
golang/go#37921 ("net: Unable to reliably distinguish IPv4-mapped-IPv6 addresses from regular IPv4 addresses")
merges net.IPAddr and net.IP (which the Go net package is a little torn between for legacy reasons)
...
TODO: finish this list

This package is mature, optimized, and used heavily in production at Tailscale. However, API stability is not yet guaranteed.

In addition to regular Go tests, netaddr uses fuzzing. The corpus is stored separately, in a submodule, to minimize the impact on everyone else.

To use:

$ git submodule update --init
$ go get -u github.com/dvyukov/go-fuzz/go-fuzz github.com/dvyukov/go-fuzz/go-fuzz-build
$ go-fuzz-build && go-fuzz

Name		Name	Last commit message	Last commit date
Latest commit History 172 Commits
.github/workflows		.github/workflows
corpus @ a387dc3		corpus @ a387dc3
.gitignore		.gitignore
.gitmodules		.gitmodules
AUTHORS		AUTHORS
LICENSE		LICENSE
README.md		README.md
example_test.go		example_test.go
fuzz.go		fuzz.go
go.mod		go.mod
go.sum		go.sum
inlining_test.go		inlining_test.go
ipset.go		ipset.go
ipset_test.go		ipset_test.go
mask6.go		mask6.go
netaddr.go		netaddr.go
netaddr_test.go		netaddr_test.go
slow_test.go		slow_test.go
uint128.go		uint128.go
uint128_test.go		uint128_test.go