go

IPFreely.uk

IP address manipulation library written in Go. This library treats IP addresses as generic unsigned integers capable of arithmetic and bitwise operations and includes a few discrete set collection types. This library does not perform network I/O and imposes no transitive runtime dependencies beyond the standard library.

Example

package main

import(
    "fmt"

    "github.com/ipfreely-up/go/ip"
    "github.com/ipfreely-up/go/ipmask"
)

func main() {
	network4 := ip.V4().MustFromBytes(192, 0, 2, 128)
	printNetworkDetails(network4, 26)

	println()

	network6 := ip.MustParse(ip.V6(), "2001:DB80::")
	printNetworkDetails(network6, 65)
}

func printNetworkDetails[A ip.Int[A]](network A, maskBits int) {
	fam := network.Family()
	mask := ipmask.For(fam, maskBits)
	maskComplement := mask.Not()

	zero := fam.FromInt(0)
	if !ip.Eq(mask.And(maskComplement), zero) {
		panic("Mask does not cover network address")
	}

	println("First Address:", network.String())
	println("Last Address:", network.Or(maskComplement).String())
	println("Mask:", mask.String())
	fmt.Printf("CIDR Notation: %s/%d\n", network.String(), maskBits)
}

Output:

First Address: 192.0.2.128
Last Address: 192.0.2.191
Mask: 255.255.255.192
CIDR Notation: 192.0.2.128/26

First Address: 2001:db80::
Last Address: 2001:db80::7fff:ffff:ffff:ffff
Mask: ffff:ffff:ffff:ffff:8000::
CIDR Notation: 2001:db80::/65

Module

The module name is github.com/ipfreely-uk/go. Add a require statement to go.mod to utilise.

Packages

Versus Standard Library

Selective comparison with standard library types in netip.

Links

• IPFreely.uk Website
• Source Code
• Documentation

Continuous Integration