jvspatial 0.0.1__py3-none-any.whl

jvspatial/__init__.py

@@ -0,0 +1,104 @@
+"""
+jvspatial - Enhanced async object-spatial Python library.
+
+jvspatial is an asynchronous, object-spatial Python library designed for building
+robust persistence and business logic application layers. This enhanced version
+maintains the original inheritance hierarchy while providing simplified APIs.
+
+Key Features:
+- Maintained inheritance hierarchy: Object → Node → Edge/Walker
+- Enhanced classes with simplified decorator support
+- Simplified decorator system (@attribute, @endpoint)
+- Direct instantiation (no complex factories)
+- Essential CRUD operations
+- Unified configuration system
+- Async/await architecture
+
+Main Exports (Import from top level):
+    Core Entities (Maintaining Original Hierarchy):
+        - Object: Base class for all entities
+        - Node: Graph nodes with spatial data (inherits from Object)
+        - Edge: Relationships between nodes (inherits from Object)
+        - Walker: Graph traversal and pathfinding (inherits from Object)
+        - Root: Singleton root node (inherits from Node)
+        - GraphContext: Graph database context
+
+    Decorators:
+        - attribute: Unified attribute decorator (@attribute(protected=True))
+        - endpoint: Unified endpoint decorator (@endpoint("/api/users"))
+
+    API:
+        - Server: FastAPI server for graph operations
+        - Config: Unified configuration system
+
+    Database & Cache:
+        - Database: Simplified database interface
+        - create_database: Direct database creation
+        - create_cache: Direct cache creation
+
+    Utilities:
+        - serialize_datetime: Serialize datetime objects
+        - deserialize_datetime: Deserialize datetime objects
+
+Example:
+    # Using enhanced classes with maintained hierarchy
+    from jvspatial import Node, Walker, Server, Config, create_database
+
+    # Node inherits from Object with all original functionality
+    node = Node(id="test-node")
+
+    # Walker inherits from Object with all original functionality
+    walker = Walker()
+    await walker.spawn(node)
+"""
+
+# API server
+from .api import Server
+from .api.decorators.route import endpoint
+from .cache import create_cache
+
+# Unified configuration
+from .config import Config
+
+# Simplified decorators
+from .core.annotations import attribute
+from .core.context import GraphContext
+
+# Unified entity system
+from .core.entities import Edge, Node, Object, Root, Walker
+
+# Simplified database and cache
+from .db import Database, create_database
+
+# Utilities
+from .utils.serialization import deserialize_datetime, serialize_datetime
+
+# Version is managed in version.py
+# Update version.py to release a new version
+from .version import __version__
+
+__all__ = [
+    # Version
+    "__version__",
+    # Unified configuration
+    "Config",
+    # Core entities
+    "Object",
+    "Node",
+    "Edge",
+    "Walker",
+    "Root",
+    "GraphContext",
+    # Simplified decorators
+    "attribute",
+    "endpoint",
+    # API
+    "Server",
+    # Database & Cache
+    "Database",
+    "create_database",
+    "create_cache",
+    # Utilities
+    "serialize_datetime",
+    "deserialize_datetime",
+]

jvspatial/api/__init__.py

@@ -0,0 +1,45 @@
+"""API module for jvspatial.
+
+This module provides:
+- Server implementation with FastAPI integration
+- Authentication and authorization
+- Response handling
+- Endpoint configuration
+- Error handling
+"""
+
+from .config import ServerConfig
+from .context import ServerContext, get_current_server, set_current_server
+from .decorators.route import endpoint
+
+# Note: EndpointField, EndpointFieldInfo, endpoint_field moved to endpoints module
+# from .endpoints import EndpointField, EndpointFieldInfo, endpoint_field
+# from .endpoints import ResponseHelper, format_response
+# Note: Routing moved to endpoints module
+# from .routing import (
+#     BaseRouter,
+#     EndpointRouter,
+# )
+from .server import Server, create_lambda_handler, create_server
+
+__all__ = [
+    # Main exports
+    "Server",
+    "ServerConfig",
+    "create_server",
+    "create_lambda_handler",
+    "get_current_server",
+    "set_current_server",
+    "ServerContext",
+    "endpoint",
+    # Core routers (for advanced usage)
+    "BaseRouter",
+    "EndpointRouter",
+    # Field configuration
+    "endpoint_field",
+    "EndpointField",
+    "EndpointFieldInfo",
+    # Response handling
+    "format_response",
+    "ResponseHelper",
+]

jvspatial/api/auth/config.py

@@ -0,0 +1,76 @@
+"""Authentication configuration for jvspatial API.
+
+This module provides authentication configuration models for the jvspatial API,
+including JWT, API key, and session-based authentication settings.
+"""
+
+from typing import List
+
+from pydantic import BaseModel, Field
+
+
+class AuthConfig(BaseModel):
+    """Authentication configuration model.
+
+    Attributes:
+        enabled: Enable authentication middleware
+        exempt_paths: List of paths exempt from authentication
+        jwt_secret: JWT secret key
+        jwt_algorithm: JWT algorithm
+        jwt_expire_minutes: JWT expiration time in minutes
+        api_key_header: Header name for API key authentication
+        session_cookie_name: Cookie name for session authentication
+        session_expire_minutes: Session expiration time in minutes
+    """
+
+    # General Authentication Settings
+    enabled: bool = True
+    exempt_paths: List[str] = Field(
+        default_factory=lambda: [
+            "/health",
+            "/docs",
+            "/redoc",
+            "/openapi.json",
+            "/favicon.ico",
+        ]
+    )
+
+    # JWT Configuration
+    jwt_secret: str = Field(default="your-secret-key", description="JWT secret key")
+    jwt_algorithm: str = Field(default="HS256", description="JWT algorithm")
+    jwt_expire_minutes: int = Field(
+        default=30, description="JWT expiration time in minutes"
+    )
+
+    # API Key Configuration
+    api_key_header: str = Field(
+        default="x-api-key", description="Header name for API key"
+    )
+
+    # Session Configuration
+    session_cookie_name: str = Field(
+        default="session", description="Session cookie name"
+    )
+    session_expire_minutes: int = Field(
+        default=60, description="Session expiration time in minutes"
+    )
+
+    # Rate Limiting Configuration
+    rate_limit_enabled: bool = Field(default=False, description="Enable rate limiting")
+    rate_limit_requests_per_minute: int = Field(
+        default=60, description="Requests per minute limit"
+    )
+
+    # Brute Force Protection
+    brute_force_protection_enabled: bool = Field(
+        default=False, description="Enable brute force protection"
+    )
+    max_login_attempts: int = Field(
+        default=5, description="Maximum login attempts before lockout"
+    )
+    lockout_duration_minutes: int = Field(
+        default=15, description="Lockout duration in minutes"
+    )
+
+
+__all__ = ["AuthConfig"]