replicate/go

replicate/go

Description: Repository for go shared libraries (for now).

Language: Go

License: Apache-2.0

Stars: 11

Forks: 4

Open issues: 10

Created: 2023-02-14T02:37:14Z

Pushed: 2025-12-01T11:35:01Z

Default branch: main

Fork: no

Archived: no

README:

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 .

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