aquilia 0.2.0__tar.gz

aquilia-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aquilia Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aquilia-0.2.0/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: aquilia
+Version: 0.2.0
+Summary: Async-native Python web framework with flow-first routing
+Home-page: https://github.com/yourusername/aquilia
+Author: Aquilia Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/aquilia
+Project-URL: Documentation, https://github.com/yourusername/aquilia/docs
+Project-URL: Repository, https://github.com/yourusername/aquilia
+Project-URL: Issues, https://github.com/yourusername/aquilia/issues
+Keywords: web,framework,async,asgi,http,api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uvicorn>=0.30.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: argon2-cffi>=23.1.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: aiosqlite>=0.19.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: httpx>=0.24.0; extra == "dev"
+Requires-Dist: aiosqlite>=0.19.0; extra == "dev"
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python

aquilia-0.2.0/aquilia/__init__.py

@@ -0,0 +1,604 @@
+"""
+Aquilia - Production-ready async Python web framework
+
+Complete integration of:
+- Aquilary: Manifest-driven app registry with dependency resolution
+- Flow: Typed flow-first routing with composable pipelines
+- DI: Scoped dependency injection with lifecycle management
+- Sessions: Cryptographic session management with policies
+- Auth: OAuth2/OIDC, MFA, RBAC/ABAC authorization
+- Faults: Structured error handling with fault domains
+- Middleware: Composable middleware with effect awareness
+- Patterns: Auto-fix, retry, circuit breaker patterns
+
+Everything deeply integrated for seamless developer experience.
+"""
+
+__version__ = "0.2.0"
+
+# ============================================================================
+# Core Framework
+# ============================================================================
+
+from .manifest import AppManifest, DatabaseConfig
+from .config import Config, ConfigLoader
+from .config_builders import Workspace, Module, Integration
+from .request import Request
+from .response import Response
+from .server import AquiliaServer
+
+# Request data structures
+from ._datastructures import (
+    MultiDict,
+    Headers,
+    URL,
+    ParsedContentType,
+    Range,
+)
+
+# Upload handling
+from ._uploads import (
+    UploadFile,
+    FormData,
+    UploadStore,
+    LocalUploadStore,
+)
+
+# ============================================================================
+# Aquilary Registry (Replaces Legacy Registry)
+# ============================================================================
+
+from .aquilary import (
+    Aquilary,
+    AquilaryRegistry,
+    RuntimeRegistry,
+    AppContext,
+    RegistryMode,
+    RegistryFingerprint,
+    RegistryError,
+    DependencyCycleError,
+    RouteConflictError,
+    ManifestValidationError,
+)
+
+# ============================================================================
+# Controller System (NEW - First-class controllers)
+# ============================================================================
+
+from .controller import (
+    Controller,
+    RequestCtx,
+    GET, POST, PUT, PATCH, DELETE,
+    HEAD, OPTIONS, WS,
+    route,
+    ControllerMetadata,
+    RouteMetadata,
+    ParameterMetadata,
+    extract_controller_metadata,
+    ControllerFactory,
+    InstantiationMode,
+)
+
+# ============================================================================
+# Engine
+# ============================================================================
+
+# Note: RequestCtx is imported from .controller above; do not re-import
+# from .engine to avoid shadowing.
+
+# ============================================================================
+# DI System (Complete)
+# ============================================================================
+
+from .di import (
+    Container,
+    Registry as DIRegistry,
+    Provider,
+    ProviderMeta,
+    ClassProvider,
+    FactoryProvider,
+    ValueProvider,
+    service,
+    factory,
+    inject,
+    Inject,
+)
+
+# ============================================================================
+# Sessions System
+# ============================================================================
+
+from .sessions import (
+    Session,
+    SessionID,
+    SessionPolicy,
+    SessionEngine,
+    SessionPrincipal,
+    MemoryStore as SessionMemoryStore,
+    CookieTransport,
+    SessionFault,
+    SessionExpiredFault,
+)
+
+# Session decorators and state (NEW - Unique Aquilia syntax)
+from .sessions.decorators import (
+    session,
+    authenticated,
+    stateful,
+    SessionRequiredFault,
+    AuthenticationRequiredFault,
+)
+
+from .sessions.state import (
+    SessionState,
+    Field as SessionField,
+    CartState,
+    UserPreferencesState,
+)
+
+# Enhanced session features (NEW - Advanced patterns)
+from .sessions.enhanced import (
+    SessionContext,
+    SessionGuard,
+    requires,
+    AdminGuard,
+    VerifiedEmailGuard,
+)
+
+# ============================================================================
+# Auth System (Complete Integration)
+# ============================================================================
+
+from .auth.core import (
+    Identity,
+    IdentityStatus,
+    TokenClaims,
+)
+
+from .auth.manager import AuthManager
+from .auth.tokens import TokenManager, KeyRing
+from .auth.hashing import PasswordHasher
+from .auth.authz import AuthzEngine, RBACEngine, ABACEngine
+
+# Auth Integration
+from .auth.integration.aquila_sessions import (
+    AuthPrincipal,
+    SessionAuthBridge,
+    bind_identity,
+    user_session_policy,
+    api_session_policy,
+)
+
+from .auth.integration.di_providers import (
+    register_auth_providers,
+    create_auth_container,
+    AuthConfig,
+)
+
+from .auth.integration.middleware import (
+    AquilAuthMiddleware,
+    create_auth_middleware_stack,
+)
+
+# Note: Flow guards removed - use controller-based auth with middleware
+# from .auth.integration.flow_guards import (
+#     require_auth,
+#     require_scopes,
+#     require_roles,
+# )
+
+# ============================================================================
+# Faults System
+# ============================================================================
+
+from .faults import (
+    Fault,
+    FaultContext,
+    FaultEngine,
+    FaultHandler,
+    RecoveryStrategy,
+    # Model faults
+    ModelFault,
+    AMDLParseFault,
+    ModelNotFoundFault,
+    ModelRegistrationFault,
+    MigrationFault,
+    MigrationConflictFault,
+    QueryFault,
+    DatabaseConnectionFault,
+    SchemaFault,
+)
+
+# ============================================================================
+# Middleware System
+# ============================================================================
+
+from .middleware import (
+    Middleware,
+    Handler,
+    MiddlewareStack,
+    RequestIdMiddleware,
+    LoggingMiddleware,
+)
+
+# ============================================================================
+# Debug Pages
+# ============================================================================
+
+from .debug import (
+    DebugPageRenderer,
+    render_debug_exception_page,
+    render_http_error_page,
+    render_welcome_page,
+)
+
+# ============================================================================
+# Effects & Patterns
+# ============================================================================
+
+from .effects import Effect, EffectProvider, EffectRegistry
+
+# ============================================================================
+# Sockets (WebSockets)
+# ============================================================================
+
+from .sockets import (
+    SocketController,
+    Socket,
+    OnConnect,
+    OnDisconnect,
+    Event,
+    AquilaSockets,
+    SocketRouter,
+    SocketGuard,
+)
+
+# ============================================================================
+# Templates
+# ============================================================================
+
+from .templates import (
+    TemplateEngine,
+    TemplateMiddleware,
+)
+
+# ============================================================================
+# Patterns
+# ============================================================================
+
+from .patterns import (
+    PatternCompiler,
+    PatternMatcher,
+    CompiledPattern,
+    TypeRegistry as PatternTypeRegistry,
+)
+
+# ============================================================================
+# Discovery
+# ============================================================================
+
+from .discovery import PackageScanner
+
+# ============================================================================
+# Lifecycle
+# ============================================================================
+
+from .lifecycle import (
+    LifecycleCoordinator,
+    LifecyclePhase,
+    LifecycleError,
+)
+
+# ============================================================================
+# Model System (Pure Python ORM)
+# ============================================================================
+
+from .models import (
+    # New pure-Python model system
+    Model,
+    ModelMeta,
+    ModelRegistry,
+    Q,
+    # Fields
+    Field,
+    FieldValidationError,
+    Index,
+    UniqueConstraint,
+    AutoField,
+    BigAutoField,
+    IntegerField,
+    BigIntegerField,
+    SmallIntegerField,
+    PositiveIntegerField,
+    PositiveSmallIntegerField,
+    FloatField,
+    DecimalField,
+    CharField,
+    TextField,
+    SlugField,
+    EmailField,
+    URLField,
+    UUIDField,
+    FilePathField,
+    DateField,
+    TimeField,
+    DateTimeField,
+    DurationField,
+    BooleanField,
+    BinaryField,
+    JSONField,
+    ForeignKey,
+    OneToOneField,
+    ManyToManyField,
+    GenericIPAddressField,
+    FileField,
+    ImageField,
+    ArrayField,
+    HStoreField,
+    GeneratedField,
+    # Legacy AMDL (backward compat)
+    ModelNode,
+    SlotNode,
+    LinkNode,
+    IndexNode as LegacyIndexNode,
+    HookNode,
+    MetaNode,
+    NoteNode,
+    AMDLFile,
+    FieldType,
+    LinkKind,
+    parse_amdl,
+    parse_amdl_file,
+    parse_amdl_directory,
+    AMDLParseError,
+    ModelProxy,
+    # Migrations
+    MigrationRunner,
+    MigrationOps,
+    generate_migration_file,
+)
+
+from .db import (
+    AquiliaDatabase,
+    configure_database,
+    get_database,
+    set_database,
+    DatabaseError,
+)
+
+# ============================================================================
+# Exports
+# ============================================================================
+
+__all__ = [
+    # Core
+    "AquiliaServer",
+    "AppManifest",
+    "DatabaseConfig",
+    "Config",
+    "ConfigLoader",
+    "Request",
+    "Response",
+    
+    # Request data structures
+    "MultiDict",
+    "Headers",
+    "URL",
+    "ParsedContentType",
+    "Range",
+    
+    # Upload handling
+    "UploadFile",
+    "FormData",
+    "UploadStore",
+    "LocalUploadStore",
+    
+    # Aquilary
+    "Aquilary",
+    "AquilaryRegistry",
+    "RuntimeRegistry",
+    "AppContext",
+    "RegistryMode",
+    
+    # Controller (NEW - First-class)
+    "Controller",
+    "RequestCtx",
+    "GET", "POST", "PUT", "PATCH", "DELETE",
+    "HEAD", "OPTIONS", "WS",
+    "route",
+    "ControllerMetadata",
+    "extract_controller_metadata",
+    "ControllerFactory",
+    "InstantiationMode",
+    
+    
+    # DI
+    "Container",
+    "DIRegistry",
+    "Provider",
+    "ProviderMeta",
+    "ClassProvider",
+    "FactoryProvider",
+    "ValueProvider",
+    "service",
+    "factory",
+    "inject",
+    "Inject",
+    
+    # Sessions
+    "Session",
+    "SessionID",
+    "SessionPolicy",
+    "SessionEngine",
+    "SessionPrincipal",
+    "SessionMemoryStore",
+    "CookieTransport",
+    
+    # Session decorators (NEW - Unique syntax)
+    "session",
+    "authenticated",
+    "stateful",
+    "SessionState",
+    "SessionField",
+    "CartState",
+    "UserPreferencesState",
+    
+    # Enhanced session features (NEW - Advanced patterns)
+    "SessionContext",
+    "SessionGuard",
+    "requires",
+    "AdminGuard",
+    "VerifiedEmailGuard",
+    
+    # Config builders (NEW - Python config)
+    "Workspace",
+    "Module",
+    "Integration",
+    
+    # Auth - Core
+    "Identity",
+    "AuthManager",
+    "TokenManager",
+    "KeyRing",
+    "PasswordHasher",
+    "AuthzEngine",
+    
+    # Auth - Integration
+    "AuthPrincipal",
+    "SessionAuthBridge",
+    "bind_identity",
+    "user_session_policy",
+    "api_session_policy",
+    "register_auth_providers",
+    "create_auth_container",
+    "AuthConfig",
+    "AquilAuthMiddleware",
+    "create_auth_middleware_stack",
+    
+    # Faults
+    "Fault",
+    "FaultContext",
+    "FaultEngine",
+    "FaultHandler",
+    "RecoveryStrategy",
+    "ModelFault",
+    "AMDLParseFault",
+    "ModelNotFoundFault",
+    "ModelRegistrationFault",
+    "MigrationFault",
+    "MigrationConflictFault",
+    "QueryFault",
+    "DatabaseConnectionFault",
+    "SchemaFault",
+    
+    # Middleware
+    "Middleware",
+    "Handler",
+    "MiddlewareStack",
+    
+    # Debug Pages
+    "DebugPageRenderer",
+    "render_debug_exception_page",
+    "render_http_error_page",
+    "render_welcome_page",
+    
+    # Effects
+    "Effect",
+    "EffectProvider",
+    "EffectRegistry",
+    
+    # Sockets (WebSockets)
+    "SocketController",
+    "Socket",
+    "OnConnect",
+    "OnDisconnect",
+    "Event",
+    "AquilaSockets",
+    "SocketRouter",
+    "SocketGuard",
+    
+    # Templates
+    "TemplateEngine",
+    "TemplateMiddleware",
+    
+    # Patterns
+    "PatternCompiler",
+    "PatternMatcher",
+    "CompiledPattern",
+    "PatternTypeRegistry",
+    
+    # Discovery
+    "PackageScanner",
+    
+    # Lifecycle
+    "LifecycleCoordinator",
+    
+    # Model System (Pure Python ORM)
+    "Model",
+    "ModelMeta",
+    "ModelRegistry",
+    "Q",
+    "Field",
+    "FieldValidationError",
+    "Index",
+    "UniqueConstraint",
+    "AutoField",
+    "BigAutoField",
+    "IntegerField",
+    "BigIntegerField",
+    "SmallIntegerField",
+    "PositiveIntegerField",
+    "PositiveSmallIntegerField",
+    "FloatField",
+    "DecimalField",
+    "CharField",
+    "TextField",
+    "SlugField",
+    "EmailField",
+    "URLField",
+    "UUIDField",
+    "FilePathField",
+    "DateField",
+    "TimeField",
+    "DateTimeField",
+    "DurationField",
+    "BooleanField",
+    "BinaryField",
+    "JSONField",
+    "ForeignKey",
+    "OneToOneField",
+    "ManyToManyField",
+    "GenericIPAddressField",
+    "FileField",
+    "ImageField",
+    "ArrayField",
+    "HStoreField",
+    "GeneratedField",
+    # Legacy AMDL (backward compat)
+    "ModelNode",
+    "SlotNode",
+    "LinkNode",
+    "LegacyIndexNode",
+    "HookNode",
+    "MetaNode",
+    "NoteNode",
+    "AMDLFile",
+    "FieldType",
+    "LinkKind",
+    "parse_amdl",
+    "parse_amdl_file",
+    "parse_amdl_directory",
+    "AMDLParseError",
+    "ModelProxy",
+    # Migrations
+    "MigrationRunner",
+    "MigrationOps",
+    "generate_migration_file",
+    
+    # Database
+    "AquiliaDatabase",
+    "configure_database",
+    "get_database",
+    "set_database",
+    "DatabaseError",
+]