syncforge 1.0.1__tar.gz → 1.0.2__tar.gz

{syncforge-1.0.1/syncforge.egg-info → syncforge-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syncforge
-Version: 1.0.1
+Version: 1.0.2
 Summary: Official Python SDK for SyncForge — control exactly when data syncs between your database and clients.
 Author-email: SyncForge <sureshdulupolai@gmail.com>
 License-Expression: MIT

{syncforge-1.0.1 → syncforge-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "syncforge"
-version = "1.0.1"
+version = "1.0.2"
 description = "Official Python SDK for SyncForge — control exactly when data syncs between your database and clients."
 readme = "README.md"
 license = "MIT"

{syncforge-1.0.1 → syncforge-1.0.2}/syncforge/client.py

@@ -183,6 +183,32 @@ class SyncForge:
                 return False
             raise
 
+    def delete_table(self, table_name: str) -> bool:
+        """
+        Delete a registered table from the SyncForge dashboard programmatically.
+        
+        Args:
+            table_name: The name of the table to delete.
+            
+        Returns:
+            bool: True if it was deleted, False otherwise.
+        """
+        table_name = table_name.strip().lower()
+        if not table_name:
+            raise ValueError("Table name cannot be empty.")
+            
+        import urllib.parse
+        url = f"{self._base_url}/v1/tables/?table_name={urllib.parse.quote(table_name)}"
+        try:
+            res = self._request("DELETE", url)
+            return res.get("deleted", False)
+        except SyncForgeError as exc:
+            if self._silent:
+                import warnings
+                warnings.warn(f"[SyncForge] delete_table failed: {exc}", stacklevel=2)
+                return False
+            raise
+
     # ── Internal ──────────────────────────────────────────────────────────────
 
     def _refresh_all(self, tables: tuple) -> List[SyncResult]:

syncforge-1.0.2/syncforge/django.py

@@ -0,0 +1,78 @@
+"""
+Django integration for SyncForge.
+Provides the @sync_model decorator to auto-sync Django models.
+"""
+import logging
+
+try:
+    from django.db.models.signals import post_save, post_delete
+    from django.apps import apps
+    HAS_DJANGO = True
+except ImportError:
+    HAS_DJANGO = False
+
+logger = logging.getLogger("syncforge")
+
+_registered_tables = set()
+
+def sync_model(sf_client, sync_mode='event'):
+    """
+    Class decorator for Django models to automatically sync with SyncForge.
+    
+    Example:
+        from syncforge import sf
+        from syncforge.django import sync_model
+        
+        @sync_model(sf)
+        class Product(models.Model):
+            name = models.CharField(max_length=100)
+    """
+    def decorator(cls):
+        if not HAS_DJANGO:
+            raise ImportError("Django is not installed. Cannot use @sync_model.")
+            
+        table_name = cls._meta.db_table
+        
+        # 1. Register table on SyncForge dashboard
+        try:
+            sf_client.create_table(table_name, sync_mode=sync_mode)
+        except Exception as e:
+            logger.warning(f"[SyncForge] Failed to register table {table_name}: {e}")
+            
+        _registered_tables.add(table_name)
+            
+        # 2. Hook into ORM signals to trigger syncs automatically
+        def _trigger_sync(sender, **kwargs):
+            try:
+                sf_client.refresh(table_name)
+            except Exception as e:
+                logger.error(f"[SyncForge] Failed to trigger sync for {table_name}: {e}")
+                
+        # Connect signals
+        post_save.connect(_trigger_sync, sender=cls, weak=False, dispatch_uid=f"sf_save_{table_name}")
+        post_delete.connect(_trigger_sync, sender=cls, weak=False, dispatch_uid=f"sf_delete_{table_name}")
+        
+        return cls
+    return decorator
+
+
+def sync_migrations(sf_client):
+    """
+    Removes tables from the SyncForge dashboard that no longer exist in your Django project.
+    Call this inside an AppConfig.ready() or after your migrations run.
+    """
+    if not HAS_DJANGO:
+        return
+        
+    try:
+        active_tables = {model._meta.db_table for model in apps.get_models()}
+        
+        # Fetch current registered tables from SyncForge
+        sf_tables = sf_client.list_tables()
+        for t in sf_tables:
+            t_name = t.get('table_name')
+            if t_name and t_name not in active_tables:
+                sf_client.delete_table(t_name)
+                logger.info(f"[SyncForge] Cleaned up deleted table: {t_name}")
+    except Exception as e:
+        logger.warning(f"[SyncForge] sync_migrations cleanup failed: {e}")

{syncforge-1.0.1 → syncforge-1.0.2/syncforge.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syncforge
-Version: 1.0.1
+Version: 1.0.2
 Summary: Official Python SDK for SyncForge — control exactly when data syncs between your database and clients.
 Author-email: SyncForge <sureshdulupolai@gmail.com>
 License-Expression: MIT

{syncforge-1.0.1 → syncforge-1.0.2}/syncforge.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 syncforge/__init__.py
 syncforge/client.py
+syncforge/django.py
 syncforge/exceptions.py
 syncforge/result.py
 syncforge.egg-info/PKG-INFO