`replicate/go`

This repository contains shared packages used by Go applications at Replicate. If we find ourselves writing the same code repeatedly across different applications, we might want to put it here.

In due course, it may become a monorepo for our services and tools built using Go.

For now, the repository is public, to simplify its use as a Go module in other applications.

Packages

`cache`

A redis-backed typed object cache implementation supporting serve-from-stale and asynchronous cache fills.

`debug`

Debug server utilities for exposing runtime information and debugging endpoints.

`errors`

Configures conventions for recording errors: a wrapper around the Sentry SDK.

`flags`

Feature flagging functions: a thin wrapper around the LaunchDarkly client.

`httpclient`

Conventions for creating HTTP clients with appropriate pooling and timeout configuration. Heavily inspired by https://github.com/hashicorp/go-cleanhttp.

`kv`

Consolidated package for Redis/Valkey client management with Sentinel support, TLS configuration, and automatic OpenTelemetry instrumentation.

`lock`

A redis-backed distributed lock for coordination within multi-instance services.

`logging`

Configures logging conventions using go.uber.org/zap.

`must`

Utility functions for handling errors in initialization code where panicking is appropriate.

`queue`

Redis streams-based queue implementation with shuffle-sharding for tenant isolation and workload distribution.

`ratelimit`

A redis-backed token-bucket rate limiter implementation.

`shuffleshard`

Implementation of shuffle sharding for distributing workloads across multiple instances.

`telemetry`

Standard OpenTelemetry configuration and tracer creation.

`types`

Common type definitions and utilities including custom duration parsing and pointer helpers.

`uuid`

UUID generation utilities with support for UUIDv7 (time-ordered UUIDs).

`version`

A convention for retrieving service version from the environment.

Tools

The repository also contains a uuid command that can be used to generate a list of uuids using the uuid package.

% go run ./cmd/uuid/main.go
> 018d3855-24f0-7531-84b4-4e88f13bab70
% go run ./cmd/uuid/main.go -timestamps
> 018d3855-24f0-7531-84b4-4e88f13bab70 2024-01-23T21:58:40.624Z
% go run ./cmd/uuid/main.go -count 5 -timestamps
> 018d3855-24f0-7531-84b4-4e88f13bab70 2024-01-23T21:58:40.624Z
> 018d3855-24f1-7b1e-be24-4ce73f77d3bf 2024-01-23T21:58:40.625Z
> 018d3855-24f1-7b33-8b7b-50e5e535b510 2024-01-23T21:58:40.625Z
> 018d3855-24f1-75d7-abb1-0db1ac9ac285 2024-01-23T21:58:40.625Z
> 018d3855-24f1-78fc-a1ce-a81e26b3fbe8 2024-01-23T21:58:40.625Z

Development

You can run the build, check the tests, lint the code, and run a formatter using the scripts provided in script/

script/build
script/test
script/format
script/lint

License

replicate/go

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 15

Languages

Packages