django-cfg 1.4.0__py3-none-any.whl → 1.4.4__py3-none-any.whl

django_cfg/modules/django_currency/examples/example_database_usage.py

@@ -0,0 +1,144 @@
+"""
+Example usage of the database loader for populating currency data.
+"""
+
+import logging
+from .database_loader import (
+    CurrencyDatabaseLoader, 
+    DatabaseLoaderConfig,
+    create_database_loader,
+    load_currencies_to_database_format
+)
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, format='%(name)s:%(levelname)s: %(message)s')
+
+
+def example_basic_usage():
+    """Basic example of using the database loader."""
+    print("🔄 Creating database loader...")
+    
+    # Create loader with default settings
+    loader = create_database_loader(
+        max_cryptocurrencies=100,  # Limit to top 100 cryptos
+        max_fiat_currencies=30,    # Top 30 fiat currencies
+        min_market_cap_usd=10_000_000,  # 10M USD minimum
+        coingecko_delay=2.0        # 2 second delay between requests
+    )
+    
+    # Get statistics
+    print("📊 Statistics:")
+    stats = loader.get_statistics()
+    for key, value in stats.items():
+        print(f"   {key}: {value}")
+    
+    print("\n🪙 Building currency database data...")
+    
+    # Build complete currency data
+    currencies = loader.build_currency_database_data()
+    
+    print(f"\n✅ Successfully loaded {len(currencies)} currencies")
+    
+    # Show sample data
+    print("\n📋 Sample currencies:")
+    for i, currency in enumerate(currencies[:10]):
+        print(f"   {i+1}. {currency.code} ({currency.currency_type}): "
+              f"{currency.name} = ${currency.usd_rate:.6f}")
+    
+    return currencies
+
+
+def example_django_integration():
+    """Example of how to integrate with Django ORM."""
+    print("🔄 Loading currencies in Django format...")
+    
+    # Get currencies in Django-ready format
+    currency_dicts = load_currencies_to_database_format()
+    
+    print(f"✅ Ready to insert {len(currency_dicts)} currencies into Django ORM")
+    
+    # This is how you would use it in Django:
+    print("\n💡 Django integration example:")
+    print("""
+    # In your Django management command or view:
+    from django_cfg.modules.django_currency.database_loader import load_currencies_to_database_format
+    from django_cfg.apps.payments.models import Currency
+    
+    # Load currency data
+    currency_data = load_currencies_to_database_format()
+    
+    # Bulk create currencies
+    currencies_to_create = []
+    for data in currency_data:
+        currency = Currency(**data)
+        currencies_to_create.append(currency)
+    
+    # Insert into database
+    Currency.objects.bulk_create(currencies_to_create, ignore_conflicts=True)
+    print(f"Inserted {len(currencies_to_create)} currencies")
+    """)
+    
+    return currency_dicts
+
+
+def example_advanced_config():
+    """Example with advanced configuration."""
+    print("🔧 Advanced configuration example...")
+    
+    # Custom configuration
+    config = DatabaseLoaderConfig(
+        # Rate limiting
+        coingecko_delay=3.0,           # Slower requests for stability
+        yfinance_delay=1.0,
+        max_requests_per_minute=20,    # Conservative rate limit
+        
+        # Limits
+        max_cryptocurrencies=50,       # Smaller set
+        max_fiat_currencies=20,
+        
+        # Filtering
+        min_market_cap_usd=50_000_000, # Higher threshold - 50M USD
+        exclude_stablecoins=True,      # Skip stablecoins
+        
+        # Cache
+        cache_ttl_hours=12            # Cache for 12 hours
+    )
+    
+    loader = CurrencyDatabaseLoader(config)
+    
+    print(f"📊 Configuration:")
+    print(f"   Max cryptocurrencies: {config.max_cryptocurrencies}")
+    print(f"   Min market cap: ${config.min_market_cap_usd:,.0f}")
+    print(f"   Exclude stablecoins: {config.exclude_stablecoins}")
+    print(f"   CoinGecko delay: {config.coingecko_delay}s")
+    
+    return loader
+
+
+if __name__ == "__main__":
+    print("🧪 CURRENCY DATABASE LOADER EXAMPLES")
+    print("=" * 50)
+    
+    try:
+        # Basic usage
+        print("\n1️⃣ BASIC USAGE:")
+        currencies = example_basic_usage()
+        
+        print("\n" + "=" * 50)
+        
+        # Django integration
+        print("\n2️⃣ DJANGO INTEGRATION:")
+        django_data = example_django_integration()
+        
+        print("\n" + "=" * 50)
+        
+        # Advanced config
+        print("\n3️⃣ ADVANCED CONFIGURATION:")
+        advanced_loader = example_advanced_config()
+        
+        print("\n🎉 All examples completed successfully!")
+        
+    except Exception as e:
+        print(f"❌ Error: {e}")
+        import traceback
+        traceback.print_exc()

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/README.md

@@ -1,14 +1,14 @@
 # Django-CFG RPC Client 📡
 
-Lightweight synchronous RPC client for Django applications to communicate with **django-cfg-rpc** WebSocket servers via Redis.
+Lightweight synchronous RPC client for Django applications to communicate with **django-ipc** WebSocket servers via Redis.
 
 **NEW**: ✨ Built-in RPC Dashboard for real-time monitoring! See [Dashboard README](./dashboard/README.md)
 
 ## 🎯 Key Features
 
 - ✅ **100% Synchronous** - No async/await in Django, works with WSGI
-- ✅ **Type-Safe** - Full Pydantic 2 support when django-cfg-rpc installed
-- ✅ **Optional Dependency** - Works without django-cfg-rpc (dict-based fallback)
+- ✅ **Type-Safe** - Full Pydantic 2 support when django-ipc installed
+- ✅ **Optional Dependency** - Works without django-ipc (dict-based fallback)
 - ✅ **Redis IPC** - Reliable communication via Streams + Lists
 - ✅ **Connection Pooling** - Automatic Redis connection management
 - ✅ **Singleton Pattern** - Single client instance across Django app
@@ -17,10 +17,10 @@ Lightweight synchronous RPC client for Django applications to communicate with *
 
 ## 📦 Installation
 
-### Option 1: With django-cfg-rpc (Recommended)
+### Option 1: With django-ipc (Recommended)
 
 ```bash
-pip install django-cfg django-cfg-rpc
+pip install django-cfg django-ipc
 ```
 
 ### Option 2: Standalone (Basic)
@@ -38,13 +38,13 @@ pip install django-cfg redis
 ```python
 # config.py
 from django_cfg import DjangoConfig
-from django_cfg.modules.django_cfg_rpc_client.config import DjangoCfgRPCConfig
+from django_cfg.modules.django_ipc_client.config import DjangoCfgRPCConfig
 
 class MyProjectConfig(DjangoConfig):
     project_name = "My Project"
 
     # RPC Client Configuration
-    django_cfg_rpc = DjangoCfgRPCConfig(
+    django_ipc = DjangoCfgRPCConfig(
         enabled=True,
         redis_url="redis://localhost:6379/2",
         rpc_timeout=30,
@@ -78,12 +78,12 @@ DJANGO_CFG_RPC__RPC_TIMEOUT=30
 
 ## 🚀 Usage
 
-### With django-cfg-rpc Models (Type-Safe)
+### With django-ipc Models (Type-Safe)
 
 ```python
 # views.py
-from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
-from django_cfg_rpc.models import NotificationRequest, NotificationResponse
+from django_cfg.modules.django_ipc_client import get_rpc_client
+from django_ipc.models import NotificationRequest, NotificationResponse
 
 rpc = get_rpc_client()
 
@@ -109,10 +109,10 @@ def notify_user(request, user_id):
     })
 ```
 
-### Without django-cfg-rpc (Dict-Based)
+### Without django-ipc (Dict-Based)
 
 ```python
-from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
+from django_cfg.modules.django_ipc_client import get_rpc_client
 
 rpc = get_rpc_client()
 
@@ -224,7 +224,7 @@ Check if RPC system is healthy.
 ### Timeout Handling
 
 ```python
-from django_cfg.modules.django_cfg_rpc_client import get_rpc_client, RPCTimeoutError
+from django_cfg.modules.django_ipc_client import get_rpc_client, RPCTimeoutError
 
 rpc = get_rpc_client()
 
@@ -238,7 +238,7 @@ except RPCTimeoutError as e:
 ### Remote Error Handling
 
 ```python
-from django_cfg.modules.django_cfg_rpc_client import RPCRemoteError
+from django_cfg.modules.django_ipc_client import RPCRemoteError
 
 try:
     result = rpc.call(method="...", params={...})
@@ -263,7 +263,7 @@ except RPCRemoteError as e:
 ┌─────────────────────────────────────────────┐
 │       Django Application (WSGI/Sync)        │
 │  ┌───────────────────────────────────────┐  │
-│  │  django_cfg_rpc_client                │  │
+│  │  django_ipc_client                │  │
 │  │  - DjangoCfgRPCClient (sync)          │  │
 │  │  - Redis Streams (requests)           │  │
 │  │  - Redis Lists (responses)            │  │
@@ -274,7 +274,7 @@ except RPCRemoteError as e:
                 │ (stream:requests → list:response:{cid})
                 ▼
 ┌─────────────────────────────────────────────┐
-│     django-cfg-rpc Server (Async)           │
+│     django-ipc Server (Async)           │
 │  - WebSocket Server                         │
 │  - Connection Manager                       │
 │  - RPC Handlers                             │
@@ -286,7 +286,7 @@ except RPCRemoteError as e:
 
 ## 🔗 Related
 
-- **django-cfg-rpc** - WebSocket RPC server package
+- **django-ipc** - WebSocket RPC server package
 - **Old Module** - `django_rpc_old` (deprecated, kept for reference)
 
 ---
@@ -298,12 +298,12 @@ except RPCRemoteError as e:
 from django_cfg.modules.django_rpc import get_rpc_client
 
 # New (current)
-from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
+from django_cfg.modules.django_ipc_client import get_rpc_client
 ```
 
 API remains mostly compatible. Main changes:
 - Configuration key: `WEBSOCKET_RPC` → `DJANGO_CFG_RPC`
-- Models now live in `django-cfg-rpc` package (optional dependency)
+- Models now live in `django-ipc` package (optional dependency)
 - Better error handling with specific exception types
 
 ---
@@ -327,7 +327,7 @@ from django.urls import path, include
 
 urlpatterns = [
     # ... other URLs
-    path('admin/rpc/', include('django_cfg.modules.django_cfg_rpc_client.dashboard.urls')),
+    path('admin/rpc/', include('django_cfg.modules.django_ipc_client.dashboard.urls')),
 ]
 ```
 

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/__init__.py

@@ -12,8 +12,8 @@ Key Features:
 - ✅ Graceful fallback if django-cfg-rpc not installed
 
 Example:
-    >>> from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
-    >>> from django_cfg_rpc.models import NotificationRequest, NotificationResponse
+    >>> from django_cfg.modules.django_ipc_client import get_rpc_client
+    >>> from django_ipc.models import NotificationRequest, NotificationResponse
     >>>
     >>> rpc = get_rpc_client()
     >>> result: NotificationResponse = rpc.call(

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/client.py

@@ -56,10 +56,10 @@ class DjangoCfgRPCClient:
     - Automatic cleanup of ephemeral keys
 
     Example:
-        >>> from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
+        >>> from django_cfg.modules.django_ipc_client import get_rpc_client
         >>>
         >>> # With django-cfg-rpc models
-        >>> from django_cfg_rpc.models import NotificationRequest, NotificationResponse
+        >>> from django_ipc.models import NotificationRequest, NotificationResponse
         >>> rpc = get_rpc_client()
         >>> result: NotificationResponse = rpc.call(
         ...     method="send_notification",
@@ -196,7 +196,7 @@ class DjangoCfgRPCClient:
             ValidationError: If response doesn't match result_model
 
         Example:
-            >>> from django_cfg_rpc.models import NotificationRequest, NotificationResponse
+            >>> from django_ipc.models import NotificationRequest, NotificationResponse
             >>> result = rpc.call(
             ...     method="send_notification",
             ...     params=NotificationRequest(user_id="123", type="info",
@@ -428,7 +428,7 @@ class DjangoCfgRPCClient:
             "request_stream": self.request_stream,
             "consumer_group": self.consumer_group,
             "default_timeout": self.default_timeout,
-            "has_django_cfg_rpc": HAS_DJANGO_CFG_RPC,
+            "has_django_ipc": HAS_DJANGO_CFG_RPC,
         }
 
     def close(self):
@@ -473,7 +473,7 @@ def get_rpc_client(force_new: bool = False) -> DjangoCfgRPCClient:
         DjangoCfgRPCClient instance
 
     Example:
-        >>> from django_cfg.modules.django_cfg_rpc_client import get_rpc_client
+        >>> from django_cfg.modules.django_ipc_client import get_rpc_client
         >>> rpc = get_rpc_client()
         >>> result = rpc.call(...)
     """

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/config.py

@@ -17,10 +17,10 @@ class DjangoCfgRPCConfig(BaseModel):
 
     Example:
         >>> from django_cfg import DjangoConfig
-        >>> from django_cfg.modules.django_cfg_rpc_client import DjangoCfgRPCConfig
+        >>> from django_cfg.modules.django_ipc_client import DjangoCfgRPCConfig
         >>>
         >>> config = DjangoConfig(
-        ...     django_cfg_rpc=DjangoCfgRPCConfig(
+        ...     django_ipc=DjangoCfgRPCConfig(
         ...         enabled=True,
         ...         redis_url="redis://localhost:6379/2",
         ...         rpc_timeout=30
@@ -30,7 +30,7 @@ class DjangoCfgRPCConfig(BaseModel):
 
     # Module metadata
     module_name: str = Field(
-        default="django_cfg_rpc_client",
+        default="django_ipc_client",
         frozen=True,
         description="Module name for django-cfg integration",
     )

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/README.md

@@ -31,11 +31,11 @@ Simply enable RPC in your django-cfg configuration:
 ```python
 # config.py
 from django_cfg import DjangoConfig
-from django_cfg.modules.django_cfg_rpc_client.config import DjangoCfgRPCConfig
+from django_cfg.modules.django_ipc_client.config import DjangoCfgRPCConfig
 
 class MyProjectConfig(DjangoConfig):
     # Enable RPC Client
-    django_cfg_rpc = DjangoCfgRPCConfig(
+    django_ipc = DjangoCfgRPCConfig(
         enabled=True,
         redis_url="redis://localhost:6379/2",
     )
@@ -67,7 +67,7 @@ from django.urls import path, include
 
 urlpatterns = [
     # RPC Dashboard (requires staff login)
-    path('admin/rpc/', include('django_cfg.modules.django_cfg_rpc_client.dashboard.urls')),
+    path('admin/rpc/', include('django_cfg.modules.django_ipc_client.dashboard.urls')),
 ]
 ```
 
@@ -129,7 +129,7 @@ Mount at custom path:
 
 ```python
 urlpatterns = [
-    path('my/custom/path/', include('django_cfg.modules.django_cfg_rpc_client.dashboard.urls')),
+    path('my/custom/path/', include('django_cfg.modules.django_ipc_client.dashboard.urls')),
 ]
 ```
 
@@ -141,13 +141,13 @@ urlpatterns = [
 
 ```bash
 # Run all dashboard tests
-pytest django_cfg/modules/django_cfg_rpc_client/tests/
+pytest django_cfg/modules/django_ipc_client/tests/
 
 # Run monitor tests
-pytest django_cfg/modules/django_cfg_rpc_client/tests/test_monitor.py -v
+pytest django_cfg/modules/django_ipc_client/tests/test_monitor.py -v
 
 # Run view tests
-pytest django_cfg/modules/django_cfg_rpc_client/tests/test_dashboard.py -v
+pytest django_cfg/modules/django_ipc_client/tests/test_dashboard.py -v
 ```
 
 ### Test Coverage
@@ -189,11 +189,11 @@ dashboard/
 ├── views.py            # Django views + JSON API
 ├── urls.py             # URL routing
 ├── templates/          # Tailwind CSS templates
-│   └── django_cfg_rpc_dashboard/
+│   └── django_ipc_dashboard/
 │       ├── base.html
 │       └── dashboard.html
 └── static/             # JavaScript
-    └── django_cfg_rpc_dashboard/
+    └── django_ipc_dashboard/
         └── js/
             └── dashboard.js
 ```
@@ -367,7 +367,7 @@ Find slow RPC methods:
 
 ## ✅ Summary
 
-- **Location**: `django_cfg/modules/django_cfg_rpc_client/dashboard/`
+- **Location**: `django_cfg/modules/django_ipc_client/dashboard/`
 - **URL**: `/admin/rpc/` (customizable)
 - **Requirements**: Staff login, Redis DB 2
 - **Tech Stack**: Django, Tailwind CSS, Vanilla JS
@@ -445,7 +445,7 @@ redis-cli -n 2 XTRIM stream:requests MAXLEN 10000
 # settings.py - Enhanced logging
 LOGGING = {
     'loggers': {
-        'django_cfg.modules.django_cfg_rpc_client.dashboard': {
+        'django_cfg.modules.django_ipc_client.dashboard': {
             'level': 'INFO',
             'handlers': ['file', 'sentry'],  # Add Sentry for production
         },
@@ -454,7 +454,7 @@ LOGGING = {
 ```
 
 ### 7. Testing
-- [ ] Run all tests: `pytest django_cfg/modules/django_cfg_rpc_client/tests/`
+- [ ] Run all tests: `pytest django_cfg/modules/django_ipc_client/tests/`
 - [ ] Load test API endpoints
 - [ ] Verify dashboard loads with production data
 - [ ] Test with Redis connection failures

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/__init__.py

@@ -4,7 +4,7 @@ RPC Dashboard for django-cfg-rpc-client.
 Provides real-time monitoring and visualization of RPC activity.
 """
 
-default_app_config = 'django_cfg.modules.django_cfg_rpc_client.dashboard.apps.RPCDashboardConfig'
+default_app_config = 'django_cfg.modules.django_ipc_client.dashboard.apps.RPCDashboardConfig'
 
 from .monitor import RPCMonitor
 

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/apps.py

@@ -12,11 +12,11 @@ class RPCDashboardConfig(AppConfig):
     RPC Dashboard application configuration.
 
     Enables:
-    - Template discovery from templates/django_cfg_rpc_dashboard/
-    - Static file discovery from static/django_cfg_rpc_dashboard/
+    - Template discovery from templates/django_ipc_dashboard/
+    - Static file discovery from static/django_ipc_dashboard/
     """
 
     default_auto_field = 'django.db.models.BigAutoField'
-    name = 'django_cfg.modules.django_cfg_rpc_client.dashboard'
-    label = 'django_cfg_rpc_dashboard'
+    name = 'django_cfg.modules.django_ipc_client.dashboard'
+    label = 'django_ipc_dashboard'
     verbose_name = 'Django-CFG RPC Dashboard'

django_cfg/modules/{django_cfg_rpc_client/dashboard/templates/django_cfg_rpc_dashboard → django_ipc_client/dashboard/templates/django_ipc_dashboard}/base.html

@@ -71,6 +71,6 @@
 <script>
     // Set API base URL for dashboard.js
     // Must run before dashboard.js initializes
-    document.body.setAttribute('data-api-base', "{% url 'django_cfg_rpc_dashboard:api_overview' %}/..");
+    document.body.setAttribute('data-api-base', "{% url 'django_ipc_dashboard:api_overview' %}/..");
 </script>
 {% endblock %}

django_cfg/modules/{django_cfg_rpc_client/dashboard/templates/django_cfg_rpc_dashboard → django_ipc_client/dashboard/templates/django_ipc_dashboard}/dashboard.html

@@ -1,4 +1,4 @@
-{% extends 'django_cfg_rpc_dashboard/base.html' %}
+{% extends 'django_ipc_dashboard/base.html' %}
 {% load static %}
 
 {% block title %}Dashboard{% endblock %}
@@ -196,5 +196,5 @@
 {% endblock %}
 
 {% block extra_js %}
-<script src="{% static 'django_cfg_rpc_dashboard/js/dashboard.js' %}"></script>
+<script src="{% static 'django_ipc_dashboard/js/dashboard.js' %}"></script>
 {% endblock %}

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/urls.py

@@ -7,7 +7,7 @@ Mount at: /admin/rpc/ or custom path
 from django.urls import path
 from . import views
 
-app_name = 'django_cfg_rpc_dashboard'
+app_name = 'django_ipc_dashboard'
 
 urlpatterns = [
     # Main dashboard page

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/urls_admin.py

@@ -1,7 +1,7 @@
 """
 URLs for Django CFG RPC Dashboard admin integration.
 
-Automatically included when django_cfg_rpc is enabled.
+Automatically included when django_ipc is enabled.
 """
 
 from .urls import urlpatterns, app_name

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/dashboard/views.py

@@ -40,7 +40,7 @@ def dashboard_view(request):
             'rpc_nav_items': rpc_nav_items,
         }
 
-        return render(request, 'django_cfg_rpc_dashboard/dashboard.html', context)
+        return render(request, 'django_ipc_dashboard/dashboard.html', context)
 
     except Exception as e:
         logger.error(f"Dashboard view error: {e}", exc_info=True)
@@ -62,7 +62,7 @@ def dashboard_view(request):
             'rpc_nav_items': rpc_nav_items,
         }
 
-        return render(request, 'django_cfg_rpc_dashboard/dashboard.html', context)
+        return render(request, 'django_ipc_dashboard/dashboard.html', context)
 
 
 # === JSON API Endpoints ===

django_cfg/modules/{django_cfg_rpc_client → django_ipc_client}/exceptions.py

@@ -9,7 +9,7 @@ from typing import Optional, Any
 
 # Try to import RPCError from django-cfg-rpc if available
 try:
-    from django_cfg_rpc.models.errors import RPCError
+    from django_ipc.models.errors import RPCError
     HAS_DJANGO_CFG_RPC = True
 except ImportError:
     # Fallback: simple RPCError for basic error handling

django_cfg/registry/modules.py

@@ -11,7 +11,7 @@ MODULES_REGISTRY = {
     "set_current_config": ("django_cfg.core.config", "set_current_config"),
 
     # RPC Client module
-    "DjangoCfgRPCConfig": ("django_cfg.modules.django_cfg_rpc_client.config", "DjangoCfgRPCConfig"),
+    "DjangoCfgRPCConfig": ("django_cfg.modules.django_ipc_client.config", "DjangoCfgRPCConfig"),
 
     # Import/Export integration (simple re-exports)
     "ImportForm": ("django_cfg.modules.django_import_export", "ImportForm"),