django-nativemojo 0.1.15__py3-none-any.whl → 0.1.17__py3-none-any.whl

mojo/serializers/core/__init__.py

@@ -0,0 +1,90 @@
+"""
+Django-MOJO Core Serializers
+
+High-performance serialization system with intelligent caching and RestMeta.GRAPHS support.
+This is the optimized serializer implementation with pluggable cache backends.
+
+Main Components:
+- OptimizedGraphSerializer: Ultra-fast serializer with smart caching
+- SerializerManager: Unified interface for all serializer backends
+- Cache backends: Memory and Redis-based caching systems
+
+Usage:
+    from mojo.serializers.core import OptimizedGraphSerializer, SerializerManager
+
+    # Direct usage
+    serializer = OptimizedGraphSerializer(instance, graph="detail")
+    data = serializer.serialize()
+
+    # Via manager
+    manager = SerializerManager()
+    serializer = manager.get_serializer(instance, graph="list")
+"""
+
+# Import core components
+from .serializer import OptimizedGraphSerializer
+from .manager import (
+    SerializerManager,
+    get_serializer_manager,
+    register_serializer,
+    set_default_serializer,
+    serialize,
+    to_json,
+    to_response,
+    get_performance_stats,
+    clear_serializer_caches,
+    benchmark_serializers,
+    list_serializers,
+    HAS_UJSON,
+    UJSON_VERSION
+)
+
+# Import cache system
+from .cache import (
+    get_cache_backend,
+    get_cache_key,
+    get_model_cache_ttl,
+    get_cache_stats,
+    clear_all_caches,
+    HAS_UJSON,
+    UJSON_VERSION
+)
+
+# Core serializer exports
+__all__ = [
+    # Main serializer
+    'OptimizedGraphSerializer',
+
+    # Manager
+    'SerializerManager',
+    'get_serializer_manager',
+
+    # Registration functions
+    'register_serializer',
+    'set_default_serializer',
+
+    # Convenience functions
+    'serialize',
+    'to_json',
+    'to_response',
+
+    # Performance monitoring
+    'get_performance_stats',
+    'clear_serializer_caches',
+    'benchmark_serializers',
+    'list_serializers',
+
+    # Cache system
+    'get_cache_backend',
+    'get_cache_key',
+    'get_model_cache_ttl',
+    'get_cache_stats',
+    'clear_all_caches',
+
+    # Performance info
+    'HAS_UJSON',
+    'UJSON_VERSION',
+]
+
+# Version info
+__version__ = "1.0.0"

mojo/serializers/core/cache/__init__.py

@@ -0,0 +1,121 @@
+"""
+Django-MOJO Cache System for Serializers
+
+Provides pluggable cache backends for high-performance serialization with intelligent
+TTL management based on RestMeta.GRAPHS configuration.
+
+Supported Backends:
+- MemoryCacheBackend: In-process LRU cache with TTL support
+- RedisCacheBackend: Distributed Redis-based caching (future)
+- DisabledCacheBackend: No-op cache for development/testing
+
+Key Features:
+- RestMeta.cache_ttl configuration per model/graph
+- LRU eviction with configurable size limits
+- JSON serialization for Redis compatibility
+- Thread-safe operations
+- Safe defaults (cache_ttl=0 means no caching)
+
+Usage:
+    from mojo.serializers.core.cache import get_cache_backend
+
+    cache = get_cache_backend()
+
+    # Get cached item (returns None if not found/expired)
+    data = cache.get("Event_123_default")
+
+    # Set with TTL from RestMeta configuration
+    cache.set("Event_123_default", serialized_data, ttl=300)
+
+Configuration:
+    MOJO_SERIALIZER_CACHE = {
+        'backend': 'memory',  # 'memory', 'redis', 'disabled'
+        'memory': {
+            'max_size': 5000,
+            'enable_stats': True
+        },
+        'redis': {  # Future implementation
+            'host': 'localhost',
+            'port': 6379,
+            'key_prefix': 'mojo:serializer:'
+        }
+    }
+
+RestMeta Configuration:
+    class MyModel(MojoModel):
+        class RestMeta:
+            GRAPHS = {
+                "default": {
+                    "fields": ["id", "name"],
+                    "cache_ttl": 300  # 5 minutes
+                },
+                "realtime": {
+                    "fields": ["id", "status"],
+                    "cache_ttl": 0  # No caching (default)
+                }
+            }
+"""
+
+from .base import CacheBackend
+from .memory import MemoryCacheBackend
+from .redis import RedisCacheBackend
+from .disabled import DisabledCacheBackend
+from .backends import (
+    get_cache_backend,
+    create_cache_backend,
+    reset_cache_backend,
+    get_available_backends,
+    test_backend_connectivity,
+    get_cache_health,
+    validate_cache_config
+)
+
+from .utils import (
+    get_cache_key,
+    get_model_cache_ttl,
+    get_cache_stats,
+    clear_all_caches
+)
+
+# Check ujson availability for performance optimization
+try:
+    import ujson
+    HAS_UJSON = True
+    UJSON_VERSION = getattr(ujson, '__version__', 'unknown')
+except ImportError:
+    ujson = None
+    HAS_UJSON = False
+    UJSON_VERSION = None
+
+# Main exports
+__all__ = [
+    # Backend classes
+    'CacheBackend',
+    'MemoryCacheBackend',
+    'RedisCacheBackend',
+    'DisabledCacheBackend',
+
+    # Factory functions
+    'get_cache_backend',
+    'create_cache_backend',
+    'reset_cache_backend',
+
+    # Backend management
+    'get_available_backends',
+    'test_backend_connectivity',
+    'get_cache_health',
+    'validate_cache_config',
+
+    # Utilities
+    'get_cache_key',
+    'get_model_cache_ttl',
+    'get_cache_stats',
+    'clear_all_caches',
+
+    # Performance info
+    'HAS_UJSON',
+    'UJSON_VERSION',
+]
+
+# Version info
+__version__ = "1.0.0"