genro-asgi 0.2.0__py3-none-any.whl

genro_asgi/__init__.py

@@ -0,0 +1,150 @@
+# Copyright 2025 Softwell S.r.l.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""genro-asgi - Minimal ASGI framework with routing via genro-routes.
+
+Main components:
+    AsgiServer: ASGI entry point, loads config, mounts apps
+    AsgiApplication: Base class for mountable applications
+    Response: HTTP response with auto content-type detection
+    HttpRequest: HTTP request wrapper with headers, query, body
+
+Middleware:
+    AuthMiddleware: O(1) authentication (bearer, basic, JWT)
+    CORSMiddleware: Cross-Origin Resource Sharing headers
+    ErrorMiddleware: Exception handling and error responses
+
+Storage:
+    LocalStorage: Filesystem storage with mount system
+    ResourceLoader: Hierarchical resource loading with fallback
+
+Usage:
+    from genro_asgi import AsgiServer
+
+    server = AsgiServer(server_dir=".")
+    server.run()  # Starts uvicorn
+
+See config.yaml for configuration options.
+"""
+
+__version__ = "0.2.0"
+
+from .datastructures import (
+    Address,
+    Headers,
+    QueryParams,
+    State,
+    URL,
+    headers_from_scope,
+    query_params_from_scope,
+)
+from .exceptions import (
+    HTTPException,
+    HTTPForbidden,
+    HTTPNotFound,
+    HTTPUnauthorized,
+    Redirect,
+    WebSocketDisconnect,
+    WebSocketException,
+)
+from .lifespan import Lifespan, ServerLifespan
+from .request import (
+    BaseRequest,
+    HttpRequest,
+    MsgRequest,
+    RequestRegistry,
+    REQUEST_FACTORIES,
+)
+from .response import (
+    Response,
+    make_cookie,
+)
+from .types import ASGIApp, Message, Receive, Scope, Send
+from .utils import AsgiServerEnabler, ServerBinder
+from .executors import (
+    BaseExecutor,
+    ExecutorError,
+    ExecutorOverloadError,
+    ExecutorRegistry,
+    LocalExecutor,
+)
+from .server import AsgiServer, ServerConfig, Dispatcher
+from .context import AsgiContext
+from .applications import AsgiApplication, McpApplication
+from .routers import StaticRouter
+from .storage import LocalStorage, LocalStorageNode, StorageNode
+from .websocket import WebSocket, WebSocketState
+
+__all__ = [
+    # Request classes
+    "BaseRequest",
+    "HttpRequest",
+    "MsgRequest",
+    "RequestRegistry",
+    "REQUEST_FACTORIES",
+    # Response classes
+    "Response",
+    "Lifespan",
+    "ServerLifespan",
+    # Helper functions
+    "make_cookie",
+    # Data structures
+    "Address",
+    "URL",
+    "Headers",
+    "QueryParams",
+    "State",
+    "headers_from_scope",
+    "query_params_from_scope",
+    # Exceptions
+    "HTTPException",
+    "HTTPForbidden",
+    "HTTPNotFound",
+    "HTTPUnauthorized",
+    "Redirect",
+    "WebSocketException",
+    "WebSocketDisconnect",
+    # ASGI types
+    "ASGIApp",
+    "Message",
+    "Receive",
+    "Scope",
+    "Send",
+    # Server integration
+    "AsgiServer",
+    "ServerConfig",
+    "Dispatcher",
+    # Context
+    "AsgiContext",
+    # Applications
+    "AsgiApplication",
+    "McpApplication",
+    "ServerBinder",
+    "AsgiServerEnabler",
+    # Executors
+    "BaseExecutor",
+    "LocalExecutor",
+    "ExecutorRegistry",
+    "ExecutorError",
+    "ExecutorOverloadError",
+    # WebSocket
+    "WebSocket",
+    "WebSocketState",
+    # Routers
+    "StaticRouter",
+    # Storage
+    "LocalStorage",
+    "LocalStorageNode",
+    "StorageNode",
+]

genro_asgi/__main__.py

@@ -0,0 +1,99 @@
+# Copyright 2025 Softwell S.r.l.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+genro-asgi CLI entry point.
+
+Usage:
+    genro-asgi serve ./myapp              # Run server from app directory
+    genro-asgi serve ./myapp --port 9000  # Override port
+
+The directory must contain a config.yaml or genro-asgi.yaml file.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def cmd_serve(argv: list[str]) -> int:
+    """Run the ASGI server."""
+    from .server import AsgiServer
+
+    # Create server - passes argv for SmartOptions parsing
+    server = AsgiServer(argv=argv)
+
+    # Verify server_dir exists
+    server_dir = server.config.server["server_dir"]
+    if not server_dir.is_dir():
+        print(f"Error: '{server_dir}' is not a directory.", file=sys.stderr)
+        return 1
+
+    # Show startup info
+    print("genro-asgi starting...", flush=True)
+    print(f"Server dir: {server_dir}", flush=True)
+    print(f"Server: http://{server.config.server['host']}:{server.config.server['port']}", flush=True)
+    if server.config.server["reload"]:
+        print("Mode: development (auto-reload enabled)", flush=True)
+    print(flush=True)
+
+    # Run server
+    try:
+        server.run()
+    except KeyboardInterrupt:
+        print("\nShutdown.")
+
+    return 0
+
+
+def main() -> int:
+    """Main entry point."""
+    # Handle --version
+    if "--version" in sys.argv or "-v" in sys.argv:
+        from . import __version__
+
+        print(f"genro-asgi {__version__}")
+        return 0
+
+    # Handle --help
+    if "--help" in sys.argv or "-h" in sys.argv or len(sys.argv) == 1:
+        print("Usage: genro-asgi serve <app_dir> [options]")
+        print()
+        print("Arguments:")
+        print("  app_dir           Path to app directory")
+        print()
+        print("Options:")
+        print("  --config FILE     Config file (default: config.yaml)")
+        print("  --host HOST       Server host (default: 127.0.0.1)")
+        print("  --port PORT       Server port (default: 8000)")
+        print("  --reload          Enable auto-reload")
+        print("  --version, -v     Show version")
+        print("  --help, -h        Show this help")
+        return 0
+
+    # Extract subcommand
+    if len(sys.argv) < 2:
+        print("Error: missing subcommand", file=sys.stderr)
+        return 1
+
+    subcommand = sys.argv[1]
+    if subcommand != "serve":
+        print(f"Error: unknown subcommand '{subcommand}'", file=sys.stderr)
+        return 1
+
+    return cmd_serve(sys.argv[2:])
+
+
+if __name__ == "__main__":
+    sys.exit(main())

genro_asgi/applications/__init__.py

@@ -0,0 +1,9 @@
+# Copyright 2025 Softwell S.r.l.
+# Licensed under the Apache License, Version 2.0
+
+"""Application classes for genro-asgi."""
+
+from .asgi_application import AsgiApplication
+from .mcp_application import McpApplication
+
+__all__ = ["AsgiApplication", "McpApplication"]

genro_asgi/applications/asgi_application.py

@@ -0,0 +1,146 @@
+# Copyright 2025 Softwell S.r.l.
+# Licensed under the Apache License, Version 2.0
+
+"""AsgiApplication - Base class for ASGI applications."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, ClassVar
+
+from genro_routes import Router, RoutingClass, route  # type: ignore[import-untyped]
+
+if TYPE_CHECKING:
+    from ..server import AsgiServer
+
+__all__ = ["AsgiApplication"]
+
+
+class AsgiApplication(RoutingClass):
+    """Base class for apps mounted on AsgiServer.
+
+    Provides default `main` router and `index()` method. Subclasses define
+    `openapi_info` for metadata and add routes with @route() decorator.
+
+    Example::
+
+        class MyApp(AsgiApplication):
+            openapi_info = {"title": "My API", "version": "1.0.0"}
+
+            @route()  # Uses the only router (self.main) automatically
+            def hello(self):
+                return "Hello!"
+
+            def __init__(self, **kwargs):
+                super().__init__(**kwargs)  # Required: creates self.main
+                self.backoffice = Router(self, name="backoffice")
+
+            @route("backoffice")  # Must specify when multiple routers
+            def admin(self):
+                return "Admin panel"
+    """
+
+    openapi_info: ClassVar[dict[str, Any]] = {}
+
+    def __init__(self, **kwargs: Any) -> None:
+        """Initialize app with default main router."""
+        self.base_dir = kwargs.pop("base_dir", None)
+        self.main = Router(self, name="main")
+        self.on_init(**kwargs)
+
+    def on_init(self, **kwargs: Any) -> None:
+        """Called after base initialization. Override for custom setup.
+
+        Args:
+            **kwargs: Parameters from config.yaml app definition.
+        """
+        pass
+
+    @property
+    def server(self) -> AsgiServer | None:
+        """Return the server that mounted this app (semantic alias for _routing_parent)."""
+        return getattr(self, "_routing_parent", None)
+
+    def on_startup(self) -> None:
+        """Called when server starts. Override for custom initialization.
+
+        Can be sync or async. Called after all apps are mounted.
+        """
+        pass
+
+    def on_shutdown(self) -> None:
+        """Called when server stops. Override for custom cleanup.
+
+        Can be sync or async. Called in reverse order of startup.
+        """
+        pass
+
+    @property
+    def resources_dir(self) -> Path | None:
+        """Return path to app's resources directory.
+
+        Works both when mounted on server and standalone.
+        """
+        if self.base_dir:
+            return Path(self.base_dir) / "resources"
+        return None
+
+    def load_resource(self, *args: str, name: str) -> tuple[bytes, str] | None:
+        """Load resource file content with mime type.
+
+        When mounted on server: uses server's ResourceLoader with fallback to local.
+        Standalone: reads directly from resources_dir.
+
+        Returns:
+            Tuple of (content_bytes, mime_type) or None if not found.
+        """
+        if self.server:
+            mount_name = getattr(self, "_mount_name", "")
+            result = self.server.resource_loader.load(mount_name, *args, name=name)
+            if result:
+                return result
+            # Fallback to local resources_dir (for sys_apps under _sys/)
+
+        # Local mode: read from resources_dir
+        if not self.resources_dir:
+            return None
+        resource_path = self.resources_dir / "/".join(args) / name if args else self.resources_dir / name
+        if resource_path.exists():
+            # Simple mime type detection
+            suffix = resource_path.suffix.lower()
+            mime_types = {
+                ".html": "text/html",
+                ".css": "text/css",
+                ".js": "application/javascript",
+                ".json": "application/json",
+                ".txt": "text/plain",
+            }
+            mime_type = mime_types.get(suffix, "application/octet-stream")
+            return resource_path.read_bytes(), mime_type
+        return None
+
+    @route(meta_mime_type="text/html")
+    def index(self) -> str:
+        """Return HTML splash page. Override for custom index."""
+        info = getattr(self, "openapi_info", {})
+        title = info.get("title", self.__class__.__name__)
+        version = info.get("version", "")
+        description = info.get("description", "")
+
+        version_html = f"<p>Version: {version}</p>" if version else ""
+        desc_html = f"<p>{description}</p>" if description else ""
+
+        return f"""<!DOCTYPE html>
+<html>
+<head><title>{title}</title>
+<style>
+body {{ font-family: system-ui, sans-serif; max-width: 600px; margin: 50px auto; padding: 20px; }}
+h1 {{ color: #333; }}
+</style>
+</head>
+<body>
+<h1>{title}</h1>
+{version_html}
+{desc_html}
+</body>
+</html>"""