utils

package

v0.0.0-...-8291241 Latest Latest Go to latest Published: Apr 28, 2023 License: MIT Imports: 49 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/toastate/toastainer

Links

Open Source Insights

Documentation ¶

Rendered for

Index ¶

Variables
func BigEndianUint64(n uint64) []byte
func BreakBaseURL(rawurl string) (scheme, ipaddr, port string, err error)
func ByteSlice2String(bs []byte) string
func CheckPasswordHash(password, hash string) bool
func CombineMonthYear(month, year int) int
func ContainsDotDot(v string) bool
func Copy(src string, dst string) error
func Debug(keyvals ...interface{})
func DecrIP(ip net.IP, inc uint) net.IP
func DirEmpty(dirname string) (b bool)
func DirExists(dirname string) bool
func DiskUsage(path string) (all, free, used uint64, err error)
func DumpCookie(cks [][]*http.Cookie) []string
func EqualDomain(d1, d2 string) bool
func Error(keyvals ...interface{})
func ExtractRootDomain(domain string) (string, error)
func Fatal(keyvals ...interface{})
func FileExists(filename string) bool
func ForceIPHTTPClient(ip, port string) *http.Client
func ForceIPWebsocketDialer(ip, port string) *websocket.Dialer
func FormatHelloServerName(servername string) (string, error)
func GetLocalPrivateIP() (net.IP, error)
func GetLocalPublicIP() (net.IP, error)
func GetMonthYear(n time.Time) int
func GuessImageFormat(r io.Reader) (format string, err error)
func HashPassword(password string) (string, error)
func IPUint(ip net.IP) uint32
func IPUintSl(ip []byte) uint32
func IncrIP(ip net.IP, inc uint) net.IP
func Info(keyvals ...interface{})
func InitLogging(level string)
func IsAlphaNumHyphen(s string) bool
func IsIPPrivateRFC1918(ipuint uint32) bool
func IsMultipart(r *http.Request) bool
func IsPowerOf2(x int) bool
func IsSlashRune(r rune) bool
func IsValidEmail(email string) error
func IsValidPassword(pass string) error
func IsWebSocketRequest(req *http.Request) bool
func JSONMarshal(t interface{}) ([]byte, error)
func Max[T constraints.Ordered](x, y T) T
func MimetypeFromFileExtension(path string) (mt string)
func Min[T constraints.Ordered](x, y T) T
func NextHighestPowerOf2(x uint32) uint32
func PathExists(path string) (bool, os.FileInfo)
func ReadCookies(h http.Header) [][]*http.Cookie
func ReadSetCookies(h http.Header) [][]*http.Cookie
func Redirect2HTTPS(w http.ResponseWriter, req *http.Request)
func SecureToken32() (string, error)
func SendError(w http.ResponseWriter, message, code string, statusCode int)
func SendErrorAndLog(w http.ResponseWriter, message, code string, statusCode int, origin string, ...)
func SendInternalError(w http.ResponseWriter, origin string, err error)
func SendSuccess(w http.ResponseWriter, resp interface{})
func SetKeepaliveParameters(conn *net.TCPConn) error
func SplitHostPort(hostport string) (string, string)
func SplitSlash(url string) []string
func String2ByteSlice(str string) []byte
func StripPort(hostport string) string
func UintIP(v uint32) net.IP
func UniqueSecureID120() (string, error)
func UniqueSecureID36() (string, error)
func UniqueSecureID60() (string, error)
func UploadEmbedFolderMultipart(client *http.Client, url, method string, relfilepaths []string, ...) (*http.Response, error)
func UploadFileMultipart(client *http.Client, url string, path string) (*http.Response, error)
func UploadFolderMultipart(client *http.Client, url, method string, folder string, fields ...string) (*http.Response, error)
func Varint(n int64) []byte
func VerifyTXT(domain, token string) (bool, error)
func Warn(keyvals ...interface{})
type CertificateAuthority
- func NewCertificateAuthority(organization pkix.Name) (*CertificateAuthority, error)
- func UnmarshalCertificateAuthority(b []byte) (*CertificateAuthority, error)
- func (ca *CertificateAuthority) CertificateBytes() []byte
- func (ca *CertificateAuthority) CreateDNSRSACertificate(dnsNames []string) (tls.Certificate, error)
- func (ca *CertificateAuthority) Marshal() ([]byte, error)
type JSONErr
- func UnmarshalJSONErr(b []byte) *JSONErr
type LimitedBuffer
- func NewLimitedBuffer(maxLen int) *LimitedBuffer
- func (b *LimitedBuffer) Bytes() []byte
- func (b *LimitedBuffer) CopyBytes() []byte
- func (b *LimitedBuffer) String() string
- func (b *LimitedBuffer) Write(in []byte) (int, error)
type ProxyReader
- func NewProxyReader(underlying io.Reader, progress chan int) *ProxyReader
- func (pr *ProxyReader) Read(b []byte) (int, error)
type TeeWriter
- func NewTeeWriter(wrs ...io.Writer) *TeeWriter
- func (t *TeeWriter) Write(b []byte) (int, error)

Constants ¶

This section is empty.

Variables ¶

View Source

var GoogleResolver = &net.Resolver{
	PreferGo: true,
	Dial: func(ctx context.Context, network, address string) (net.Conn, error) {
		d := net.Dialer{
			Timeout: time.Millisecond * time.Duration(10000),
		}
		return d.DialContext(ctx, network, "8.8.8.8:53")
	},
}

View Source

var LoopbackIPUint uint32

View Source

var PrivateCIDRUint = []uint32{167772160, 184549375, 2886729728, 2887778303, 3232235520, 3232301055} // 10.0.0.0/8 172.16.0.0/12 192.168.0.0/16

View Source

var R interface {
	LookupAddr(ctx context.Context, addr string) ([]string, error)
	LookupCNAME(ctx context.Context, host string) (string, error)
	LookupHost(ctx context.Context, host string) (addrs []string, err error)
	// LookupIP(ctx context.Context, network, host string) ([]net.IP, error)
	LookupIPAddr(ctx context.Context, host string) ([]net.IPAddr, error)
	LookupMX(ctx context.Context, name string) ([]*net.MX, error)
	LookupNS(ctx context.Context, name string) ([]*net.NS, error)
	LookupPort(ctx context.Context, network, service string) (port int, err error)
	LookupSRV(ctx context.Context, service, proto, name string) (string, []*net.SRV, error)
	LookupTXT(ctx context.Context, name string) ([]string, error)
} = GoogleResolver

Functions ¶

func BigEndianUint64 ¶

func BigEndianUint64(n uint64) []byte

func BreakBaseURL ¶

func BreakBaseURL(rawurl string) (scheme, ipaddr, port string, err error)

func ByteSlice2String ¶

func ByteSlice2String(bs []byte) string

Do not apply it after a String2ByteSlice was applied

func CheckPasswordHash ¶

func CheckPasswordHash(password, hash string) bool

func CombineMonthYear ¶

func CombineMonthYear(month, year int) int

func ContainsDotDot ¶

func ContainsDotDot(v string) bool

func Copy ¶

func Copy(src string, dst string) error

CopyFile copies both files and directories

func Debug ¶

func Debug(keyvals ...interface{})

func DecrIP ¶

func DecrIP(ip net.IP, inc uint) net.IP

func DirEmpty ¶

func DirEmpty(dirname string) (b bool)

DirEmpty returns true for non existant directories

func DirExists ¶

func DirExists(dirname string) bool

func DiskUsage ¶

func DiskUsage(path string) (all, free, used uint64, err error)

func DumpCookie ¶

func DumpCookie(cks [][]*http.Cookie) []string

func EqualDomain ¶

func EqualDomain(d1, d2 string) bool

func Error ¶

func Error(keyvals ...interface{})

func ExtractRootDomain ¶

func ExtractRootDomain(domain string) (string, error)

ExtractRootDomain extracts the EffectiveTLDPlusOne, see https://godoc.org/golang.org/x/net/publicsuffix#EffectiveTLDPlusOne for more explanations

func Fatal ¶

func Fatal(keyvals ...interface{})

func FileExists ¶

func FileExists(filename string) bool

func ForceIPHTTPClient ¶

func ForceIPHTTPClient(ip, port string) *http.Client

func ForceIPWebsocketDialer ¶

func ForceIPWebsocketDialer(ip, port string) *websocket.Dialer

func FormatHelloServerName ¶

func FormatHelloServerName(servername string) (string, error)

func GetLocalPrivateIP ¶

func GetLocalPrivateIP() (net.IP, error)

func GetLocalPublicIP ¶

func GetLocalPublicIP() (net.IP, error)

func GetMonthYear ¶

func GetMonthYear(n time.Time) int

func GuessImageFormat ¶

func GuessImageFormat(r io.Reader) (format string, err error)

Guess image format from gif/jpeg/png/webp

func HashPassword ¶

func HashPassword(password string) (string, error)

func IPUint ¶

func IPUint(ip net.IP) uint32

func IPUintSl ¶

func IPUintSl(ip []byte) uint32

func IncrIP ¶

func IncrIP(ip net.IP, inc uint) net.IP

func Info ¶

func Info(keyvals ...interface{})

func InitLogging ¶

func InitLogging(level string)

func IsAlphaNumHyphen ¶

func IsAlphaNumHyphen(s string) bool

func IsIPPrivateRFC1918 ¶

func IsIPPrivateRFC1918(ipuint uint32) bool

IsIPPrivateRFC1918 -> See https://tools.ietf.org/html/rfc1918

func IsMultipart ¶

func IsMultipart(r *http.Request) bool

IsMultipart returns true if the given request is multipart forrm

func IsPowerOf2 ¶

func IsPowerOf2(x int) bool

func IsSlashRune ¶

func IsSlashRune(r rune) bool

func IsValidEmail ¶

func IsValidEmail(email string) error

func IsValidPassword ¶

func IsValidPassword(pass string) error

func IsWebSocketRequest ¶

func IsWebSocketRequest(req *http.Request) bool

func Max ¶

func Max[T constraints.Ordered](x, y T) T

func MimetypeFromFileExtension ¶

func MimetypeFromFileExtension(path string) (mt string)

func Min ¶

func Min[T constraints.Ordered](x, y T) T

func NextHighestPowerOf2 ¶

func NextHighestPowerOf2(x uint32) uint32

func PathExists ¶

func PathExists(path string) (bool, os.FileInfo)

func Redirect2HTTPS ¶

func Redirect2HTTPS(w http.ResponseWriter, req *http.Request)

func SecureToken32 ¶

func SecureToken32() (string, error)

func SendError ¶

func SendError(w http.ResponseWriter, message, code string, statusCode int)

func SendErrorAndLog ¶

func SendErrorAndLog(w http.ResponseWriter, message, code string, statusCode int, origin string, err error)

func SendInternalError ¶

func SendInternalError(w http.ResponseWriter, origin string, err error)

func SendSuccess ¶

func SendSuccess(w http.ResponseWriter, resp interface{})

func SetKeepaliveParameters ¶

func SetKeepaliveParameters(conn *net.TCPConn) error

Sets additional keepalive parameters. Uses new interfaces introduced in Go1.11, which let us get connection's file descriptor, without blocking, and therefore without uncontrolled spawning of threads (not goroutines, actual threads).

func SplitHostPort ¶

func SplitHostPort(hostport string) (string, string)

func SplitSlash ¶

func SplitSlash(url string) []string

func String2ByteSlice ¶

func String2ByteSlice(str string) []byte

Do not apply it after a ByteSlice2String was applied

func StripPort ¶

func StripPort(hostport string) string

StripPort also removes IPV6 addresses square brackets

func UintIP ¶

func UintIP(v uint32) net.IP

func UniqueSecureID120 ¶

func UniqueSecureID120() (string, error)

func UniqueSecureID36 ¶

func UniqueSecureID36() (string, error)

func UniqueSecureID60 ¶

func UniqueSecureID60() (string, error)

func UploadEmbedFolderMultipart ¶

func UploadEmbedFolderMultipart(client *http.Client, url, method string, relfilepaths []string, files []fs.File, fields ...string) (*http.Response, error)

func UploadFileMultipart ¶

func UploadFileMultipart(client *http.Client, url string, path string) (*http.Response, error)

func UploadFolderMultipart ¶

func UploadFolderMultipart(client *http.Client, url, method string, folder string, fields ...string) (*http.Response, error)

func Varint ¶

func Varint(n int64) []byte

func VerifyTXT ¶

func VerifyTXT(domain, token string) (bool, error)

func Warn ¶

func Warn(keyvals ...interface{})

Types ¶

type CertificateAuthority ¶

type CertificateAuthority struct {
	// contains filtered or unexported fields
}

func NewCertificateAuthority ¶

func NewCertificateAuthority(organization pkix.Name) (*CertificateAuthority, error)

func UnmarshalCertificateAuthority ¶

func UnmarshalCertificateAuthority(b []byte) (*CertificateAuthority, error)

func (*CertificateAuthority) CertificateBytes ¶

func (ca *CertificateAuthority) CertificateBytes() []byte

func (*CertificateAuthority) CreateDNSRSACertificate ¶

func (ca *CertificateAuthority) CreateDNSRSACertificate(dnsNames []string) (tls.Certificate, error)

func (*CertificateAuthority) Marshal ¶

func (ca *CertificateAuthority) Marshal() ([]byte, error)

type JSONErr ¶

type JSONErr struct {
	Success bool   `json:"success"`
	Message string `json:"message,omitempty"`
	Code    string `json:"code,omitempty"`
}

func UnmarshalJSONErr ¶

func UnmarshalJSONErr(b []byte) *JSONErr

type LimitedBuffer ¶

type LimitedBuffer struct {
	sync.Mutex
	// contains filtered or unexported fields
}

LimitedBuffer is like a bytes.Buffer but dumps everything that exceeds maxLen

func NewLimitedBuffer ¶

func NewLimitedBuffer(maxLen int) *LimitedBuffer

NewLimitedBuffer returns a new Limitedbuffer with a defined maxLen

func (*LimitedBuffer) Bytes ¶

func (b *LimitedBuffer) Bytes() []byte

func (*LimitedBuffer) CopyBytes ¶

func (b *LimitedBuffer) CopyBytes() []byte

func (*LimitedBuffer) String ¶

func (b *LimitedBuffer) String() string

func (*LimitedBuffer) Write ¶

func (b *LimitedBuffer) Write(in []byte) (int, error)

type ProxyReader ¶

type ProxyReader struct {
	// contains filtered or unexported fields
}

func NewProxyReader ¶

func NewProxyReader(underlying io.Reader, progress chan int) *ProxyReader

func (*ProxyReader) Read ¶

func (pr *ProxyReader) Read(b []byte) (int, error)

type TeeWriter ¶

type TeeWriter struct {
	// contains filtered or unexported fields
}

func NewTeeWriter ¶

func NewTeeWriter(wrs ...io.Writer) *TeeWriter

TeeWriter returns the first writer results

func (*TeeWriter) Write ¶

func (t *TeeWriter) Write(b []byte) (int, error)

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Documentation ¶

Index ¶

Constants ¶

Variables ¶

Functions ¶

func BigEndianUint64 ¶

func BreakBaseURL ¶

func ByteSlice2String ¶

func CheckPasswordHash ¶

func CombineMonthYear ¶

func ContainsDotDot ¶

func Copy ¶

func Debug ¶

func DecrIP ¶

func DirEmpty ¶

func DirExists ¶

func DiskUsage ¶

func DumpCookie ¶

func EqualDomain ¶

func Error ¶

func ExtractRootDomain ¶

func Fatal ¶

func FileExists ¶

func ForceIPHTTPClient ¶

func ForceIPWebsocketDialer ¶

func FormatHelloServerName ¶

func GetLocalPrivateIP ¶

func GetLocalPublicIP ¶

func GetMonthYear ¶

func GuessImageFormat ¶

func HashPassword ¶

func IPUint ¶

func IPUintSl ¶

func IncrIP ¶

func Info ¶

func InitLogging ¶

func IsAlphaNumHyphen ¶

func IsIPPrivateRFC1918 ¶

func IsMultipart ¶

func IsPowerOf2 ¶

func IsSlashRune ¶

func IsValidEmail ¶

func IsValidPassword ¶

func IsWebSocketRequest ¶

func JSONMarshal ¶

func Max ¶

func MimetypeFromFileExtension ¶

func Min ¶

func NextHighestPowerOf2 ¶

func PathExists ¶

func ReadCookies ¶

func ReadSetCookies ¶

func Redirect2HTTPS ¶

func SecureToken32 ¶

func SendError ¶

func SendErrorAndLog ¶

func SendInternalError ¶

func SendSuccess ¶

func SetKeepaliveParameters ¶

func SplitHostPort ¶

func SplitSlash ¶

func String2ByteSlice ¶

func StripPort ¶

func UintIP ¶

func UniqueSecureID120 ¶

func UniqueSecureID36 ¶

func UniqueSecureID60 ¶

func UploadEmbedFolderMultipart ¶

func UploadFileMultipart ¶

func UploadFolderMultipart ¶

func Varint ¶

func VerifyTXT ¶

func Warn ¶

Types ¶

type CertificateAuthority ¶

func NewCertificateAuthority ¶

func UnmarshalCertificateAuthority ¶

func (*CertificateAuthority) CertificateBytes ¶

func (*CertificateAuthority) CreateDNSRSACertificate ¶

func (*CertificateAuthority) Marshal ¶