kailash 0.8.2__py3-none-any.whl → 0.8.3__py3-none-any.whl

kailash/__init__.py

@@ -52,7 +52,7 @@ except ImportError:
 # For backward compatibility
 WorkflowGraph = Workflow
 
-__version__ = "0.8.2"
+__version__ = "0.8.3"
 
 __all__ = [
     # Core workflow components

kailash/middleware/database/base_models.py

@@ -8,7 +8,13 @@ import uuid
 from datetime import datetime, timezone
 from typing import Any, Dict, List, Optional
 
-from sqlalchemy import JSON, Boolean, CheckConstraint, Column, DateTime
+from sqlalchemy import (
+    JSON,
+    Boolean,
+    CheckConstraint,
+    Column,
+    DateTime,
+)
 from sqlalchemy import Enum as SQLEnum
 from sqlalchemy import (
     Float,

kailash/nodes/code/python.py

@@ -103,6 +103,7 @@ ALLOWED_MODULES = {
     "glob",  # For file pattern matching
     "xml",  # For XML processing
     "uuid",  # For generating unique identifiers (safe, no I/O)
+    "hashlib",  # For cryptographic hashing (safe for common use cases)
 }
 
 

kailash/workflow/builder.py

@@ -380,18 +380,89 @@ class WorkflowBuilder:
             WorkflowValidationError: If nodes don't exist
             ConnectionError: If connection is invalid
         """
+        # Enhanced error messages with helpful suggestions
         if from_node not in self.nodes:
-            raise WorkflowValidationError(
-                f"Source node '{from_node}' not found in workflow"
-            )
+            available_nodes = list(self.nodes.keys())
+            similar_nodes = [
+                n
+                for n in available_nodes
+                if from_node.lower() in n.lower() or n.lower() in from_node.lower()
+            ]
+
+            error_msg = f"Source node '{from_node}' not found in workflow."
+            if available_nodes:
+                error_msg += f"\nAvailable nodes: {available_nodes}"
+            if similar_nodes:
+                error_msg += f"\nDid you mean: {similar_nodes}?"
+            error_msg += f"\n\nTip: Use workflow.add_node() to create nodes before connecting them."
+            error_msg += f"\nExample: workflow.add_node('CSVReaderNode', '{from_node}', {{'file_path': 'data.csv'}})"
+
+            raise WorkflowValidationError(error_msg)
+
         if to_node not in self.nodes:
-            raise WorkflowValidationError(
-                f"Target node '{to_node}' not found in workflow"
+            available_nodes = list(self.nodes.keys())
+            similar_nodes = [
+                n
+                for n in available_nodes
+                if to_node.lower() in n.lower() or n.lower() in to_node.lower()
+            ]
+
+            error_msg = f"Target node '{to_node}' not found in workflow."
+            if available_nodes:
+                error_msg += f"\nAvailable nodes: {available_nodes}"
+            if similar_nodes:
+                error_msg += f"\nDid you mean: {similar_nodes}?"
+            error_msg += f"\n\nTip: Use workflow.add_node() to create nodes before connecting them."
+            error_msg += f"\nExample: workflow.add_node('PythonCodeNode', '{to_node}', {{'code': 'result = data'}})"
+
+            raise WorkflowValidationError(error_msg)
+
+        # Self-connection check with helpful message
+        if from_node == to_node:
+            raise ConnectionError(
+                f"Cannot connect node '{from_node}' to itself.\n"
+                f"Tip: Consider using intermediate nodes or different port names.\n"
+                f"Example: Create a separate processing node between input and output."
             )
 
-        # Self-connection check
-        if from_node == to_node:
-            raise ConnectionError(f"Cannot connect node '{from_node}' to itself")
+        # REFINED: Enhanced duplicate connection detection
+        for existing_conn in self.connections:
+            if (
+                existing_conn["from_node"] == from_node
+                and existing_conn["from_output"] == from_output
+                and existing_conn["to_node"] == to_node
+                and existing_conn["to_input"] == to_input
+            ):
+                raise ConnectionError(
+                    f"Duplicate connection detected: {from_node}.{from_output} -> {to_node}.{to_input}\n"
+                    f"This connection already exists in the workflow.\n"
+                    f"Tip: Remove the duplicate add_connection() call or use different port names.\n"
+                    f"Current connections: {len(self.connections)} total"
+                )
+
+        # Enhanced port validation with suggestions
+        common_output_ports = [
+            "data",
+            "result",
+            "output",
+            "response",
+            "content",
+            "value",
+        ]
+        common_input_ports = ["data", "input", "input_data", "content", "value"]
+
+        # Log port usage patterns for debugging
+        if from_output not in common_output_ports:
+            logger.debug(
+                f"Using non-standard output port '{from_output}' on node '{from_node}'"
+            )
+            logger.debug(f"Common output ports: {common_output_ports}")
+
+        if to_input not in common_input_ports:
+            logger.debug(
+                f"Using non-standard input port '{to_input}' on node '{to_node}'"
+            )
+            logger.debug(f"Common input ports: {common_input_ports}")
 
         # Add connection to list
         connection = {
@@ -402,7 +473,15 @@ class WorkflowBuilder:
         }
         self.connections.append(connection)
 
-        logger.info(f"Connected '{from_node}.{from_output}' to '{to_node}.{to_input}'")
+        logger.info(f"Connected '{from_node}.{from_output}' -> '{to_node}.{to_input}'")
+
+        # Provide helpful tips for common connection patterns
+        if from_output == to_input == "data":
+            logger.debug(f"Using standard data flow connection pattern")
+        elif from_output in ["result", "output"] and to_input in ["data", "input"]:
+            logger.debug(f"Using result-to-input connection pattern")
+        else:
+            logger.debug(f"Using custom port mapping: {from_output} -> {to_input}")
         return self
 
     def connect(

{kailash-0.8.2.dist-info → kailash-0.8.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kailash
-Version: 0.8.2
+Version: 0.8.3
 Summary: Python SDK for the Kailash container-node architecture
 Home-page: https://github.com/integrum/kailash-python-sdk
 Author: Integrum

{kailash-0.8.2.dist-info → kailash-0.8.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kailash/__init__.py,sha256=c6u1PTFEDN9LCF5E1aAVq_2MWi1wkrAywWwrfejFdis,2878
+kailash/__init__.py,sha256=YyZQsrDNnTGLOgebSi3bdZzjuDDTWs_s1v0XjVHwz5w,2878
 kailash/__main__.py,sha256=vr7TVE5o16V6LsTmRFKG6RDKUXHpIWYdZ6Dok2HkHnI,198
 kailash/access_control.py,sha256=MjKtkoQ2sg1Mgfe7ovGxVwhAbpJKvaepPWr8dxOueMA,26058
 kailash/access_control_abac.py,sha256=FPfa_8PuDP3AxTjdWfiH3ntwWO8NodA0py9W8SE5dno,30263
@@ -92,7 +92,7 @@ kailash/middleware/core/schema.py,sha256=uVF-5ZJlLYHOQdsKrG46FnTO1bq_QtDjhUSkIID
 kailash/middleware/core/workflows.py,sha256=kjwwP69-T6eCY7kWIMLUBwVy2CapoPR34cqCETquq0s,12480
 kailash/middleware/database/__init__.py,sha256=UMws94L-vja94AjfzPWIgn0h4_5BGQzI3YaSdqtzeLk,1682
 kailash/middleware/database/base.py,sha256=cWEei9Gb6J-C-bpa4M4T0takfWE3POXWumzYhqX3V4g,2735
-kailash/middleware/database/base_models.py,sha256=t4HfXKGHZkfLkzoRgXXvlO_wdgsqXhm7S0XP4OIdQXc,18262
+kailash/middleware/database/base_models.py,sha256=XBcHEUmcpl2f6zZHCAgHQ_0jqUB3Gl82XARR83lW5GY,18287
 kailash/middleware/database/enums.py,sha256=Yo_wMS7OpsleWtNMESTc2LTf15d93nPnBADIn2EHjeQ,2516
 kailash/middleware/database/migrations.py,sha256=v5VZxsqciwmOl3rzIBQLp5p6-OP8OG_EL3mu65_yrCM,240
 kailash/middleware/database/models.py,sha256=CJwwUEdgxqBteXqpFJr1tWskjypJxViZXjODZlByrFk,17784
@@ -166,7 +166,7 @@ kailash/nodes/cache/cache_invalidation.py,sha256=IUvxrRj3K5EF29Z2EaKl7t6Uze_cssn
 kailash/nodes/cache/redis_pool_manager.py,sha256=GR82GCWxo_gAzRE-091OB6AhKre8CTwM3OoePLb2gvE,21574
 kailash/nodes/code/__init__.py,sha256=yhEwuMjUEPFfe6hMGMd4E4gZdLUuf2JEQ7knYapiM4o,1283
 kailash/nodes/code/async_python.py,sha256=Ai-iMpmz-sAori73JBk0wZtqmwtmF2GNPDxqB04I2Ck,37058
-kailash/nodes/code/python.py,sha256=AfKNL4B-OTiFQoNuCzZ2mLiJV61TaHLXhHmXudl20eg,60592
+kailash/nodes/code/python.py,sha256=no3JoQMXz45nKraa81YAI4S-DM-dnVHu8NS-xVq-Ipw,60664
 kailash/nodes/compliance/__init__.py,sha256=6a_FL4ofc8MAVuZ-ARW5uYenZLS4mBFVM9AI2QsnoF8,214
 kailash/nodes/compliance/data_retention.py,sha256=90bH_eGwlcDzUdklAJeXQM-RcuLUGQFQ5fgHOK8a4qk,69443
 kailash/nodes/compliance/gdpr.py,sha256=ZMoHZjAo4QtGwtFCzGMrAUBFV3TbZOnJ5DZGZS87Bas,70548
@@ -317,7 +317,7 @@ kailash/visualization/reports.py,sha256=D7kJ0flHr16d-qSEq8vnw20N8u_dgTrXtKVSXVm8
 kailash/workflow/__init__.py,sha256=DDQDE9K6RmbX6479guNLLgjiVVV-gQERRvCEJWSVlsM,1836
 kailash/workflow/async_builder.py,sha256=iv8bDJHdWAUZ77SyMo6sucd92dTdtXesdxycrSE7mM4,20613
 kailash/workflow/async_patterns.py,sha256=X0ZDXwr6UAu0WC1xnCB7-0V1-tRbKs9UI4JqaBCB6tE,22824
-kailash/workflow/builder.py,sha256=3l5wVRtMB1Om_QmeoQ6jsrc_Lm8Hna_pH47UjnfMb9I,31184
+kailash/workflow/builder.py,sha256=Ux0TiXfnwRKVhmMEDBv8bE6cDoXSjs6-3fAH9BABBQE,34859
 kailash/workflow/convergence.py,sha256=vfIDR-uNaQE-LVUEzrRtfgKPgX9gL0nLNH-nTg5ra-c,10031
 kailash/workflow/cycle_analyzer.py,sha256=BGBpgdB-g0-KRI65sVAvHV4lxfoCzMt4uKOHbw8GXT4,32596
 kailash/workflow/cycle_builder.py,sha256=uWAx8K4ZKMtFC3mWylK4gHT03xeu0xChJlhw50hVqEE,20883
@@ -339,9 +339,9 @@ kailash/workflow/state.py,sha256=UTZxs5-Ona6uvBhx1__i6-RX8gB4qazkBIWE7uyRmWQ,760
 kailash/workflow/templates.py,sha256=98EN5H4fO9b4xeczk20Hu5L8hNcAuRQNGayT6vnZYCw,48540
 kailash/workflow/validation.py,sha256=rWZNJYA_XAfk_og6Cxz8p1gZ3j5CylPvMTDXg2SfjgM,38574
 kailash/workflow/visualization.py,sha256=nHBW-Ai8QBMZtn2Nf3EE1_aiMGi9S6Ui_BfpA5KbJPU,23187
-kailash-0.8.2.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
-kailash-0.8.2.dist-info/METADATA,sha256=W8EHXCHAgc_L7yUSvGR-DlzjB3UL14XxxrubBpkd8d8,20263
-kailash-0.8.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kailash-0.8.2.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
-kailash-0.8.2.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
-kailash-0.8.2.dist-info/RECORD,,
+kailash-0.8.3.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
+kailash-0.8.3.dist-info/METADATA,sha256=ke3WhdN0tyrq6YneptdCJH7I7SBOu7djfwWhzVDrAqw,20263
+kailash-0.8.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kailash-0.8.3.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
+kailash-0.8.3.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
+kailash-0.8.3.dist-info/RECORD,,