Skip to content

chore(release): v0.1.0 - #1

Merged
kalaspuff merged 1 commit into
mainfrom
release/v0.1.0
Oct 12, 2026
Merged

kalaspuff merged 1 commit into
mainfrom
release/v0.1.0

Conversation

@kalaspuff

@kalaspuff kalaspuff commented Oct 12, 2026 •

Copy link
Copy Markdown
Owner

Features

  • Rust core (fanferro-core) with Python bindings (fanferro._core, abi3 for CPython 3.12+).
  • Publishing to SNS topics and SQS queues: single and batch, FIFO group ids and deduplication,
    delays, attributes, envelope headers, partial-failure retries, MD5 verification.
  • Envelopes: CloudEvents 1.0 JSON (default), CloudEvents protobuf, raw, and custom Python envelopes.
  • Codecs: pydantic, dataclasses, msgspec, protobuf, JSON, text, bytes, and custom codecs.
  • Large payloads (claim checks) in S3 with bucket/key and/or presigned URL pointers, SHA-256
    verification, SSRF-safe URL allow-list, and AWS Extended Client format compatibility.
  • Consumers: long polling with in-flight limits, prefetch, rate limiting, multiple pollers, visibility
    heartbeats, batched settlement, routing (types, headers, attributes, JSON body, topic), FIFO
    per-group ordering, handler timeouts, middleware, pause/resume.
  • Failure handling: retry policies (visibility or requeue strategies, backoff), handler actions
    (Retry, Requeue, Reject, Discard), dead-letter forwarding with metadata, max-attempt limits,
    decode/unroutable policies.
  • Graceful shutdown with drain/cancel timeouts, progress events, release of unfinished messages and
    protection against orphaned long polls; SIGINT/SIGTERM handling.
  • Declarative provisioning of topics, queues (with dead-letter queues), subscriptions (with queue
    policies) and payload buckets: lookup, verify, create, update; drift detection; failure modes
    raise/log/ignore/fallback; KMS settings.
  • Events with per-kind logging configuration and sync/async hooks; OpenTelemetry tracing, metrics
    and configurable context propagation (message attributes, CloudEvents envelope, AWS X-Ray header);
    on-demand metrics.
  • Transactional outbox relay, idempotency middleware, in-memory broker for tests, fanferro CLI
    (guide, events, attributes, version).
  • abi3 wheels for CPython 3.12+ on Linux x86_64/aarch64 (manylinux2014 and musllinux_1_2), macOS
    (arm64, x86_64) and Windows (x64; arm64 best effort), plus the sdist.
  • Usage guide for AI agents shipped in the wheel (fanferro guide) and a copyable agent skill.

@kalaspuff
kalaspuff merged commit 9d5fa7d into main Oct 12, 2026
16 checks passed
@kalaspuff
kalaspuff deleted the release/v0.1.0 branch October 12, 2026 22:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant