Skip to content

Changelog¶

All notable changes to the Cello Framework are documented here. Each version links to its full release notes for detailed descriptions and code examples.

v1.0.1 -- Cross-Platform & Compatibility Patch¶

Cross-Platform Fixes: - Windows multi-worker: subprocess re-execution (CELLO_WORKER=1) instead of broken multiprocessing.Process - Windows signal handling: SIGTERM wrapped in try/except, platform validation for signals - Windows static files: UNC path normalization fix - Linux-only CPU affinity: gated with warning on other platforms - ARM JSON: serde_json fallback for non-SIMD architectures

Compatibility Fixes: - Async handler validation: wrap_handler_with_validation now supports async handlers - Async guard wrappers: _apply_guards creates async/sync wrappers based on handler type - Async cache decorator: cache() now supports async handlers - Blueprint validation & guards: Blueprint route decorators now support guards parameter and validation - Guards exported in __all__: RoleGuard, PermissionGuard, Authenticated, And, Or, Not, GuardError, ForbiddenError, UnauthorizedError - Database exports: Database, Redis, Transaction added to __all__

Full release notes

v1.0.0 -- Production Ready¶

  • First stable release with semantic versioning guarantees
  • Major performance optimizations: handler metadata caching, lazy body parsing, zero-copy responses
  • TCP_NODELAY, HTTP keep-alive, and pipeline flush for lower latency
  • VecDeque ring buffer for O(1) latency tracking (was O(n))
  • Atomic fast-path checks for DI, guards, middleware, and lifecycle hooks
  • Optimized release build: LTO fat, panic=abort, strip, overflow-checks=false
  • API stability commitment: no breaking changes until v2.0
  • All 394 tests passing

Full release notes

v0.10.0 -- Advanced Patterns¶

  • Added Event Sourcing with Aggregate base class, event replay, and snapshots
  • Added CQRS with Command/Query separation, dedicated buses, and event-driven sync
  • Added Saga Pattern for distributed transaction coordination with compensation logic
  • Added EventSourcingConfig, CqrsConfig, and SagaConfig configuration classes
  • Fixed GraphQL subscription disconnects under high throughput
  • Fixed gRPC reflection not listing methods after hot reload
  • Fixed Kafka consumer group rebalancing causing duplicate processing
  • Updated version references across all modules

Full release notes

v0.9.0 -- GraphQL, gRPC, and Messaging¶

  • Added GraphQL support with schema-first and code-first approaches
  • Added gRPC server and client with Protocol Buffers integration
  • Added message queue adapters for Kafka, RabbitMQ, and AWS SQS
  • Added pub/sub patterns and event-driven architecture primitives
  • Added streaming RPC support for bidirectional communication
  • Updated version references across all modules

Full release notes

v0.8.0 -- Database and Caching Infrastructure¶

  • Added database connection pooling for PostgreSQL, MySQL, and SQLite
  • Added Redis integration with connection pooling and pub/sub
  • Added query builder with parameterized queries
  • Added transaction management with automatic rollback
  • Added database health checks and connection monitoring
  • Updated version references across all modules

Full release notes

v0.7.0 -- Enterprise Features¶

  • Added OpenTelemetry integration for distributed tracing
  • Added health check endpoints (/health/live, /health/ready, /health/startup)
  • Added structured logging with configurable outputs
  • Improved Kubernetes deployment support with full manifest examples
  • Added Docker multi-stage build documentation
  • Added service mesh integration guide (Istio, Envoy)
  • Updated version references across all modules

Full release notes

v0.6.0 -- Smart Caching and Validation¶

  • Added @cache decorator with TTL and tag-based invalidation
  • Added adaptive rate limiting based on server health metrics
  • Added DTO validation with RFC 7807 Problem Details error responses
  • Added circuit breaker middleware for fault tolerance
  • Enhanced guards with controller-level and route-level support
  • 15% faster JSON parsing through improved SIMD utilization
  • 20% lower memory usage with optimized arena allocators
  • Fixed WebSocket connection cleanup on client disconnect
  • Fixed memory leak in long-running SSE connections
  • Fixed race condition in concurrent session updates

Full release notes

v0.5.0 -- Dependency Injection and RBAC¶

  • Added dependency injection via Depends with singleton and transient lifetimes
  • Added composable guards: RoleGuard, PermissionGuard, AuthenticatedGuard
  • Added guard composition with AndGuard, OrGuard, NotGuard
  • Added built-in Prometheus metrics endpoint
  • Added OpenAPI 3.0 schema generation with Swagger UI and ReDoc
  • Added background tasks (fire-and-forget after response)
  • Added Jinja2 template rendering via minijinja
  • 12% faster middleware chain through pre-computed execution plans
  • Breaking: Middleware priority values renumbered
  • Breaking: app.include_blueprint() renamed to app.register_blueprint()
  • Fixed JWT token refresh returning expired claims
  • Fixed rate limiter not resetting window after full expiry

Full release notes

v0.4.0 -- Security and Production Readiness¶

  • Added JWT authentication (HS256, HS384, HS512, RS256, RS384, RS512, ES256, ES384)
  • Added rate limiting with token bucket and sliding window algorithms
  • Added encrypted cookie session management with automatic rotation
  • Added security headers middleware (CSP, HSTS, X-Frame-Options, etc.)
  • Added cluster mode with multi-process workers via SO_REUSEPORT
  • Added native TLS support via rustls (TLS 1.2 and 1.3)
  • Added --env CLI flag for development/production mode switching
  • 10% faster routing through improved radix tree traversal
  • Breaking: Middleware now executes in registration order
  • Fixed OPTIONS preflight not bypassing rate limiting
  • Fixed WebSocket upgrade failing with compression middleware enabled

Full release notes

v0.3.0 -- Real-Time Communication¶

  • Added WebSocket support via tokio-tungstenite
  • Added Server-Sent Events (SSE) with async generators
  • Added multipart form handling and file uploads via multer
  • Added Blueprints for modular route organization with nesting
  • Optimized radix tree with pre-compiled route patterns
  • Zero-copy WebSocket frame passing through Rust layer
  • Fixed route conflicts with overlapping path parameters
  • Fixed Content-Length not set for empty responses

Full release notes

v0.2.0 -- Middleware System¶

  • Added middleware system with composable chain execution
  • Added CORS middleware with configurable origins, methods, and headers
  • Added request/response logging middleware
  • Added gzip and brotli compression middleware
  • Added request timing and performance tracking
  • Improved error handling with structured error responses

v0.1.0 -- Initial Release¶

  • Rust-powered HTTP server via hyper and tokio
  • Python route registration with decorators (@app.get, @app.post, etc.)
  • Radix tree routing via matchit with path parameters and wildcards
  • SIMD-accelerated JSON parsing via simd-json
  • Async handler support
  • Static file serving
  • Basic request/response API
  • PyO3 abi3 bindings for Python 3.12+
  • CLI with --host, --port, --debug flags