ex

module
v1.0.13006-f01fb02 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 12, 2024 License: MIT

README

Go service building blocks

This repository contains a collection of packages designed to aid building reliable, observable, zero-downtime services using Go.

Documentation

Browse the docs at pkg.go.dev. See example / template repo here.

What is in here?

  • config/o11y Wiring code for the o11y package.
  • config/secret Don't store your secrets in a string that can be accidentally logged. Use a secret.String instead.
  • datadog A basic Datadog API client for retrieving metrics back from Datadog.
  • db Common patterns using when talking to an RDBMS. Only supports PostgreSQL at present.
  • httpclient A simple HTTP client that adds observability and resilience to the standard Go HTTP client.
  • httpclient/dnscache A simple DNS cache for use with the HTTP client.
  • httpserver Starting and stopping the standard Go http server cleanly.
  • httpserver/ginrouter A common base for configuring a Gin router instance.
  • httpserver/healthcheck A healthcheck HTTP server that can accept all the checks from a system.
  • mongoex Experimental Common patterns using when talking to MongoDB.
  • o11y Observability that is currently backed by Honeycomb. It also supports outputting trace data as JSON and plain or colored text output.
  • o11y/honeycomb The honeycomb-backed implementation of o11y.
  • o11y/wrappers/o11ygin o11y middleware for the Gin router.
  • o11y/wrappers/o11ynethttp o11y middleware for the standard Go HTTP server.
  • rabbit Experimental RabbitMQ publishing client.
  • redis Wiring and observability for Redis.
  • system Manage the startup, running, metrics and shutdown of a Go service.
  • releases/compiler Compile your Go binaries in a consistent way.
  • releases/releaser Release your Go binaries in a consistent way.
  • rundef automatically calculates and sets standard runtime configuration options
  • termination A handler to aid signal based service termination. (Used internally by the system package).
  • testing/compiler At CircleCI we aim to acceptance test whole compiled binaries. This package lets us do that.
  • testing/dbfixture Get a resettable unique database for each test.
  • testing/download Download releases of binaries for using in end to end service testing.
  • testing/fakemetrics A fake recording o11y metrics implementation.
  • testing/fakestatsd A recording statsd server that will listen on a local UDP port.
  • testing/httprecorder Record HTTP requests inside an HTTP server, and search them.
  • testing/kongtest If you are using kong for your CLI parsing, this helps in writing golden tests for the CLI definition.
  • testing/miniofixture Get a temporary bucket to put your objects in.
  • testing/mongofixture Get an isolated Mongo database for your tests, so they don't interfere.
  • testing/rabbitfixture Get an isolated RabbitMQ VHost for your tests, so they don't interfere.
  • testing/redisfixture Get an isolated Redis DB for your tests, so they don't interfere.
  • testing/releases Helper to determine which binaries to download for end to end tests.
  • testing/runner Run a binary in an acceptance test (scan output for ports, wait for start).
  • testing/testcontext Setup a background context that includes o11y.
  • worker Run a service worker loop with observability and back-off for no work found.

Who is this for?

These packages are intended to be used internally at CircleCI. While this code is licenced permissively with an MIT licence, this is not a true "open source" project, in that there is no active community using it.

No guaranteed API stability

While we do not intentionally aim to break compatibility, we make no promises that we will maintain a stable API if there are good reasons to break it.

Directories

Path Synopsis
Package closer contains a helper function for not losing deferred errors
Package closer contains a helper function for not losing deferred errors
config
Package datadog contains a basic Datadog API client for retrieving metrics back from Datadog.
Package datadog contains a basic Datadog API client for retrieving metrics back from Datadog.
Package db contains a variety of tools for working safely with databases.
Package db contains a variety of tools for working safely with databases.
example module
Package grpchelpers includes helpers to set up grpc connections.
Package grpchelpers includes helpers to set up grpc connections.
Package httpclient provides an HTTP client instrumented with the ex/o11y package, it includes resiliency behaviour such as configurable timeouts, retries, authentication and connection pooling, with support for backing off when a 429 response code is seen.
Package httpclient provides an HTTP client instrumented with the ex/o11y package, it includes resiliency behaviour such as configurable timeouts, retries, authentication and connection pooling, with support for backing off when a 429 response code is seen.
Package httpserver contains helpers for creating zero-downtime REST APIs.
Package httpserver contains helpers for creating zero-downtime REST APIs.
internal
Package mongoex contains a variety of tools for working safely with MongoDB.
Package mongoex contains a variety of tools for working safely with MongoDB.
Package o11y core of the ex observability system, currently backed by Honeycomb's libhoney.
Package o11y core of the ex observability system, currently backed by Honeycomb's libhoney.
plugin
Package rabbit contains an experimental RabbitMQ publishing client.
Package rabbit contains an experimental RabbitMQ publishing client.
Package recontext provides means of obtaining a derived context which ignores parent's deadline, timeout, and cancellation.
Package recontext provides means of obtaining a derived context which ignores parent's deadline, timeout, and cancellation.
Package redis contains wiring and observability for the go-redis Redis client.
Package redis contains wiring and observability for the go-redis Redis client.
releases
Package rootcerts exists to support creating Docker images `FROM scratch`.
Package rootcerts exists to support creating Docker images `FROM scratch`.
Package rundef provides default runtime configurations for services.
Package rundef provides default runtime configurations for services.
Package system manages the startup, running, metrics and shutdown of a Go service.
Package system manages the startup, running, metrics and shutdown of a Go service.
Package termination contains a simple handler for termination signals.
Package termination contains a simple handler for termination signals.
Package testing contains various helpers in sub packages for writing high value tests.
Package testing contains various helpers in sub packages for writing high value tests.
Package worker runs a service worker loop with observability and back-off for no work found.
Package worker runs a service worker loop with observability and back-off for no work found.

Jump to

Keyboard shortcuts

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