networking

Documentation

Overview

Package networking provides utilities for network operations, such as finding available ports and checking network connectivity.

Index

• Constants
• func FindAvailable() int
• func FindOrUsePort(port int) (int, error)
• func GetProtectedHttpClient() *http.Client
• func IsAvailable(port int) bool
• func IsIPv6Available() bool
• type ValidatingTransport
  • func (t *ValidatingTransport) RoundTrip(req *http.Request) (*http.Response, error)

Constants

const (
	// MinPort is the minimum port number to use
	MinPort = 10000
	// MaxPort is the maximum port number to use
	MaxPort = 65535
	// MaxAttempts is the maximum number of attempts to find an available port
	MaxAttempts = 10
)

const HttpTimeout = 30 * time.Second

HttpTimeout is the timeout for outgoing HTTP requests

Functions

func FindAvailable

func FindAvailable() int

FindAvailable finds an available port

func FindOrUsePort

func FindOrUsePort(port int) (int, error)

FindOrUsePort checks if the provided port is available or finds an available port if none is provided. If port is 0, it will find an available port. If port is not 0, it will check if the port is available. Returns the selected port and an error if any.

func GetProtectedHttpClient

func GetProtectedHttpClient() *http.Client

GetProtectedHttpClient returns a new http client with a protected dialer and URL validation

func IsAvailable

func IsAvailable(port int) bool

IsAvailable checks if a port is available

func IsIPv6Available

func IsIPv6Available() bool

IsIPv6Available checks if IPv6 is available on the system by looking for IPv6 addresses on network interfaces

Types

type ValidatingTransport

type ValidatingTransport struct {
	Transport http.RoundTripper
}

ValidatingTransport is for validating URLs prior to request

func (*ValidatingTransport) RoundTrip

func (t *ValidatingTransport) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip validates the request URL prior to forwarding