bustapi 0.12.0__tar.gz → 0.13.1__tar.gz

{bustapi-0.12.0 → bustapi-0.13.1}/.github/FUNDING.yml

@@ -1,4 +1,4 @@
 # These are supported funding model platforms
 
 patreon: Grandpa_EJ
-custom: ["https://ej.grandpaacademy.org/"]
+custom: ["https://ej.grandpaacademy.org/"]

{bustapi-0.12.0 → bustapi-0.13.1}/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented here.
 
+## [0.13.1] - 2026-05-03
+
+### Fixed
+- **StreamingResponse Support**: Fixed a regression in v0.13.0 where `StreamingResponse` and `FileResponse` were returning empty bodies due to over-strict Python-to-Rust conversion.
+- **Async Streaming Stability**: Refactored async stream polling to use the global background event loop, ensuring robust support for async generators (including those using `asyncio.sleep`) within Actix-web worker threads.
+
+## [0.13.0] - 2026-05-02
+
+### Added
+- **Robust Header Infrastructure**:
+  - Refactored `Headers` class to use `collections.UserDict` for better standard library compatibility.
+  - Implemented full case-insensitivity for all header operations (get, set, delete).
+  - Added native support for multi-value headers via `headers.add(key, value)` and `headers.getlist(key)`.
+- **WSGI Adapter Enhancements**:
+  - Refactored `WSGIAdapter` to correctly handle multi-value headers.
+  - Integrated application-level error handling (including custom 404/500 handlers) into the WSGI layer.
+
+### Fixed
+- **JWT & Cookie Security**:
+  - Updated `Response.delete_cookie()` signature to accept `secure`, `httponly`, and `samesite` arguments, fixing crashes in JWT logout flows.
+  - Improved cookie attribute handling to ensure consistency between Python and Rust layers.
+- **Response Unwrapping**: Fixed a bug where returning a `Response` object inside another `Response` (common in error handlers using `render_template`) resulted in the object's string representation being sent as the body.
+- **FFI Stability**: Standardized the Python-to-Rust response conversion to ensure reliable header serialization.
+
 ## [0.12.0] - 2026-04-27
 
 ### Added

{bustapi-0.12.0 → bustapi-0.13.1}/Cargo.lock

@@ -438,7 +438,7 @@ checksum = "5d20789868f4b01b2f2caec9f5c4e0213b41e3e5702a50157d699ae31ced2fcb"
 
 [[package]]
 name = "bustapi_core"
-version = "0.12.0"
+version = "0.13.1"
 dependencies = [
  "actix-files",
  "actix-http",
@@ -488,9 +488,9 @@ checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33"
 
 [[package]]
 name = "bytestring"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "113b4343b5f6617e7ad401ced8de3cc8b012e73a594347c307b90db3e9271289"
+checksum = "86566c496f2f47d9b8147a4c8b02ffdb69c919fe0c2b2e7195d22cbba0e635c9"
 dependencies = [
  "bytes",
 ]
@@ -1262,9 +1262,9 @@ dependencies = [
 
 [[package]]
 name = "idna_adapter"
-version = "1.2.1"
+version = "1.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3acae9609540aa318d1bc588455225fb2085b9ed0c4f6bd0d9d5bcd86f1a0344"
+checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714"
 dependencies = [
  "icu_normalizer",
  "icu_properties",
@@ -1288,15 +1288,6 @@ dependencies = [
  "serde_core",
 ]
 
-[[package]]
-name = "indoc"
-version = "2.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
-dependencies = [
- "rustversion",
-]
-
 [[package]]
 name = "inotify"
 version = "0.11.1"
@@ -1344,10 +1335,12 @@ dependencies = [
 
 [[package]]
 name = "js-sys"
-version = "0.3.95"
+version = "0.3.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2964e92d1d9dc3364cae4d718d93f227e3abb088e747d92e0395bfdedf1c12ca"
+checksum = "a1840c94c045fbcf8ba2812c95db44499f7c64910a912551aaaa541decebcacf"
 dependencies = [
+ "cfg-if",
+ "futures-util",
  "once_cell",
  "wasm-bindgen",
 ]
@@ -1476,15 +1469,6 @@ version = "0.3.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "38d1115007560874e373613744c6fba374c17688327a71c1476d1a5954cc857b"
 
-[[package]]
-name = "memoffset"
-version = "0.9.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "mimalloc"
 version = "0.1.50"
@@ -1749,28 +1733,26 @@ dependencies = [
 
 [[package]]
 name = "pyo3"
-version = "0.27.2"
+version = "0.28.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab53c047fcd1a1d2a8820fe84f05d6be69e9526be40cb03b73f86b6b03e6d87d"
+checksum = "91fd8e38a3b50ed1167fb981cd6fd60147e091784c427b8f7183a7ee32c31c12"
 dependencies = [
- "indoc",
  "libc",
- "memoffset",
  "once_cell",
  "portable-atomic",
  "pyo3-build-config",
  "pyo3-ffi",
  "pyo3-macros",
- "unindent",
 ]
 
 [[package]]
 name = "pyo3-async-runtimes"
-version = "0.27.0"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57ddb5b570751e93cc6777e81fee8087e59cd53b5043292f2a6d59d5bd80fdfd"
+checksum = "9e7364a95bf00e8377bbf9b0f09d7ff9715a29d8fcf93b47d1a967363b973178"
 dependencies = [
- "futures",
+ "futures-channel",
+ "futures-util",
  "once_cell",
  "pin-project-lite",
  "pyo3",
@@ -1779,18 +1761,18 @@ dependencies = [
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.27.2"
+version = "0.28.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b455933107de8642b4487ed26d912c2d899dec6114884214a0b3bb3be9261ea6"
+checksum = "e368e7ddfdeb98c9bca7f8383be1648fd84ab466bf2bc015e94008db6d35611e"
 dependencies = [
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.27.2"
+version = "0.28.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c85c9cbfaddf651b1221594209aed57e9e5cff63c4d11d1feead529b872a089"
+checksum = "7f29e10af80b1f7ccaf7f69eace800a03ecd13e883acfacc1e5d0988605f651e"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -1798,9 +1780,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.27.2"
+version = "0.28.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a5b10c9bf9888125d917fb4d2ca2d25c8df94c7ab5a52e13313a07e050a3b02"
+checksum = "df6e520eff47c45997d2fc7dd8214b25dd1310918bbb2642156ef66a67f29813"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
@@ -1810,9 +1792,9 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.27.2"
+version = "0.28.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03b51720d314836e53327f5871d4c0cfb4fb37cc2c4a11cc71907a86342c40f9"
+checksum = "c4cdc218d835738f81c2338f822078af45b4afdf8b2e33cbb5916f108b813acb"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -2399,12 +2381,6 @@ version = "0.2.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ebc1c04c71510c7f702b52b7c350734c9ff1295c464a03335b00bb84fc54f853"
 
-[[package]]
-name = "unindent"
-version = "0.2.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
-
 [[package]]
 name = "universal-hash"
 version = "0.5.1"
@@ -2487,9 +2463,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.118"
+version = "0.2.120"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0bf938a0bacb0469e83c1e148908bd7d5a6010354cf4fb73279b7447422e3a89"
+checksum = "df52b6d9b87e0c74c9edfa1eb2d9bf85e5d63515474513aa50fa181b3c4f5db1"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -2500,9 +2476,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.118"
+version = "0.2.120"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eeff24f84126c0ec2db7a449f0c2ec963c6a49efe0698c4242929da037ca28ed"
+checksum = "78b1041f495fb322e64aca85f5756b2172e35cd459376e67f2a6c9dffcedb103"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -2510,9 +2486,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.118"
+version = "0.2.120"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d08065faf983b2b80a79fd87d8254c409281cf7de75fc4b773019824196c904"
+checksum = "9dcd0ff20416988a18ac686d4d4d0f6aae9ebf08a389ff5d29012b05af2a1b41"
 dependencies = [
  "bumpalo",
  "proc-macro2",
@@ -2523,9 +2499,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.118"
+version = "0.2.120"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5fd04d9e306f1907bd13c6361b5c6bfc7b3b3c095ed3f8a9246390f8dbdee129"
+checksum = "49757b3c82ebf16c57d69365a142940b384176c24df52a087fb748e2085359ea"
 dependencies = [
  "unicode-ident",
 ]

{bustapi-0.12.0 → bustapi-0.13.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "bustapi_core"
-version = "0.12.0"
+version = "0.13.1"
 edition = "2021"
 readme = "README.md"
 
@@ -10,20 +10,20 @@ crate-type = ["cdylib"]
 
 [dependencies]
 # Actix-web (replaces Hyper for better performance)
-actix-web = "4"
-actix-rt = "2"
-actix-http = "3"
+actix-web = "4.13"
+actix-rt = "2.10"
+actix-http = "3.9"
 actix-files = "0.6"
 actix-ws = "0.2.5"
 
 # PyO3 with latest version for Python 3.14 support
-pyo3 = { version = "0.27", features = ["extension-module", "abi3-py310"] }
-# Use pyo3-async-runtimes (compatible with pyo3 0.27)
-pyo3-async-runtimes = { version = "0.27", features = ["tokio-runtime"] }
+pyo3 = { version = "0.28", features = ["extension-module", "abi3-py310"] }
+# Use pyo3-async-runtimes (compatible with pyo3 0.28)
+pyo3-async-runtimes = { version = "0.28", features = ["tokio-runtime"] }
 
 # Async runtime
-tokio = { version = "1.0", features = ["full"] }
-futures = "0.3"
+tokio = { version = "1.52", features = ["full"] }
+futures = "0.3.31"
 cookie = { version = "0.18", features = ["signed", "secure", "percent-encode"] }
 percent-encoding = "2.3"
 sha2 = "0.10"
@@ -38,9 +38,9 @@ rand = "0.8"
 # Utilities
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
-bytes = "1.0"
+bytes = "1.10"
 http = "0.2"
-url = "2.0"
+url = "2.5"
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 anyhow = "1.0"
@@ -64,7 +64,7 @@ default = ["mimalloc"]
 
 
 [build-dependencies]
-pyo3-build-config = "0.27"
+pyo3-build-config = "0.28"
 
 [profile.release]
 lto = true

{bustapi-0.12.0 → bustapi-0.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bustapi
-Version: 0.12.0
+Version: 0.13.1
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -14,10 +14,10 @@ Classifier: Programming Language :: Rust
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Dist: jinja2>=3.1.6
-Requires-Dist: uvicorn>=0.38.0 ; extra == 'benchmarks'
+Requires-Dist: uvicorn>=0.46.0 ; extra == 'benchmarks'
 Requires-Dist: catzilla>=0.2.0 ; extra == 'benchmarks'
 Requires-Dist: flask>=3.1.2 ; extra == 'benchmarks'
-Requires-Dist: fastapi>=0.124.0 ; extra == 'benchmarks'
+Requires-Dist: fastapi>=0.136.1 ; extra == 'benchmarks'
 Requires-Dist: gunicorn>=23.0.0 ; extra == 'benchmarks'
 Requires-Dist: httpx>=0.28.1 ; extra == 'benchmarks'
 Requires-Dist: matplotlib>=3.10.0 ; extra == 'benchmarks'
@@ -28,16 +28,16 @@ Requires-Dist: django>=5.0.0 ; extra == 'benchmarks'
 Requires-Dist: blacksheep>=2.0.8 ; extra == 'benchmarks'
 Requires-Dist: black>=24.8.0 ; extra == 'dev'
 Requires-Dist: isort>=5.13.2 ; extra == 'dev'
-Requires-Dist: maturin>=1.9.3 ; extra == 'dev'
+Requires-Dist: maturin>=1.13.1 ; extra == 'dev'
 Requires-Dist: pytest>=8.3.5 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.24.0 ; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.12.10 ; extra == 'dev'
+Requires-Dist: ruff>=0.15.12 ; extra == 'dev'
 Requires-Dist: mypy>=1.0 ; extra == 'dev'
 Requires-Dist: pre-commit>=3.0 ; extra == 'dev'
 Requires-Dist: sqlmodel>=0.0.16 ; extra == 'dev'
 Requires-Dist: psutil>=5.9.0 ; extra == 'dev'
-Requires-Dist: requests>=2.32.5 ; extra == 'dev'
+Requires-Dist: requests>=2.33.1 ; extra == 'dev'
 Requires-Dist: mkdocs>=1.5 ; extra == 'docs'
 Requires-Dist: mkdocs-material>=9.0 ; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.20 ; extra == 'docs'
@@ -61,10 +61,10 @@ Author-email: GrandpaEJ <>
 License: MIT
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Documentation, https://grandpaej.github.io/BustAPI/
-Project-URL: Homepage, https://github.com/GrandpaEJ/bustapi
-Project-URL: Issues, https://github.com/GrandpaEJ/bustapi/issues
-Project-URL: Repository, https://github.com/GrandpaEJ/bustapi.git
+Project-URL: Documentation, https://RUSTxPY.github.io/BustAPI/
+Project-URL: Homepage, https://github.com/RUSTxPY/BustAPI
+Project-URL: Issues, https://github.com/RUSTxPY/BustAPI/issues
+Project-URL: Repository, https://github.com/RUSTxPY/BustAPI.git
 
 # BustAPI — High-Performance Python Web Framework
 
@@ -107,6 +107,7 @@ Under the hood, BustAPI runs on [Actix-Web](https://actix.rs/) — consistently
 - 🦀 **Rust-powered** — Zero-copy JSON, mimalloc allocator, Actix-Web
 - 🐍 **Pure Python API** — No Rust knowledge required
 - 🔒 **Security built-in** — JWT, sessions, CSRF, rate limiting
+- 🛡️ **Robust Header System** — Case-insensitive, multi-value support, high-performance cookie parsing
 - 📦 **Zero config** — `pip install bustapi` and you're ready
 - 🔥 **Hot reload** — Rust-native file watcher for instant restarts
 
@@ -510,13 +511,13 @@ CMD ["python", "app.py"]
 
 ## 📖 Documentation
 
-📚 **[Full Documentation](https://grandpaej.github.io/BustAPI/)**
+📚 **[Full Documentation](https://RUSTxPY.github.io/BustAPI/)**
 
-- [Getting Started](https://grandpaej.github.io/BustAPI/quickstart/)
-- [Routing Guide](https://grandpaej.github.io/BustAPI/user-guide/routing/)
-- [JWT Authentication](https://grandpaej.github.io/BustAPI/user-guide/jwt/)
-- [WebSocket Guide](https://grandpaej.github.io/BustAPI/user-guide/websocket/)
-- [API Reference](https://grandpaej.github.io/BustAPI/api-reference/)
+- [Getting Started](https://RUSTxPY.github.io/BustAPI/quickstart/)
+- [Routing Guide](https://RUSTxPY.github.io/BustAPI/user-guide/routing/)
+- [JWT Authentication](https://RUSTxPY.github.io/BustAPI/user-guide/jwt/)
+- [WebSocket Guide](https://RUSTxPY.github.io/BustAPI/user-guide/websocket/)
+- [API Reference](https://RUSTxPY.github.io/BustAPI/api-reference/)
 
 ---
 
@@ -532,8 +533,8 @@ We welcome contributions! Here's how:
 
 Found a bug? Have a feature request?
 
-- [Open an Issue](https://github.com/GrandpaEJ/bustapi/issues)
-- [Start a Discussion](https://github.com/GrandpaEJ/bustapi/discussions)
+- [Open an Issue](https://github.com/RUSTxPY/BustAPI/issues)
+- [Start a Discussion](https://github.com/RUSTxPY/BustAPI/discussions)
 
 ---
 

{bustapi-0.12.0 → bustapi-0.13.1}/README.md

@@ -39,6 +39,7 @@ Under the hood, BustAPI runs on [Actix-Web](https://actix.rs/) — consistently
 - 🦀 **Rust-powered** — Zero-copy JSON, mimalloc allocator, Actix-Web
 - 🐍 **Pure Python API** — No Rust knowledge required
 - 🔒 **Security built-in** — JWT, sessions, CSRF, rate limiting
+- 🛡️ **Robust Header System** — Case-insensitive, multi-value support, high-performance cookie parsing
 - 📦 **Zero config** — `pip install bustapi` and you're ready
 - 🔥 **Hot reload** — Rust-native file watcher for instant restarts
 
@@ -442,13 +443,13 @@ CMD ["python", "app.py"]
 
 ## 📖 Documentation
 
-📚 **[Full Documentation](https://grandpaej.github.io/BustAPI/)**
+📚 **[Full Documentation](https://RUSTxPY.github.io/BustAPI/)**
 
-- [Getting Started](https://grandpaej.github.io/BustAPI/quickstart/)
-- [Routing Guide](https://grandpaej.github.io/BustAPI/user-guide/routing/)
-- [JWT Authentication](https://grandpaej.github.io/BustAPI/user-guide/jwt/)
-- [WebSocket Guide](https://grandpaej.github.io/BustAPI/user-guide/websocket/)
-- [API Reference](https://grandpaej.github.io/BustAPI/api-reference/)
+- [Getting Started](https://RUSTxPY.github.io/BustAPI/quickstart/)
+- [Routing Guide](https://RUSTxPY.github.io/BustAPI/user-guide/routing/)
+- [JWT Authentication](https://RUSTxPY.github.io/BustAPI/user-guide/jwt/)
+- [WebSocket Guide](https://RUSTxPY.github.io/BustAPI/user-guide/websocket/)
+- [API Reference](https://RUSTxPY.github.io/BustAPI/api-reference/)
 
 ---
 
@@ -464,8 +465,8 @@ We welcome contributions! Here's how:
 
 Found a bug? Have a feature request?
 
-- [Open an Issue](https://github.com/GrandpaEJ/bustapi/issues)
-- [Start a Discussion](https://github.com/GrandpaEJ/bustapi/discussions)
+- [Open an Issue](https://github.com/RUSTxPY/BustAPI/issues)
+- [Start a Discussion](https://github.com/RUSTxPY/BustAPI/discussions)
 
 ---
 

{bustapi-0.12.0 → bustapi-0.13.1}/docs/changelog.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented here.
 
+## [0.13.1] - 2026-05-03
+
+### Fixed
+- **StreamingResponse Support**: Fixed a regression in v0.13.0 where `StreamingResponse` and `FileResponse` were returning empty bodies due to over-strict Python-to-Rust conversion.
+- **Async Streaming Stability**: Refactored async stream polling to use the global background event loop, ensuring robust support for async generators (including those using `asyncio.sleep`) within Actix-web worker threads.
+
+## [0.13.0] - 2026-05-02
+
+### Added
+- **Robust Header Infrastructure**:
+  - Refactored `Headers` class to use `collections.UserDict` for better standard library compatibility.
+  - Implemented full case-insensitivity for all header operations (get, set, delete).
+  - Added native support for multi-value headers via `headers.add(key, value)` and `headers.getlist(key)`.
+- **WSGI Adapter Enhancements**:
+  - Refactored `WSGIAdapter` to correctly handle multi-value headers.
+  - Integrated application-level error handling (including custom 404/500 handlers) into the WSGI layer.
+
+### Fixed
+- **JWT & Cookie Security**:
+  - Updated `Response.delete_cookie()` signature to accept `secure`, `httponly`, and `samesite` arguments, fixing crashes in JWT logout flows.
+  - Improved cookie attribute handling to ensure consistency between Python and Rust layers.
+- **Response Unwrapping**: Fixed a bug where returning a `Response` object inside another `Response` (common in error handlers using `render_template`) resulted in the object's string representation being sent as the body.
+- **FFI Stability**: Standardized the Python-to-Rust response conversion to ensure reliable header serialization.
+
 ## [0.12.0] - 2026-04-27
 
 ### Added

{bustapi-0.12.0 → bustapi-0.13.1}/docs/complete-api-reference.md

@@ -1,7 +1,7 @@
 # BustAPI Complete API Reference
 
-> **Version:** 0.3.1  
-> **Last Updated:** 2025-12-10
+> **Version:** 0.13.0  
+> **Last Updated:** 2026-05-02
 
 ## Table of Contents
 
@@ -356,8 +356,29 @@ response.data           # Response body as bytes
 ```python
 response.set_data(data)                 # Set response data
 response.get_data(as_text=False)        # Get response data
-response.set_cookie(key, value, ...)    # Set a cookie
-response.delete_cookie(key, ...)        # Delete a cookie
+
+# Set a cookie
+response.set_cookie(
+    key: str,
+    value: str = '',
+    max_age: Optional[int] = None,
+    expires: Optional[Union[datetime, float]] = None,
+    path: str = '/',
+    domain: Optional[str] = None,
+    secure: bool = False,
+    httponly: bool = False,
+    samesite: Optional[str] = 'Lax'
+)
+
+# Delete a cookie
+response.delete_cookie(
+    key: str,
+    path: str = '/',
+    domain: Optional[str] = None,
+    secure: bool = False,
+    httponly: bool = False,
+    samesite: Optional[str] = 'Lax'
+)
 ```
 
 **Example:**
@@ -371,6 +392,30 @@ def custom_response():
     return resp
 ```
 
+### Headers Object
+
+The `response.headers` object provides a case-insensitive dictionary-like interface for managing HTTP headers.
+
+#### Methods
+
+- `get(key, default=None)`: Get the first value for a header (case-insensitive).
+- `add(key, value)`: Add a value to a header, preserving existing values (multi-value support).
+- `getlist(key)`: Get all values for a header as a list.
+- `setlist(key, values)`: Set multiple values for a header.
+- `items()`: Get all header key-value pairs as a list of tuples.
+
+**Example:**
+
+```python
+resp.headers['Content-Type'] = 'application/json'
+resp.headers.add('Link', '<https://example.com>; rel="next"')
+resp.headers.add('Link', '<https://example.com>; rel="prev"')
+
+links = resp.headers.getlist('Link')  # ['...', '...']
+```
+
+---
+
 #### Response Helper Functions
 
 ##### `jsonify(*args, **kwargs)`
@@ -1076,14 +1121,30 @@ def internal_error(error):
 
 #### Exception Handlers
 
-```python
+````python
 class ValidationError(Exception):
     pass
 
 @app.errorhandler(ValidationError)
 def handle_validation_error(error):
     return {'error': str(error), 'type': 'validation_error'}, 400
-```
+
+#### Catch-All Handler
+
+Handle all otherwise unhandled exceptions:
+
+```python
+@app.errorhandler(Exception)
+def handle_exception(e):
+    # Pass through HTTP errors
+    if hasattr(e, "get_response"):
+        return e.get_response()
+
+    # Generic error for everything else
+    return {"error": "Something went wrong"}, 500
+````
+
+````
 
 ### Using `abort()`
 
@@ -1102,7 +1163,7 @@ def admin():
     if not is_admin():
         abort(403, 'Admin access required')
     return {'message': 'Admin panel'}
-```
+````
 
 ### Complete Error Handling Example
 
@@ -1546,11 +1607,11 @@ app.run(
 ```python
 import bustapi
 
-print(bustapi.__version__)           # '0.3.1'
-print(bustapi.get_version())         # '0.3.1'
+print(bustapi.__version__)           # '0.13.0'
+print(bustapi.get_version())         # '0.13.0'
 print(bustapi.get_debug_info())      # Detailed version info
 ```
 
 ---
 
-_This documentation covers BustAPI version 0.3.1. For the latest updates, visit the [official documentation](https://grandpaej.github.io/BustAPI/)._
+_This documentation covers BustAPI version 0.13.0. For the latest updates, visit the [official documentation](https://rustxpy.github.io/BustAPI/)._

{bustapi-0.12.0 → bustapi-0.13.1}/docs/examples-guide.md

@@ -12,6 +12,15 @@ The `examples/` directory in the repository contains many complete scripts demon
 - **03_async.py**: Using `async def` for non-blocking routes.
 - **04_request_data.py**: accessing query args and form data.
 
+## Security & Authentication
+
+Learn how to protect your application.
+
+- **17_jwt_auth.py**: Standard JWT authentication using the Authorization header.
+- **18_jwt_cookies.py**: Secure JWT implementation using HttpOnly cookies.
+- **11_security_demo.py**: Implementing security headers.
+- **10_rate_limit_demo.py**: Using the built-in rate limiter to prevent abuse.
+
 ## Data & Validation
 
 Learn how to robustly handle input.
@@ -27,8 +36,6 @@ For production-grade applications.
 
 - **06_blueprints.py**: Organizing your app into modules.
 - **14_middleware.py**: Custom request/response hooks.
-- **10_rate_limit_demo.py**: Using the built-in rate limiter to prevent abuse.
-- **11_security_demo.py**: Implementing security headers.
 
 ## Database & Templates
 

{bustapi-0.12.0 → bustapi-0.13.1}/docs/index.md

@@ -44,7 +44,8 @@ if __name__ == "__main__":
 - **Multiprocessing** - `workers=4` for parallel request handling on Linux
 - **JWT Authentication** - Built-in token-based auth
 - **Templates** - Jinja2 template rendering
-- **Blueprints** - Modular app organization
+-   **Blueprints** - Modular app organization
+-   **Auto-Documentation** - Instant OpenAPI/Swagger & ReDoc UI
 
 ---
 
@@ -79,3 +80,4 @@ Supports Python **3.10 - 3.14** on Linux, macOS, and Windows.
 - [Turbo Routes](user-guide/turbo-routes.md) - Maximum performance
 - [Multiprocessing](user-guide/multiprocessing.md) - Scale to 100k+ RPS
 - [JWT Auth](user-guide/jwt.md) - Secure your API
+- [Auto-Documentation](user-guide/documentation.md) - Swagger & ReDoc

{bustapi-0.12.0 → bustapi-0.13.1}/docs/quickstart.md

@@ -157,4 +157,8 @@ if __name__ == "__main__":
 
     Secure your API with tokens.
 
+-   [:material-book-open: **Auto-Docs**](user-guide/documentation.md)
+
+    Interactive Swagger & ReDoc UI.
+
 </div>

{bustapi-0.12.0 → bustapi-0.13.1}/docs/user-guide/authentication.md

@@ -2,6 +2,9 @@
 
 Flask-Login style session-based authentication for BustAPI.
 
+> [!TIP]
+> For stateless APIs or mobile backends, consider using [JWT Authentication](jwt.md) instead.
+
 ## Quick Start
 
 ```python