Skip to content

Release Notes¶

Latest Release -- v1.0.1¶

Cello v1.0.1 -- Cross-Platform & Compatibility Patch (February 2026)

Patch release with cross-platform fixes and async compatibility improvements on top of the stable v1.0.0 release.

Headline fixes:

  • Windows Support -- multi-worker subprocess mode, signal handling, UNC path normalization
  • ARM Architecture -- serde_json fallback for non-SIMD platforms
  • Async Compatibility -- async handler support in validation, guards, cache decorator, and blueprints
  • Export Completeness -- guards and database classes added to cello.__all__

Full v1.0.1 Release Notes Migration Guide

Version Timeline¶

Every release of Cello, from the stable 1.0 through the beta series.

timeline
    title Cello Framework Releases
    2026-02 : v1.0.1 - Cross-Platform & Compatibility Patch
           : v1.0.0 - Production Ready (Stable)
           : v0.10.0 - Event Sourcing, CQRS, Saga
           : v0.9.0 - GraphQL, gRPC, Message Queues
    2026-02 : v0.8.0 - Database Pooling, Redis, Transactions
    2026-01 : v0.7.0 - OpenTelemetry, Health Checks
    2025-12 : v0.6.0 - Smart Caching, Adaptive Rate Limiting
    2025-10 : v0.5.0 - DI, Guards (RBAC), Prometheus
    2025-08 : v0.4.0 - JWT, Sessions, Cluster Mode
    2025-06 : v0.3.0 - WebSocket, SSE, Blueprints

All Releases¶

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

    Windows multi-worker and signal fixes, ARM JSON fallback, async compatibility for guards/cache/blueprints, export completeness.

    February 2026

    Release Notes

  • v1.0.0 -- Production Ready

    Stable release with performance optimizations, API stability guarantees, and the complete feature set.

    February 2026

    Release Notes

  • v0.10.0 -- Advanced Patterns

    Event Sourcing, CQRS, and the Saga Pattern for distributed transaction coordination.

    February 2026

    Release Notes

  • v0.9.0 -- API Protocols

    GraphQL support, gRPC integration, and message queue adapters for Kafka and RabbitMQ.

    February 2026

    Release Notes

  • v0.8.0 -- Data Layer

    Database connection pooling, Redis integration, and transaction support with automatic rollback.

    February 2026

    Release Notes

  • v0.7.0 -- Enterprise Observability

    OpenTelemetry distributed tracing, structured health check endpoints, and enterprise-grade features.

    January 2026

    Release Notes

  • v0.6.0 -- Smart Middleware

    Intelligent caching with TTL, adaptive rate limiting based on system load, DTO validation, and circuit breaker.

    December 2025

    Release Notes

  • v0.5.0 -- Security & DI

    Dependency injection, composable RBAC guards, Prometheus metrics, and OpenAPI generation.

    October 2025

    Release Notes

  • v0.4.0 -- Auth & Sessions

    JWT authentication, token-bucket rate limiting, secure cookie sessions, security headers, and cluster mode.

    August 2025

    Release Notes

  • v0.3.0 -- Real-time

    WebSocket support, Server-Sent Events, multipart form handling, and Flask-inspired blueprints.

    June 2025

    Release Notes

Support Policy¶

Version Status Support Until
1.0.x Active Current
0.10.x Maintenance August 2026
0.9.x Maintenance August 2026
0.8.x Security Only June 2026
< 0.8 End of Life --

Version policy

Cello follows Semantic Versioning. Starting with v1.0.1, the public API is stable -- no breaking changes until v2.0. Maintenance releases receive bug fixes. Security Only releases receive critical security patches only.

Upgrading¶

# Upgrade to the latest stable release
pip install --upgrade cello-framework

# Pin to a specific version
pip install cello-framework==1.0.1  # Latest patch

cello-framework>=1.0.1,<2.0.0

[project]
dependencies = [
    "cello-framework>=1.0.1,<2.0.0",
]

Read the migration guide before upgrading

Breaking changes are documented in the Migration Guide. Always review it before bumping a minor version.

Additional Resources¶

  • Full Changelog

    Every commit, bug fix, and improvement in one place.

    Changelog

  • Migration Guide

    Step-by-step instructions for upgrading between versions.

    Migration Guide

Stay Updated¶