README
¶
paraphernalia
useful go things
about
This is my flex-time project to build a higher-level internal standard library for Go development inside Pivotal. I think that we do not have enough of these projects so I'm putting my code where my mouth is.
The goal is to eventually reduce the boilerplate to create a new service until
you're only doing fun work. This is done by first building up a solid
collection of primitives which can then be composed together into a Service
abstraction which will handle things for you. If the opinions there don't work
for you then you can always drop down to the primitives below.
why the name?
So I can troll you like I trolled myself.
usage
Please do! There are no backwards compatibility guarantees until things are a littte further along. However, I'm not out to mess with you: things will stay as similar as possible.
image credit
"Collection" by Karthik Srinivas
Directories
¶
| Path | Synopsis |
|---|---|
|
operate
|
|
|
admin
Package admin simplifies the setup of various administrative endpoints such as healthchecks, debugging, and service information.
|
Package admin simplifies the setup of various administrative endpoints such as healthchecks, debugging, and service information. |
|
pidfile
Package pidfile provides an ifrit.Runner which will manage your PID file lifecycle.
|
Package pidfile provides an ifrit.Runner which will manage your PID file lifecycle. |
|
secure
|
|
|
tlsconfig
Package tlsconfig provides opintionated helpers for building tls.Configs.
|
Package tlsconfig provides opintionated helpers for building tls.Configs. |
|
serve
|
|
|
grpcacl
Package grpcacl provides a method of applying coarse service ACLs based on the identity of the connecting service.
|
Package grpcacl provides a method of applying coarse service ACLs based on the identity of the connecting service. |
|
grpcrunner
Package grpcrunner simplifies starting GRPC servers with ifrit.
|
Package grpcrunner simplifies starting GRPC servers with ifrit. |
|
requestid
Package requestid can be used to generate IDs that are suitable for use in request tracing and correlation.
|
Package requestid can be used to generate IDs that are suitable for use in request tracing and correlation. |
|
test
|
|
|
certtest
Package certtest can be used to build a PKI for test purposes.
|
Package certtest can be used to build a PKI for test purposes. |
|
grpctest
Package grpctest provides a tiny GRPC service implementation for use in testing other GRPC utilities.
|
Package grpctest provides a tiny GRPC service implementation for use in testing other GRPC utilities. |