django-bolt 0.2.3__cp310-abi3-win_amd64.whl → 0.2.4__cp310-abi3-win_amd64.whl

django_bolt/__init__.py

@@ -1,6 +1,7 @@
 from .api import BoltAPI
 from .responses import Response, JSON, StreamingResponse
 from .compression import CompressionConfig
+from .types import Request
 
 # Views module
 from .views import (
@@ -80,6 +81,7 @@ from .openapi import (
 
 __all__ = [
     "BoltAPI",
+    "Request",
     "Response",
     "JSON",
     "StreamingResponse",

django_bolt/api.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import inspect
 import msgspec
 import re
@@ -23,8 +25,8 @@ from .request_parsing import parse_form_data
 from .dependencies import resolve_dependency
 from .serialization import serialize_response
 from .middleware.compiler import compile_middleware_meta
+from .types import Request
 
-Request = Dict[str, Any]
 Response = Tuple[int, List[Tuple[str, str]], bytes]
 
 # Global registry for BoltAPI instances (used by autodiscovery)

django_bolt/auth/jwt_utils.py

@@ -4,10 +4,13 @@ JWT utility functions for Django-Bolt.
 Provides helper functions to create JWT tokens for Django users and
 extract user information from request context.
 """
+from __future__ import annotations
+
 import time
 import jwt
 from typing import Any, Dict, Optional
 from django.contrib.auth import get_user_model
+from django_bolt.types import Request
 
 
 def create_jwt_for_user(
@@ -95,7 +98,7 @@ def create_jwt_for_user(
     return jwt.encode(payload, secret, algorithm=algorithm)
 
 
-async def get_current_user(request: Dict[str, Any]):
+async def get_current_user(request: Request):
     """
     Dependency function to extract and fetch Django User from request context.
 
@@ -147,7 +150,7 @@ async def get_current_user(request: Dict[str, Any]):
         return None
 
 
-def extract_user_id_from_context(request: Dict[str, Any]) -> Optional[str]:
+def extract_user_id_from_context(request: Request) -> Optional[str]:
     """
     Extract user_id from request context.
 
@@ -173,7 +176,7 @@ def extract_user_id_from_context(request: Dict[str, Any]) -> Optional[str]:
     return context.get("user_id")
 
 
-def get_auth_context(request: Dict[str, Any]) -> Dict[str, Any]:
+def get_auth_context(request: Request) -> Dict[str, Any]:
     """
     Get the full authentication context from request.
 

django_bolt/dependencies.py

@@ -1,11 +1,11 @@
 """Dependency injection utilities."""
+from __future__ import annotations
+
 import inspect
-from typing import Any, Callable, Dict, List, TYPE_CHECKING
+from typing import Any, Callable, Dict, List
 from .params import Depends as DependsMarker
 from .binding import convert_primitive
-
-if TYPE_CHECKING:
-    from .typing import FieldDefinition
+from .typing import FieldDefinition
 
 
 async def resolve_dependency(

django_bolt/management/commands/runbolt.py

@@ -50,9 +50,6 @@ class Command(BaseCommand):
                 )
                 options['processes'] = 1
 
-            self.stdout.write(
-                self.style.SUCCESS("[django-bolt] 🔥 Development mode enabled (auto-reload on file changes)")
-            )
             self.run_with_autoreload(options)
         else:
             # Production mode (current logic)
@@ -75,11 +72,18 @@ class Command(BaseCommand):
             import sys
             sys.exit(1)
 
+        # Print dev mode message only once (in the main reloader process)
+        import os
+        if os.environ.get('RUN_MAIN') == 'true':
+            self.stdout.write(
+                self.style.SUCCESS("[django-bolt] 🔥 Development mode enabled (auto-reload on file changes)")
+            )
+
         # Use Django's autoreload system which is optimized
         # It only restarts the Python interpreter when necessary
         # and reuses the same process for faster reloads
         def run_server():
-            self.start_single_process(options)
+            self.start_single_process(options, dev_mode=True)
 
         autoreload.run_with_reloader(run_server)
 
@@ -133,7 +137,7 @@ class Command(BaseCommand):
         except KeyboardInterrupt:
             pass
     
-    def start_single_process(self, options, process_id=None):
+    def start_single_process(self, options, process_id=None, dev_mode=False):
         """Start a single process server"""
         # Setup Django logging once at server startup (one-shot, respects existing LOGGING)
         from django_bolt.logging.config import setup_django_logging
@@ -178,9 +182,9 @@ class Command(BaseCommand):
             merged_api._register_openapi_routes()
 
             if process_id is not None:
-                self.stdout.write(f"[django-bolt] Process {process_id}: OpenAPI docs enabled at {openapi_config.path}")
+                self.stdout.write(f"[django-bolt] Process {process_id}: OpenAPI docs enabled at http://{options['host']}:{options['port']}{openapi_config.path}")
             else:
-                self.stdout.write(self.style.SUCCESS(f"[django-bolt] OpenAPI docs enabled at {openapi_config.path}"))
+                self.stdout.write(self.style.SUCCESS(f"[django-bolt] OpenAPI docs enabled at http://{options['host']}:{options['port']}{openapi_config.path}"))
 
         # Register Django admin routes if not disabled
         # Admin is controlled solely by --no-admin command-line flag
@@ -242,7 +246,6 @@ class Command(BaseCommand):
         else:
             self.stdout.write(self.style.SUCCESS(f"[django-bolt] Starting server on http://{options['host']}:{options['port']}"))
             self.stdout.write(f"[django-bolt] Workers: {options['workers']}, Processes: {options['processes']}")
-            self.stdout.write(self.style.SUCCESS(f"[django-bolt] OpenAPI docs enabled at http://{options['host']}:{options['port']}/docs/"))
         # Set environment variable for Rust to read worker count
         import os
         os.environ['DJANGO_BOLT_WORKERS'] = str(options['workers'])

django_bolt/types.py

@@ -0,0 +1,249 @@
+"""
+Type definitions for Django-Bolt.
+
+This module provides type hints and protocols for Django-Bolt objects,
+enabling full IDE autocomplete and static type checking.
+"""
+from __future__ import annotations
+
+from typing import Protocol, Any, Dict, Optional, overload, runtime_checkable
+
+
+@runtime_checkable
+class Request(Protocol):
+    """
+    Django-Bolt request object (Rust-backed PyRequest).
+
+    Provides dict-like access to HTTP request data with full type safety.
+    This is a Protocol that matches the Rust PyRequest implementation,
+    enabling proper type hints and IDE autocomplete.
+
+    Example:
+        ```python
+        from django_bolt import BoltAPI, Request
+        import msgspec
+
+        class UserCreate(msgspec.Struct):
+            name: str
+            email: str
+
+        api = BoltAPI()
+
+        # With request object and validated body
+        @api.post("/users")
+        async def create_user(request: Request, user: UserCreate):
+            # Type-safe access to request data
+            method = request.method          # str
+            auth = request.get("auth")       # Optional[Dict[str, Any]]
+            headers = request["headers"]     # Dict[str, str]
+
+            # Validated body with full type safety
+            name = user.name                 # str
+            email = user.email               # str
+
+            return {"id": 1, "name": name}
+
+        # With just request object
+        @api.get("/users/{user_id}")
+        async def get_user(request: Request, user_id: int):
+            auth = request.get("auth", {})
+            user_id = auth.get("user_id")
+            return {"user_id": user_id}
+        ```
+
+    Available Keys (for .get() and [] access):
+        - "method": HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
+        - "path": Request path (/users/123)
+        - "body": Raw request body (bytes)
+        - "params": Path parameters from URL pattern (Dict[str, str])
+        - "query": Query string parameters (Dict[str, str])
+        - "headers": HTTP headers (Dict[str, str])
+        - "cookies": Parsed cookies (Dict[str, str])
+        - "auth": Authentication context (Optional[Dict[str, Any]])
+        - "context": Same as "auth" (alias)
+
+    Auth Context Structure (when authentication is present):
+        ```python
+        {
+            "user_id": "123",                # User identifier (str)
+            "is_staff": False,               # Staff status (bool)
+            "is_admin": False,               # Admin/superuser status (bool)
+            "auth_backend": "jwt",           # Backend used: jwt, api_key, etc.
+            "permissions": ["read", "write"], # User permissions (List[str], optional)
+            "auth_claims": {                 # Full JWT claims (optional, JWT only)
+                "sub": "123",
+                "exp": 1234567890,
+                "iat": 1234567800,
+                # ... additional claims
+            }
+        }
+        ```
+    """
+
+    # Properties (from Rust #[getter])
+    @property
+    def method(self) -> str:
+        """
+        HTTP method.
+
+        Returns:
+            HTTP method string: "GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"
+
+        Example:
+            ```python
+            if request.method == "POST":
+                # Handle POST request
+                pass
+            ```
+        """
+        ...
+
+    @property
+    def path(self) -> str:
+        """
+        Request path.
+
+        Returns:
+            Request path string (e.g., "/users/123")
+
+        Example:
+            ```python
+            path = request.path  # "/api/users/123"
+            ```
+        """
+        ...
+
+    @property
+    def body(self) -> bytes:
+        """
+        Raw request body.
+
+        Returns:
+            Request body as bytes
+
+        Note:
+            For JSON requests, the framework automatically decodes this
+            when you use msgspec.Struct parameter types. You typically
+            don't need to access this directly.
+
+        Example:
+            ```python
+            raw_body = request.body
+            # b'{"name": "John", "email": "john@example.com"}'
+            ```
+        """
+        ...
+
+    @property
+    def context(self) -> Optional[Dict[str, Any]]:
+        """
+        Authentication/middleware context.
+
+        Returns:
+            Context dictionary when authentication is present, None otherwise.
+
+            When present, contains:
+            - user_id (str): User identifier
+            - is_staff (bool): Staff status
+            - is_admin (bool): Admin/superuser status
+            - auth_backend (str): Backend used (jwt, api_key, etc.)
+            - permissions (List[str]): User permissions (if available)
+            - auth_claims (Dict): Full JWT claims (if JWT authentication)
+
+        Example:
+            ```python
+            ctx = request.context
+            if ctx:
+                user_id = ctx.get("user_id")
+                is_admin = ctx.get("is_admin", False)
+            ```
+        """
+        ...
+
+    # Methods
+    @overload
+    def get(self, key: str) -> Any:
+        """Get request attribute (returns None if not found)."""
+        ...
+
+    @overload
+    def get(self, key: str, default: Any) -> Any:
+        """Get request attribute with default value."""
+        ...
+
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        Get request attribute with optional default value.
+
+        This method provides dict-like .get() access to request data,
+        with support for default values when keys don't exist.
+
+        Args:
+            key: Attribute name to retrieve. Available keys:
+                - "method": HTTP method (str)
+                - "path": Request path (str)
+                - "body": Raw body (bytes)
+                - "params": Path parameters (Dict[str, str])
+                - "query": Query parameters (Dict[str, str])
+                - "headers": HTTP headers (Dict[str, str])
+                - "cookies": Parsed cookies (Dict[str, str])
+                - "auth": Auth context (Optional[Dict[str, Any]])
+                - "context": Same as "auth"
+            default: Default value to return if key doesn't exist or is None.
+                     Defaults to None.
+
+        Returns:
+            Attribute value if present, otherwise default value.
+
+        Special Behavior:
+            For "auth" and "context" keys, if authentication is not configured
+            or no credentials provided, returns the default value (not an empty dict).
+
+        Example:
+            ```python
+            # Get with None as default
+            auth = request.get("auth")  # None if no auth
+
+            # Get with custom default
+            auth = request.get("auth", {})  # {} if no auth
+
+            # Get method (always present)
+            method = request.get("method")  # "GET", "POST", etc.
+
+            # Get query params
+            query = request.get("query", {})
+            page = query.get("page", "1")
+            ```
+        """
+        ...
+
+    def __getitem__(self, key: str) -> Any:
+        """
+        Dict-style access to request attributes.
+
+        Args:
+            key: Attribute name (same keys as .get())
+
+        Returns:
+            Attribute value
+
+        Raises:
+            KeyError: If key doesn't exist
+
+        Example:
+            ```python
+            method = request["method"]      # "GET"
+            headers = request["headers"]    # Dict[str, str]
+            params = request["params"]      # Dict[str, str]
+
+            # Raises KeyError if no auth
+            context = request["context"]
+
+            # Safe alternative with .get()
+            context = request.get("context", {})
+            ```
+        """
+        ...
+
+
+__all__ = ["Request"]

{django_bolt-0.2.3.dist-info → django_bolt-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: django-bolt
-Version: 0.2.3
+Version: 0.2.4
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -536,11 +536,11 @@ async def stream_json():
 
 ```bash
 # Clone repository
-git clone https://github.com/yourusername/django-bolt.git
+git clone https://github.com/FarhanAliRaza/django-bolt.git
 cd django-bolt
 
 # Install dependencies
-pip install -r requirements-dev.txt
+uv sync
 
 # Build Rust extension
 make build  # or: maturin develop --release

{django_bolt-0.2.3.dist-info → django_bolt-0.2.4.dist-info}/RECORD

@@ -1,8 +1,8 @@
-django_bolt-0.2.3.dist-info/METADATA,sha256=xrjcnw-AiqNcaJNTR9zjgP4cc26YTXJQhANvRaa-EkY,22007
-django_bolt-0.2.3.dist-info/WHEEL,sha256=4EDp_7DiFfWl1yYv5M4wSosAn5L_xgD1dyrQxQxfCx8,95
-django_bolt-0.2.3.dist-info/entry_points.txt,sha256=cUEGAdiOY6BryNhsgOS_50AONPPHajI3yvhqr56ZiaU,51
-django_bolt/__init__.py,sha256=fhXQUJR5SO-GwhF_2N9w0UK6rIFx7kWGfpOPyIKvB9Q,3139
-django_bolt/_core.pyd,sha256=D_Mam9MZpy5OxV3_xC61vdndqwH4AqIr0hNFfE-zXg4,8941568
+django_bolt-0.2.4.dist-info/METADATA,sha256=WcTs8UntAqUHJrapMRCiNUgbtB646anFRRvaGl-JMrE,21980
+django_bolt-0.2.4.dist-info/WHEEL,sha256=4EDp_7DiFfWl1yYv5M4wSosAn5L_xgD1dyrQxQxfCx8,95
+django_bolt-0.2.4.dist-info/entry_points.txt,sha256=cUEGAdiOY6BryNhsgOS_50AONPPHajI3yvhqr56ZiaU,51
+django_bolt/__init__.py,sha256=BerkkdUuHfxTJUKTFoXxfjYr6OFCb3MH88NIBEjphm4,3183
+django_bolt/_core.pyd,sha256=XMyXq12lOXHu6fKlJKSMmjm8ITa0ytvn3buTj3uDXHE,8955392
 django_bolt/_json.py,sha256=oGxi29DHB8UYvbqjtqtrP6gThk7Qonlw333c4_cTr6s,4917
 django_bolt/admin/__init__.py,sha256=BNN1afSvWvt-377rNzZLdNDEvKyMZXkmB_0MhTxAN8k,601
 django_bolt/admin/admin_detection.py,sha256=1yQkLx9rF5DLMjJqbx8n4c82UgS9JEAnUcPdRfFqAXk,5825
@@ -10,13 +10,13 @@ django_bolt/admin/asgi_bridge.py,sha256=oJrOqbBi8w-OUZD_wvpa5FlRFGIOyRvV284z8OS1
 django_bolt/admin/routes.py,sha256=dGrSz6fOwofLuBpNpzyqtcLuGbd4AgSQ2jZub_3cz1Y,3235
 django_bolt/admin/static.py,sha256=eXeOs2VWnxKdLDKarI4eD2q92K9R3JJHW1XQYmAsVDA,4692
 django_bolt/admin/static_routes.py,sha256=sdpuCPhULMr5LccVxfbU2XSfpmL8oP7DCXqUpy0cnNY,3512
-django_bolt/api.py,sha256=1wJOg4-fuDzhG9ovHXjA6ONqlEFEvfrjx97xpja4oBU,49386
+django_bolt/api.py,sha256=wR2sqaWtQIspyRfnVpCKbOSQO0Ee4FRuIKFqj2E1tas,49426
 django_bolt/apps.py,sha256=OKBK6McSzRZ8zGQaId5iw239QbIgqs8tIbAqpuYxmn0,193
 django_bolt/async_collector.py,sha256=m1U6wjE9wheVMuql8aooR47tkLz_RlADgkIl2p9H6Uw,7749
 django_bolt/auth/__init__.py,sha256=ygi_SCzH1CNOcQwDe0ZKIe072xBa7zeKVUtUoG0_dwY,1968
 django_bolt/auth/backends.py,sha256=T02zfiC17GZrARKlqzKSnkMOtEcYQDTmS4PouRvsNOU,7944
 django_bolt/auth/guards.py,sha256=Dwbqhq4_I41BoN0eWrQ7Ad9mmr9zgCoPAg4C3GElTio,6591
-django_bolt/auth/jwt_utils.py,sha256=phLKyXQXrqL8TLLZVA-reitOVylSTJ9FKSBETa1_OCg,6518
+django_bolt/auth/jwt_utils.py,sha256=8Wprx4tbtXvNDNQWp2eQepG0n4sYPdF2uX8xCmBgSzg,6574
 django_bolt/auth/revocation.py,sha256=YzzKALZwawV8jLk8TV00CrbQ61rDxWy8YElcexhtn8s,8674
 django_bolt/auth/token.py,sha256=LAkjupXcQDLY8IoTrS9TrSDitK8Pfjef-zb3zUZT-i4,11449
 django_bolt/binding.py,sha256=UtmwW55RKyBwNxbX5QQ74NF0EF5k5zaMGa5el7mgljg,12860
@@ -24,7 +24,7 @@ django_bolt/bootstrap.py,sha256=zXkVhcDZxluQBWXc_UHK0FfgOfpdgxCg01DmSbSdXos,3007
 django_bolt/cli.py,sha256=0TBGM37cCqKEew_QA26ru7KkR8_6mP5wKXgFhr8GWng,4647
 django_bolt/compression.py,sha256=8ioDa2j0TG_mna-Jh34-e6WjCeY0GSKwRPHMn8en8OQ,4025
 django_bolt/decorators.py,sha256=hvfIZMxZI3S4eo6KYiOiEC-1Z96fSwQxQopLB4jmez0,6656
-django_bolt/dependencies.py,sha256=D_D9onQLMH85q0o4tSeKo0nTiJmx_Hifg3AwwcTfRUM,4443
+django_bolt/dependencies.py,sha256=mX19F2X5nbZ5Rzq9GbdeNBuX7EufftQljuHQlCeqpw0,4441
 django_bolt/error_handlers.py,sha256=uD9_9vnub8FxZCRXgcqOdMic5M8cFD-sPXePdSl9IaY,10032
 django_bolt/exceptions.py,sha256=iYTkmtel7VlpjwuOrijDgt8fsx8_Kd0gezLEdR6CrDs,8823
 django_bolt/health.py,sha256=MBcXlgkTAdEiAvmGRPSgn9iePhH-rcHXan7Ge1EaPog,3356
@@ -33,7 +33,7 @@ django_bolt/logging/config.py,sha256=SE_7yvYzPVdgvMUAK9yU3Dyn2HJY_EVkajm0aAhgcNw
 django_bolt/logging/middleware.py,sha256=_tkVN8cN8BloLv7Ebk-2RKBFkH4ooOTNs_dAxXSa0yU,10057
 django_bolt/management/__init__.py,sha256=f0hFqUIOIxXbeDzGL06KrZqWGSsIGVSVVh3EemtatMY,38
 django_bolt/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-django_bolt/management/commands/runbolt.py,sha256=mNqIkSSvq5V6OGcNU9AFwitqie4dSRk_UiBlFTAnPYw,17847
+django_bolt/management/commands/runbolt.py,sha256=DWNDq3cnNz-ulLwyY5xkm6ZQuGWB7xbDLhhobIHyJS4,17966
 django_bolt/middleware/__init__.py,sha256=C6e6vdSLqe4brMrKR4TueroD4f_OPsnoZZDlxkbyjbw,608
 django_bolt/middleware/compiler.py,sha256=Knxh3XouU70ymIskDB-JWn1TcHSMPQvUBXtTPHEJJRY,4766
 django_bolt/middleware/middleware.py,sha256=Qdr16OM15oOS1OYNnxFY3hJ0un9E8VaVwht-A8Qcuws,8113
@@ -86,6 +86,7 @@ django_bolt/status_codes.py,sha256=jTZ32kPwj3tC23jh6uC1Ci1P9EKttywsvyWINQIEwGg,9
 django_bolt/testing/__init__.py,sha256=TgJjct2WucKL7HyrbMuQfplNptlCPhu4CL-WQZxaoRY,216
 django_bolt/testing/client.py,sha256=Yx7N1lfXmJcH4yF--6K0YehtPY2_wiwb8U3a0qQoqDE,8616
 django_bolt/testing/helpers.py,sha256=hq2HD1IEwHuW8tMgZO9ZW6BFdcE_JQXaV8sZc58LBDc,1472
+django_bolt/types.py,sha256=sk8huP2mArTr5A7FmTVmIke5z0oR-SW0OmzzRfrRlxQ,7982
 django_bolt/typing.py,sha256=sGlFUUXY8EJbYWCgARgNGLZPu7SaxxohZaSx1SRLYaE,8686
 django_bolt/views.py,sha256=KewSpL6g-zZxXnEkwun6hueX3S_Eji-d2dawzoqe-GM,41715
-django_bolt-0.2.3.dist-info/RECORD,,
+django_bolt-0.2.4.dist-info/RECORD,,