turbinelabs/nonstdlib

This project is no longer maintained by Turbine Labs, which has shut down.

The nonstdlib project comprises extensions to the Go stdlib, either to increase feature set or testability, and other utility code. The nonstdlib project has no external dependencies beyond the go standard library; the tests depend on our test package and gomock.

Where possible, we mirror the stdlib package naming, though in practice, we commonly import packages with a tbn prefix for clarity, e.g.:

import (
  "os"

  tbnos "github.com/turbinelabs/nonstdlib/os"
)

Requirements

Go 1.10.3 or later (previous versions may work, but we don't build or test against them)

Install

go get -u github.com/turbinelabs/nonstdlib/...

Clone/Test

mkdir -p $GOPATH/src/turbinelabs
git clone https://github.com/turbinelabs/nonstdlib.git > $GOPATH/src/turbinelabs/nonstdlib
go test github.com/turbinelabs/nonstdlib/...

Packages

Each package is best described in its respective Godoc:

arrays: includes several sub-packages allowing type-safe execution of tasks commonly applied to slices
editor: provides simple wrappers for interacting with an environment configured text editor
executor: provides a mechanism for asyncronous execution of tasks, using callbacks to indicate success or failure
flag: provides convenience methods for dealing with golang flag.FlagSets
log: provides infrastructure for topic based logging to files
math: provides mathematical utilities
must: provides extraction of useful information out of (data, error) tuples
net: provides convenience methods for dealing with the net package of the stdlib
os: provides an OS interface mirroring a subset of commonly used functions and variables from the golang os package
proc: provides a mechanism for running processes under management
ptr: provides convenience and conversion methods for working with pointer types
stats: provides an interface for reporting simple statistics
strings: provides convenience methods for working with strings and string slices
text/tabwriter: provides a set of sane defaults for converting tab separated values into a pretty column formatted output.
time: provides utility functions for go time.Time instances

Versioning

Please see Versioning of Turbine Labs Open Source Projects.

Pull Requests

Patches accepted! Please see Contributing to Turbine Labs Open Source Projects.

Code of Conduct

All Turbine Labs open-sourced projects are released with a Contributor Code of Conduct. By participating in our projects you agree to abide by its terms, which will be carefully enforced.