4.5.0 — 2026-04-27

← 4.6.0 | 4.4.2 → | ↑ 4.x series

Added

Adapters - Payment Gateways

• Saman Shaparak Adapter - Added new payment gateway adapter for Saman integration.
  • New saman-ipg optional extra
  • Added SAMAN_SHAPARAK__* environment variables

Helpers - Utils

• DatetimeUtils Caching Refactor - Refactored Iran holiday caching to use ClassVar.
  • Removed @ttl_cache_decorator dependency for holiday lookups
  • Added class-level cache with manual TTL handling

Changed

Adapters - Kafka

• Async Method Cleanup - Removed noqa comments from async Kafka adapter methods.
  • Removed ASYNC109 noqa from flush(), list_topics(), batch_consume(), poll()

Documentation - Payment Gateways

• Tutorial Unification - Unified payment gateway tutorials across all adapters.

Chore

Dependencies - Project

• Dependency Updates - Updated multiple package constraints.
  • cache: cachetools>=7.0.5 → >=7.0.6
  • fastapi: >=0.135.3 → >=0.136.1
  • minio: boto3>=1.42.89 → >=1.42.96
  • ty: >=0.0.30 → >=0.0.32
  • pre-commit: >=4.5.1 → >=4.6.0
  • ruff: >=0.15.10 → >=0.15.12

Tests - Containers

• Container Update - Bumped test container version.