exonware-xwnode 0.0.1.14__py3-none-any.whl → 0.0.1.16__py3-none-any.whl

exonware/xwnode/queries/executors/data/merge_executor.py

@@ -7,7 +7,7 @@ MERGE Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/data/store_executor.py

@@ -7,7 +7,7 @@ STORE Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/engine.py

@@ -10,7 +10,7 @@ with capability checking and routing.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/errors.py

@@ -10,7 +10,7 @@ Extends root error classes per DEV_GUIDELINES.md - no redundancy.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/between_executor.py

@@ -7,7 +7,7 @@ BETWEEN Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/filter_executor.py

@@ -7,7 +7,7 @@ FILTER Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/has_executor.py

@@ -7,7 +7,7 @@ HAS Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/in_executor.py

@@ -7,7 +7,7 @@ IN Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/like_executor.py

@@ -7,7 +7,7 @@ LIKE Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/optional_executor.py

@@ -7,7 +7,7 @@ OPTIONAL Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/range_executor.py

@@ -7,7 +7,7 @@ RANGE Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/term_executor.py

@@ -7,7 +7,7 @@ TERM Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/values_executor.py

@@ -7,7 +7,7 @@ VALUES Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/filtering/where_executor.py

@@ -7,7 +7,7 @@ WHERE Operation Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/graph/in_traverse_executor.py

@@ -7,7 +7,7 @@ IN_TRAVERSE Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/graph/match_executor.py

@@ -7,7 +7,7 @@ MATCH Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/graph/out_executor.py

@@ -7,7 +7,7 @@ OUT Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/graph/path_executor.py

@@ -7,7 +7,7 @@ PATH Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/graph/return_executor.py

@@ -7,7 +7,7 @@ RETURN Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/ordering/by_executor.py

@@ -7,7 +7,7 @@ BY Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/ordering/order_executor.py

@@ -7,7 +7,7 @@ ORDER Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/projection/extend_executor.py

@@ -7,7 +7,7 @@ EXTEND Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/projection/project_executor.py

@@ -7,7 +7,7 @@ PROJECT Executor
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 09-Oct-2025
 """
 

exonware/xwnode/queries/executors/registry.py

@@ -9,7 +9,7 @@ This module provides registry for managing operation executors.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/executors/types.py

@@ -10,7 +10,7 @@ Imports shared types from root types.py per DEV_GUIDELINES.md.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.14
+Version: 0.0.1.16
 Generation Date: 08-Oct-2025
 """
 

exonware/xwnode/queries/parsers/__init__.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+"""
+#exonware/xwnode/src/exonware/xwnode/queries/parsers/__init__.py
+
+Query Parsers Module
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.0.1.16
+Generation Date: 09-Oct-2025
+"""
+
+from .contracts import IParamExtractor
+from .errors import ParserError, ParseError
+from .base import AParamExtractor
+from .sql_param_extractor import SQLParamExtractor
+
+__all__ = [
+    'IParamExtractor',
+    'ParserError',
+    'ParseError',
+    'AParamExtractor',
+    'SQLParamExtractor',
+]
+

exonware/xwnode/queries/parsers/base.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+"""
+#exonware/xwnode/src/exonware/xwnode/queries/parsers/base.py
+
+Parser Base Classes
+
+Abstract base class for parameter extractors.
+Follows DEV_GUIDELINES.md: base.py extends contracts.py interfaces.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.0.1.16
+Generation Date: 09-Oct-2025
+"""
+
+from abc import ABC
+from typing import Dict, Any, Union
+
+from .contracts import IParamExtractor
+from .errors import ParseError
+
+
+class AParamExtractor(IParamExtractor, ABC):
+    """
+    Abstract base class for parameter extractors.
+    
+    Extends IParamExtractor interface per DEV_GUIDELINES.md.
+    """
+    
+    def _parse_value(self, value_str: str) -> Union[str, int, float, bool, None]:
+        """
+        Parse value from string to appropriate type.
+        
+        Args:
+            value_str: String representation of value
+        
+        Returns:
+            Parsed value with correct type
+        """
+        value_str = value_str.strip().strip('"').strip("'")
+        
+        # Try boolean
+        if value_str.lower() == 'true':
+            return True
+        if value_str.lower() == 'false':
+            return False
+        if value_str.lower() == 'null' or value_str.lower() == 'none':
+            return None
+        
+        # Try number
+        try:
+            if '.' in value_str:
+                return float(value_str)
+            return int(value_str)
+        except ValueError:
+            pass
+        
+        # Return as string
+        return value_str
+    
+    def _split_fields(self, fields_str: str) -> list:
+        """Split comma-separated fields, handling nested expressions."""
+        if fields_str.strip() == '*':
+            return ['*']
+        
+        fields = []
+        current = []
+        paren_depth = 0
+        
+        for char in fields_str:
+            if char == '(':
+                paren_depth += 1
+            elif char == ')':
+                paren_depth -= 1
+            elif char == ',' and paren_depth == 0:
+                fields.append(''.join(current).strip())
+                current = []
+                continue
+            current.append(char)
+        
+        if current:
+            fields.append(''.join(current).strip())
+        
+        return fields
+

exonware/xwnode/queries/parsers/contracts.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""
+#exonware/xwnode/src/exonware/xwnode/queries/parsers/contracts.py
+
+Parser Contracts
+
+Interfaces for query parameter extractors.
+Follows DEV_GUIDELINES.md: contracts.py for all interfaces.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.0.1.16
+Generation Date: 09-Oct-2025
+"""
+
+from abc import ABC, abstractmethod
+from typing import Dict, Any
+
+
+class IParamExtractor(ABC):
+    """
+    Interface for parameter extractors.
+    
+    Extracts structured parameters from query strings.
+    """
+    
+    @abstractmethod
+    def extract_params(self, query: str, action_type: str) -> Dict[str, Any]:
+        """
+        Extract structured parameters from query.
+        
+        Args:
+            query: Raw query string
+            action_type: Type of action (SELECT, INSERT, etc.)
+        
+        Returns:
+            Structured parameters dictionary
+        """
+        pass
+    
+    @abstractmethod
+    def can_parse(self, query: str) -> bool:
+        """Check if this extractor can parse the query."""
+        pass
+

exonware/xwnode/queries/parsers/errors.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""
+#exonware/xwnode/src/exonware/xwnode/queries/parsers/errors.py
+
+Parser Errors
+
+Module-specific errors for query parsers.
+Extends root error classes per DEV_GUIDELINES.md - no redundancy.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.0.1.16
+Generation Date: 09-Oct-2025
+"""
+
+# Import and REUSE root error classes per DEV_GUIDELINES
+from ...errors import XWNodeError, XWNodeValueError
+
+
+class ParserError(XWNodeError):
+    """
+    Base error for parser operations.
+    
+    Extends XWNodeError from root - follows DEV_GUIDELINES principle.
+    """
+    pass
+
+
+class ParseError(ParserError):
+    """Raised when query parsing fails."""
+    
+    def __init__(self, query: str, reason: str, position: int = None):
+        message = f"Failed to parse query: {reason}"
+        if position is not None:
+            message += f" at position {position}"
+        super().__init__(message)
+        self.query = query
+        self.reason = reason
+        self.position = position
+
+
+class UnsupportedSyntaxError(ParserError):
+    """Raised when syntax is not supported."""
+    pass
+
+
+__all__ = [
+    'ParserError',
+    'ParseError',
+    'UnsupportedSyntaxError',
+]
+