Go Fries Components

This repository has been migrated from the original github.com/go-kratos-ecosystem/components.

Important

The v4 line may include breaking changes compared with v3, please use with caution. Backward compatibility is the default behavior within v4, and any incompatibilities will be noted in the release.

Installation

go get github.com/go-fries/fries/v4

Components

The catalog below lists the public modules in the stable release set. Examples and internal development tools are not included.

Family	Modules	Description
Core	fries errors parallel constraints capability	Release metadata, shared error helpers, parallel batch and stream processing, generic constraints, and capability contracts.
Batcher	batcher	Size- and time-triggered batching with a bounded queue, serial processing, explicit flushing, and graceful shutdown.
Cache	cache cache/redis	Cache abstractions and a Redis-backed store.
Crontab	crontab	Adapts go-cron schedulers to the Kratos server lifecycle.
Codec	codec codec/json codec/msgpack codec/sonic codec/proto codec/xml codec/yaml	A shared encoding contract with JSON, MessagePack, Sonic, Protocol Buffers, XML, and YAML implementations.
Config	config	Type-safe configuration propagation through context.Context.
Chi	chi	A Chi-based HTTP server adapter.
CloudEvents	cloudevents/protocol/amqp091 cloudevents/eventdispatcher	AMQP 0.9.1 transport and event dispatching for CloudEvents.
Debounce	debounce	Trailing-edge debouncing with latest-value replacement, serial handlers, explicit flushing, and cancellation.
Env	env	Utilities for representing and propagating application environments.
Encrypter	encrypter	AES-CTR string encryption and decryption helpers.
Ent	ent ent/multidriver	Ent integrations for logging and routing operations across multiple drivers.
Event	event event/middleware/recovery	Synchronous type-aware event dispatching with optional panic recovery middleware.
Eino	eino/components/embedding/cached eino/components/embedding/cached/cacher/redis eino/components/embedding/cached/cacher/gorm	Cached Eino embeddings with Redis and GORM cache backends.
Lifecycle	lifecycle	Context-aware application startup, execution, rollback, and graceful shutdown.
Filesystem	filesystem filesystem/s3 filesystem/local filesystem/oss	A logical-path storage contract with Amazon S3, local, and Alibaba Cloud OSS drivers.
Gin	gin	A Gin-based HTTP server adapter.
GORM	gorm/logger/multi gorm/logger/otel gorm/scope	Multi-target and OpenTelemetry loggers plus reusable query scopes for GORM.
Hyperf	hyperf/jet hyperf/jet/middleware/logger hyperf/jet/middleware/recovery hyperf/jet/middleware/retry hyperf/jet/middleware/timeout hyperf/jet/middleware/otel	A Hyperf-compatible RPC client with logging, recovery, retry, timeout, and OpenTelemetry middleware.
Hashing	hashing hashing/md5	Reusable deterministic digest helpers and an MD5 implementation.
Health	health	Named, context-aware application health checks with structured reports and HTTP probe handling.
Idempotency	idempotency idempotency/memory idempotency/redis	Atomic idempotency claims and completed records with memory and Redis stores.
HTTP	http/server	A common HTTP server wrapper that can participate in the Kratos lifecycle.
JSON-RPC	jsonrpc	A lightweight JSON-RPC 2.0 client.
Log	log/slog/multi log/slog/syslog	log/slog handlers for fan-out logging and syslog.
Kratos	kratos/middleware/cors kratos/middleware/protovalidate kratos/middleware/otel	CORS, protobuf validation, and OpenTelemetry middleware for Kratos.
Locker	locker locker/redis	Distributed lock contracts and a Redis implementation.
Queue	queue queue/adapter/memory queue/adapter/rabbitmq queue/adapter/redis queue/kratos/server queue/middleware/recovery	Task queue primitives, memory, RabbitMQ and Redis adapters, Kratos lifecycle integration, and recovery middleware.
Rate Limit	ratelimit ratelimit/memory ratelimit/redis	Key-based GCRA rate limiting with memory and Redis stores.
MySQL	mysql/canal mysql/canal/positioner/redis mysql/canal/server	MySQL binlog processing with Redis position storage and server lifecycle integration.
OpenTelemetry	otel/otlp	Global OpenTelemetry provider configuration using OTLP exporters.
Poll	poll	Context-aware condition polling for eventually consistent state and asynchronous work.
Ptr	ptr	Generic pointer helpers.
Recovery	recovery	Shared panic recovery utilities.
Signal	signal	Signal handling integrated with application server lifecycles.
Slices	slices	Generic slice helpers.
Strings	strings	String helpers for common application code.
Support	support	General-purpose helper types and value utilities.
Time	time/period	Immutable half-open time intervals with intersection, subtraction, merging, and gap detection.
Timezone	timezone	Time zone propagation through application contexts.
UDP	udp	A lifecycle-aware UDP server.
Webhook	webhook webhook/sender	Standard Webhooks signing, verification, secret rotation, and single-attempt HTTP delivery.
X	x/pagination x/prints x/container	Experimental pagination, terminal output, and dependency container utilities without compatibility guarantees.

Contributing

See CONTRIBUTING.md for contribution guidelines and component design conventions.

License

The MIT License (MIT). Please see License File for more information.