exonware-xwnode 0.0.1.22__py3-none-any.whl → 0.0.1.24__py3-none-any.whl

exonware/xwnode/nodes/strategies/aho_corasick.py

@@ -27,7 +27,7 @@ class ACNode:
         return len(self.children) == 0
 
 
-class xAhoCorasickStrategy(ANodeTreeStrategy):
+class AhoCorasickStrategy(ANodeTreeStrategy):
     """
     Aho-Corasick node strategy for multi-pattern string matching.
     
@@ -41,9 +41,7 @@ or linear-time matching.
     
     def __init__(self, traits: NodeTrait = NodeTrait.NONE, **options):
         """Initialize the Aho-Corasick strategy."""
-        super().__init__(data=None, **options)
-        self._mode = NodeMode.AHO_CORASICK
-        self._traits = traits
+        super().__init__(NodeMode.AHO_CORASICK, traits, **options)
         
         self.case_sensitive = options.get('case_sensitive', True)
         self.enable_overlapping = options.get('enable_overlapping', True)
@@ -55,167 +53,324 @@ or linear-time matching.
         self._pattern_to_index: Dict[str, int] = {}
         self._automaton_built = False
         
-        # Performance tracking
-        self._size_tracker = 0
-        self._access_tracker = 0
+        # Key-value mapping for compatibility
+        self._values: Dict[str, Any] = {}
+        self._size = 0
+        
+        # Statistics
+        self._total_nodes = 1  # Root node
+        self._max_depth = 0
+        self._search_cache: Dict[str, List[Tuple[str, int]]] = {}
     
     def get_supported_traits(self) -> NodeTrait:
         """Get the traits supported by the Aho-Corasick strategy."""
-        return (NodeTrait.ORDERED | NodeTrait.HIERARCHICAL | NodeTrait.INDEXED)
+        return (NodeTrait.ORDERED | NodeTrait.INDEXED | NodeTrait.STREAMING)
+    
+    def _preprocess_pattern(self, pattern: str) -> str:
+        """Preprocess pattern based on settings."""
+        if not self.case_sensitive:
+            pattern = pattern.lower()
+        return pattern
+    
+    def _preprocess_text(self, text: str) -> str:
+        """Preprocess text based on settings."""
+        if not self.case_sensitive:
+            text = text.lower()
+        return text
+    
+    def _add_pattern_to_trie(self, pattern: str, pattern_index: int) -> None:
+        """Add pattern to the trie structure."""
+        current = self._root
+        depth = 0
+        
+        for char in pattern:
+            if char not in current.children:
+                current.children[char] = ACNode()
+                current.children[char].depth = depth + 1
+                self._total_nodes += 1
+            
+            current = current.children[char]
+            depth += 1
+        
+        # Mark end of pattern
+        current.output.add(pattern)
+        current.pattern_indices.add(pattern_index)
+        self._max_depth = max(self._max_depth, depth)
+    
+    def _build_failure_links(self) -> None:
+        """Build failure links using BFS."""
+        queue = deque()
+        
+        # Initialize failure links for root's children
+        for child in self._root.children.values():
+            child.failure = self._root
+            queue.append(child)
+        
+        # Build failure links for all other nodes
+        while queue:
+            current = queue.popleft()
+            
+            for char, child in current.children.items():
+                queue.append(child)
+                
+                # Find the failure link
+                failure_node = current.failure
+                
+                while failure_node is not None and char not in failure_node.children:
+                    failure_node = failure_node.failure
+                
+                if failure_node is not None:
+                    child.failure = failure_node.children[char]
+                else:
+                    child.failure = self._root
+                
+                # Add output from failure node
+                if child.failure:
+                    child.output.update(child.failure.output)
+                    child.pattern_indices.update(child.failure.pattern_indices)
+    
+    def _build_automaton(self) -> None:
+        """Build the complete Aho-Corasick automaton."""
+        if self._automaton_built:
+            return
+        
+        # Build failure links
+        self._build_failure_links()
+        self._automaton_built = True
+        self._search_cache.clear()
+    
+    def _rebuild_automaton(self) -> None:
+        """Rebuild the automaton from scratch."""
+        # Reset automaton
+        self._root = ACNode()
+        self._total_nodes = 1
+        self._max_depth = 0
+        self._automaton_built = False
+        self._search_cache.clear()
+        
+        # Rebuild trie
+        for i, pattern in enumerate(self._patterns):
+            self._add_pattern_to_trie(pattern, i)
+        
+        # Build failure links
+        self._build_automaton()
     
     # ============================================================================
-    # CORE OPERATIONS
+    # CORE OPERATIONS (Key-based interface for compatibility)
     # ============================================================================
     
-    def insert(self, key: Any, value: Any) -> None:
-        """Store a pattern (key should be string-like)."""
+    def put(self, key: Any, value: Any = None) -> None:
+        """Add pattern to automaton."""
         pattern = str(key)
-        if not self.case_sensitive:
-            pattern = pattern.lower()
+        processed_pattern = self._preprocess_pattern(pattern)
         
-        if len(pattern) > self.max_pattern_length:
-            raise ValueError(f"Pattern too long: {len(pattern)} > {self.max_pattern_length}")
+        if len(processed_pattern) > self.max_pattern_length:
+            raise ValueError(f"Pattern length {len(processed_pattern)} exceeds maximum {self.max_pattern_length}")
         
-        if pattern not in self._pattern_to_index:
-            self._patterns.append(pattern)
-            self._pattern_to_index[pattern] = len(self._patterns) - 1
+        if processed_pattern not in self._pattern_to_index:
+            # Add new pattern
+            pattern_index = len(self._patterns)
+            self._patterns.append(processed_pattern)
+            self._pattern_to_index[processed_pattern] = pattern_index
+            
+            # Add to trie
+            self._add_pattern_to_trie(processed_pattern, pattern_index)
             self._automaton_built = False
-            self._size_tracker += 1
+            self._size += 1
+        
+        # Store value
+        self._values[pattern] = value if value is not None else pattern
     
-    def find(self, key: Any) -> Any:
-        """Find pattern index."""
-        pattern = str(key)
-        if not self.case_sensitive:
-            pattern = pattern.lower()
-        return self._pattern_to_index.get(pattern)
+    def get(self, key: Any, default: Any = None) -> Any:
+        """Get value by key."""
+        key_str = str(key)
+        
+        if key_str == "patterns":
+            return self._patterns.copy()
+        elif key_str == "automaton_info":
+            return {
+                'total_nodes': self._total_nodes,
+                'max_depth': self._max_depth,
+                'automaton_built': self._automaton_built,
+                'pattern_count': len(self._patterns)
+            }
+        elif key_str in self._values:
+            return self._values[key_str]
+        
+        return default
     
-    def delete(self, key: Any) -> bool:
-        """Remove a pattern."""
+    def has(self, key: Any) -> bool:
+        """Check if key exists."""
+        key_str = str(key)
+        pattern = self._preprocess_pattern(key_str)
+        return pattern in self._pattern_to_index or key_str in self._values
+    
+    def remove(self, key: Any) -> bool:
+        """Remove pattern (requires automaton rebuild)."""
         pattern = str(key)
-        if not self.case_sensitive:
-            pattern = pattern.lower()
+        processed_pattern = self._preprocess_pattern(pattern)
         
-        if pattern in self._pattern_to_index:
-            index = self._pattern_to_index[pattern]
-            del self._patterns[index]
-            del self._pattern_to_index[pattern]
-            self._automaton_built = False
-            self._size_tracker -= 1
+        if processed_pattern in self._pattern_to_index:
+            # Remove pattern
+            index = self._pattern_to_index[processed_pattern]
+            del self._pattern_to_index[processed_pattern]
+            self._patterns.pop(index)
+            
+            # Update indices
+            for i, p in enumerate(self._patterns):
+                self._pattern_to_index[p] = i
+            
+            # Remove value
+            self._values.pop(pattern, None)
+            self._size -= 1
+            
+            # Rebuild automaton
+            self._rebuild_automaton()
             return True
+        
         return False
     
-    def size(self) -> int:
-        """Get the number of patterns."""
-        return self._size_tracker
-    
-    def is_empty(self) -> bool:
-        """Check if the structure is empty."""
-        return self._size_tracker == 0
-    
-    def to_native(self) -> Dict[str, Any]:
-        """Convert to native Python dictionary."""
-        return {pattern: index for pattern, index in self._pattern_to_index.items()}
+    def delete(self, key: Any) -> bool:
+        """Remove pattern (alias for remove)."""
+        return self.remove(key)
     
-    # ============================================================================
-    # TREE STRATEGY METHODS
-    # ============================================================================
+    def clear(self) -> None:
+        """Clear all patterns."""
+        self._root = ACNode()
+        self._patterns.clear()
+        self._pattern_to_index.clear()
+        self._values.clear()
+        self._search_cache.clear()
+        
+        self._total_nodes = 1
+        self._max_depth = 0
+        self._automaton_built = False
+        self._size = 0
     
-    def traverse(self, order: str = 'inorder') -> List[Any]:
-        """Traverse patterns in specified order."""
-        return self._patterns.copy()
+    def keys(self) -> Iterator[str]:
+        """Get all pattern keys."""
+        for pattern in self._patterns:
+            yield pattern
+        yield "patterns"
+        yield "automaton_info"
     
-    def get_min(self) -> Any:
-        """Get minimum pattern."""
-        return min(self._patterns) if self._patterns else None
+    def values(self) -> Iterator[Any]:
+        """Get all values."""
+        for value in self._values.values():
+            yield value
+        yield self._patterns.copy()
+        yield self.get("automaton_info")
     
-    def get_max(self) -> Any:
-        """Get maximum pattern."""
-        return max(self._patterns) if self._patterns else None
+    def items(self) -> Iterator[tuple[str, Any]]:
+        """Get all key-value pairs."""
+        for key, value in self._values.items():
+            yield (key, value)
+        yield ("patterns", self._patterns.copy())
+        yield ("automaton_info", self.get("automaton_info"))
     
-    # ============================================================================
-    # AUTO-3 Phase 2 methods
-    # ============================================================================
+    def __len__(self) -> int:
+        """Get number of patterns."""
+        return self._size
     
-    def as_trie(self):
-        """Provide Trie behavioral view."""
-        return self
+    def to_native(self) -> Dict[str, Any]:
+        """Convert to native Python dict."""
+        result = dict(self._values)
+        result["patterns"] = self._patterns.copy()
+        result["automaton_info"] = self.get("automaton_info")
+        return result
     
-    def as_heap(self):
-        """Provide Heap behavioral view."""
-        # TODO: Implement Heap view
-        return self
+    @property
+    def is_list(self) -> bool:
+        """This can behave like a list for pattern access."""
+        return True
     
-    def as_skip_list(self):
-        """Provide SkipList behavioral view."""
-        # TODO: Implement SkipList view
-        return self
+    @property
+    def is_dict(self) -> bool:
+        """This behaves like a dict."""
+        return True
     
     # ============================================================================
     # AHO-CORASICK SPECIFIC OPERATIONS
     # ============================================================================
     
     def add_pattern(self, pattern: str, metadata: Any = None) -> None:
-        """Add a pattern to the automaton."""
-        self.insert(pattern, metadata)
+        """Add pattern with optional metadata."""
+        self.put(pattern, metadata)
     
     def search_text(self, text: str) -> List[Tuple[str, int, Any]]:
-        """Search for all patterns in the given text."""
-        if not self._automaton_built:
-            self._build_automaton()
+        """Search for all pattern matches in text."""
+        if not text or not self._patterns:
+            return []
+        
+        # Check cache
+        cache_key = text[:100]  # Cache based on first 100 chars
+        if cache_key in self._search_cache and len(text) <= 100:
+            return self._search_cache[cache_key]
         
-        results = []
+        processed_text = self._preprocess_text(text)
+        self._build_automaton()
+        
+        matches = []
         current = self._root
         
-        for i, char in enumerate(text):
-            if not self.case_sensitive:
-                char = char.lower()
-            
-            # Follow failure links if needed
-            while current != self._root and char not in current.children:
+        for i, char in enumerate(processed_text):
+            # Follow failure links until we find a valid transition
+            while current is not None and char not in current.children:
                 current = current.failure
             
-            # Move to next state
-            if char in current.children:
-                current = current.children[char]
+            if current is None:
+                current = self._root
+                continue
             
-            # Check for matches
+            current = current.children[char]
+            
+            # Report all patterns that end at this position
             for pattern in current.output:
-                pattern_index = self._pattern_to_index[pattern]
-                results.append((pattern, i - len(pattern) + 1, pattern_index))
+                start_pos = i - len(pattern) + 1
+                metadata = self._values.get(pattern, None)
+                matches.append((pattern, start_pos, metadata))
+        
+        # Cache small results
+        if len(text) <= 100:
+            self._search_cache[cache_key] = matches
         
-        return results
+        return matches
     
     def find_all_matches(self, text: str) -> Dict[str, List[int]]:
-        """Find all matches grouped by pattern."""
+        """Find all positions where each pattern matches."""
         matches = self.search_text(text)
         result = defaultdict(list)
         
         for pattern, position, _ in matches:
             result[pattern].append(position)
         
+        # Convert to regular dict
         return dict(result)
     
     def count_matches(self, text: str) -> Dict[str, int]:
-        """Count matches for each pattern."""
-        all_matches = self.find_all_matches(text)
-        return {pattern: len(positions) for pattern, positions in all_matches.items()}
+        """Count occurrences of each pattern."""
+        matches = self.find_all_matches(text)
+        return {pattern: len(positions) for pattern, positions in matches.items()}
     
     def has_any_match(self, text: str) -> bool:
-        """Check if any pattern matches in the text."""
-        if not self._automaton_built:
-            self._build_automaton()
+        """Check if text contains any of the patterns."""
+        if not text or not self._patterns:
+            return False
+        
+        processed_text = self._preprocess_text(text)
+        self._build_automaton()
         
         current = self._root
         
-        for char in text:
-            if not self.case_sensitive:
-                char = char.lower()
-            
-            while current != self._root and char not in current.children:
+        for char in processed_text:
+            while current is not None and char not in current.children:
                 current = current.failure
             
-            if char in current.children:
-                current = current.children[char]
+            if current is None:
+                current = self._root
+                continue
+            
+            current = current.children[char]
             
             if current.output:
                 return True
@@ -223,104 +378,113 @@ or linear-time matching.
         return False
     
     def find_longest_match(self, text: str) -> Optional[Tuple[str, int, int]]:
-        """Find the longest matching pattern."""
+        """Find the longest pattern match in text."""
         matches = self.search_text(text)
+        
         if not matches:
             return None
         
-        # Find the longest match
         longest = max(matches, key=lambda x: len(x[0]))
-        return (longest[0], longest[1], longest[1] + len(longest[0]) - 1)
+        pattern, start_pos, _ = longest
+        return pattern, start_pos, len(pattern)
     
     def replace_patterns(self, text: str, replacement_func: callable = None) -> str:
         """Replace all pattern matches in text."""
+        if not replacement_func:
+            replacement_func = lambda pattern, metadata: f"[{pattern}]"
+        
         matches = self.search_text(text)
+        
         if not matches:
             return text
         
-        # Sort matches by position (descending) to replace from end to start
+        # Sort matches by position (descending) to avoid index shifts
         matches.sort(key=lambda x: x[1], reverse=True)
         
         result = text
-        for pattern, position, _ in matches:
-            if replacement_func:
-                replacement = replacement_func(pattern, position)
-            else:
-                replacement = f"[{pattern}]"
-            
-            result = result[:position] + replacement + result[position + len(pattern):]
+        for pattern, start_pos, metadata in matches:
+            end_pos = start_pos + len(pattern)
+            replacement = replacement_func(pattern, metadata)
+            result = result[:start_pos] + replacement + result[end_pos:]
         
         return result
     
-    def _build_automaton(self) -> None:
-        """Build the Aho-Corasick automaton."""
-        # Build trie
-        for pattern in self._patterns:
-            self._add_pattern_to_trie(pattern)
+    def get_pattern_statistics(self) -> Dict[str, Any]:
+        """Get statistics about patterns and automaton."""
+        if not self._patterns:
+            return {'pattern_count': 0, 'total_nodes': 1, 'avg_pattern_length': 0}
         
-        # Build failure links
-        self._build_failure_links()
+        pattern_lengths = [len(p) for p in self._patterns]
+        unique_chars = set()
+        for pattern in self._patterns:
+            unique_chars.update(pattern)
         
-        self._automaton_built = True
+        return {
+            'pattern_count': len(self._patterns),
+            'total_nodes': self._total_nodes,
+            'max_depth': self._max_depth,
+            'avg_pattern_length': sum(pattern_lengths) / len(pattern_lengths),
+            'min_pattern_length': min(pattern_lengths),
+            'max_pattern_length': max(pattern_lengths),
+            'unique_characters': len(unique_chars),
+            'alphabet_size': len(unique_chars),
+            'automaton_built': self._automaton_built,
+            'cache_size': len(self._search_cache)
+        }
     
-    def _add_pattern_to_trie(self, pattern: str, pattern_index: int) -> None:
-        """Add a pattern to the trie."""
-        current = self._root
+    def validate_automaton(self) -> bool:
+        """Validate the automaton structure."""
+        self._build_automaton()
         
-        for char in pattern:
-            if char not in current.children:
-                current.children[char] = ACNode()
-                current.children[char].depth = current.depth + 1
+        def _validate_node(node: ACNode, visited: Set[ACNode]) -> bool:
+            if node in visited:
+                return True
             
-            current = current.children[char]
+            visited.add(node)
+            
+            # Check failure link
+            if node != self._root and node.failure is None:
+                return False
+            
+            # Check children
+            for child in node.children.values():
+                if not _validate_node(child, visited):
+                    return False
+            
+            return True
         
-        current.output.add(pattern)
-        current.pattern_indices.add(pattern_index)
+        return _validate_node(self._root, set())
     
-    def _build_failure_links(self) -> None:
-        """Build failure links using BFS."""
-        queue = deque()
+    def export_automaton(self) -> Dict[str, Any]:
+        """Export automaton structure for analysis."""
+        self._build_automaton()
         
-        # Initialize failure links for root's children
-        for child in self._root.children.values():
-            child.failure = self._root
-            queue.append(child)
+        def _export_node(node: ACNode, node_id: int) -> Dict[str, Any]:
+            return {
+                'id': node_id,
+                'depth': node.depth,
+                'children': list(node.children.keys()),
+                'output': list(node.output),
+                'has_failure': node.failure is not None
+            }
         
-        # Build failure links for remaining nodes
-        while queue:
-            current = queue.popleft()
+        nodes = []
+        node_queue = deque([(self._root, 0)])
+        node_id = 0
+        
+        while node_queue:
+            node, current_id = node_queue.popleft()
+            nodes.append(_export_node(node, current_id))
             
-            for char, child in current.children.items():
-                queue.append(child)
-                
-                # Find failure link
-                failure = current.failure
-                while failure != self._root and char not in failure.children:
-                    failure = failure.failure
-                
-                if char in failure.children:
-                    child.failure = failure.children[char]
-                else:
-                    child.failure = self._root
-                
-                # Merge output sets
-                child.output.update(child.failure.output)
-    
-    # ============================================================================
-    # ITERATION
-    # ============================================================================
-    
-    def keys(self) -> Iterator[str]:
-        """Get all patterns."""
-        return iter(self._patterns)
-    
-    def values(self) -> Iterator[Any]:
-        """Get all pattern indices."""
-        return iter(range(len(self._patterns)))
-    
-    def items(self) -> Iterator[tuple[str, Any]]:
-        """Get all pattern-index pairs."""
-        return ((pattern, index) for pattern, index in self._pattern_to_index.items())
+            for child in node.children.values():
+                node_id += 1
+                node_queue.append((child, node_id))
+        
+        return {
+            'nodes': nodes,
+            'patterns': self._patterns.copy(),
+            'statistics': self.get_pattern_statistics()
+        }
     
     # ============================================================================
     # PERFORMANCE CHARACTERISTICS
@@ -331,20 +495,31 @@ or linear-time matching.
         """Get backend implementation info."""
         return {
             'strategy': 'AHO_CORASICK',
-            'backend': 'Aho-Corasick automaton',
+            'backend': 'Finite automaton with failure links',
+            'case_sensitive': self.case_sensitive,
+            'enable_overlapping': self.enable_overlapping,
+            'max_pattern_length': self.max_pattern_length,
             'complexity': {
-                'build': 'O(sum of pattern lengths)',
-                'search': 'O(text length + number of matches)',
-                'space': 'O(sum of pattern lengths)'
+                'construction': 'O(Σ|patterns|)',  # Σ = alphabet size
+                'search': 'O(|text| + |matches|)',
+                'space': 'O(Σ|patterns|)',
+                'pattern_addition': 'O(|pattern|)',
+                'pattern_removal': 'O(Σ|patterns|)'  # Requires rebuild
             }
         }
     
     @property
     def metrics(self) -> Dict[str, Any]:
         """Get performance metrics."""
+        stats = self.get_pattern_statistics()
+        
         return {
-            'patterns': len(self._patterns),
-            'automaton_built': self._automaton_built,
-            'case_sensitive': self.case_sensitive,
-            'max_pattern_length': self.max_pattern_length
+            'patterns': stats['pattern_count'],
+            'nodes': stats['total_nodes'],
+            'max_depth': stats['max_depth'],
+            'avg_pattern_length': f"{stats['avg_pattern_length']:.1f}",
+            'alphabet_size': stats['alphabet_size'],
+            'automaton_built': stats['automaton_built'],
+            'cache_entries': stats['cache_size'],
+            'memory_usage': f"{stats['total_nodes'] * 100 + len(self._patterns) * 50} bytes (estimated)"
         }