go

Go standard library extensions

This repository provides extensional APIs for the Go standard library.

Usage

Add this package to your projects with following command.

go get github.com/aileron-projects/go@latest
go mod tidy

Key Features

• Logging zlog.
• Debugging zruntime/zdebug.
• Environmental Variables zos.
• HTTP Middleware Chains znet/zhttp.
• HTTP Reverse Proxy znet/zhttp.
• TCP Proxy znet/ztcp.
• UDP Proxy znet/zudp.
• Crontab, Cron Job ztime/zcron.
• Rate Limiting ztime/zrate.
• Load Balancer zx/zlb.

Package Dependency Policy

Package structure, or directory structure, basically follows the Go standard library.

All packages in this repository are allowed to use

• standard packages
• golang.org/x
• Third party packages
  • github.com/kr/pretty
  • github.com/davecgh/go-spew/spew

A package can contain package of higher-level APIs in its subdirectories. Higher level APIs can use lower level APIs. That means a package can use parent packages and cannot use child packages.

For example, in the following package structure,

• package lowapi cannot use neither middleapi nor highapi
• package middleapi can use lowapi and cannot use highapi
• package highapi can use both lowapi and middleapi

lowapi/  <────────┐  <──┐
│                 |     |
└── middleapi/  ──┘  <──┤
    │                   |
    └── highapi/  ──────┘

Rules for internal packages follow the Go specification.

Tested Environment

Operating System:

• Linux: ubuntu-latest
• Windows: windows-latest
• macOS: macos-latest

Go:

• See the go.mod file.
  • Main branch supports only latest go release.

In addition to the environment above, following platforms are tested on ubuntu using QEMU User space emulator.

• x86: amd64, 386
• arm: arm/v5, arm/v6, arm/v7, arm64
• risc: riscv64, loong64
• ppc: ppc64, ppc64le
• mips: mips, mips64, mips64le, mipsle
• ibm: s390x

Release Cycle

• Releases are made as needed.
• Versions follow Semantic Versioning.
  • vX.Y.Z-alpha.N
  • vX.Y.Z-beta.N
  • vX.Y.Z