hammad-python 0.0.29__tar.gz → 0.0.31__tar.gz

{hammad_python-0.0.29 → hammad_python-0.0.31}/.gitignore

@@ -11,6 +11,8 @@ dev/
 # For Dev
 tester.py
 .z/
+# internal publisih script
+publish.sh
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

{hammad_python-0.0.29 → hammad_python-0.0.31}/PKG-INFO

@@ -1,6 +1,7 @@
 Metadata-Version: 2.4
 Name: hammad-python
-Version: 0.0.29
+Version: 0.0.31
+Summary: Personal Python utilities and tools
 Author-email: Hammad Saeed <hammadaidev@gmail.com>
 License: MIT License
         
@@ -25,37 +26,10 @@ License: MIT License
         SOFTWARE.
 License-File: LICENSE
 Requires-Python: >=3.11
-Requires-Dist: ddgs>=9.0.0
-Requires-Dist: fasta2a>=0.5.0
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: msgspec>=0.19.0
-Requires-Dist: nest-asyncio>=1.6.0
-Requires-Dist: pydantic>=2.11.7
-Requires-Dist: rich>=14.0.0
-Requires-Dist: selectolax>=0.3.31
-Requires-Dist: sqlalchemy>=2.0.41
-Requires-Dist: tantivy>=0.24.0
-Requires-Dist: tenacity>=8.2.3
-Requires-Dist: typing-inspect>=0.9.0
-Provides-Extra: ai
-Requires-Dist: instructor>=1.9.0; extra == 'ai'
-Requires-Dist: litellm>=1.73.6; extra == 'ai'
-Requires-Dist: qdrant-client>=1.14.3; extra == 'ai'
-Provides-Extra: genai
-Requires-Dist: fastapi>=0.115.6; extra == 'genai'
-Requires-Dist: instructor>=1.9.0; extra == 'genai'
-Requires-Dist: litellm>=1.73.6; extra == 'genai'
-Requires-Dist: mcp>=1.10.1; extra == 'genai'
-Requires-Dist: pydantic-graph>=0.4.2; extra == 'genai'
-Requires-Dist: qdrant-client>=1.14.3; extra == 'genai'
-Requires-Dist: uvicorn>=0.34.0; extra == 'genai'
-Provides-Extra: graph
-Requires-Dist: pydantic-graph>=0.4.2; extra == 'graph'
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.10.1; extra == 'mcp'
-Provides-Extra: serve
-Requires-Dist: fastapi>=0.115.6; extra == 'serve'
-Requires-Dist: uvicorn>=0.34.0; extra == 'serve'
+Requires-Dist: hammad-python-core>=0.0.1
+Requires-Dist: hammad-python-data>=0.0.1
+Requires-Dist: hammad-python-genai>=0.0.1
+Requires-Dist: hammad-python-http>=0.0.1
 Description-Content-Type: text/markdown
 
 ## hammad-python

{hammad_python-0.0.29 → hammad_python-0.0.31/deprecated}/hammad/data/collections/collection.py

@@ -226,9 +226,7 @@ def create_collection(
     distance_metric: "DistanceMetric" = "dot",
     settings: Optional["QdrantCollectionIndexSettings"] = None,
     query_settings: Optional["QdrantCollectionIndexQuerySettings"] = None,
-    embedding_model: Optional[
-        "EmbeddingModelName"
-    ] = "openai/text-embedding-3-small",
+    embedding_model: Optional["EmbeddingModelName"] = "openai/text-embedding-3-small",
     embedding_dimensions: Optional[int] = None,
     embedding_api_key: Optional[str] = None,
     embedding_base_url: Optional[str] = None,
@@ -260,9 +258,7 @@ def create_collection(
     ] = None,
     # Vector/Qdrant-specific parameters
     distance_metric: "DistanceMetric" = "dot",
-    embedding_model: Optional[
-        "EmbeddingModelName"
-    ] = "openai/text-embedding-3-small",
+    embedding_model: Optional["EmbeddingModelName"] = "openai/text-embedding-3-small",
     embedding_dimensions: Optional[int] = None,
     embedding_api_key: Optional[str] = None,
     embedding_base_url: Optional[str] = None,

{hammad_python-0.0.29 → hammad_python-0.0.31/deprecated}/hammad/formatting/__init__.py

@@ -5,15 +5,9 @@ from .._internal import create_getattr_importer
 
 if TYPE_CHECKING:
     from . import json
-    from .json import (
-        convert_to_json_schema
-    )
+    from .json import convert_to_json_schema
     from . import text
-    from .text import (
-        convert_to_text,
-        convert_type_to_text,
-        convert_docstring_to_text
-    )
+    from .text import convert_to_text, convert_type_to_text, convert_docstring_to_text
     from . import yaml
 
 __all__ = (

{hammad_python-0.0.29 → hammad_python-0.0.31/deprecated}/hammad/genai/a2a/__init__.py

@@ -5,9 +5,7 @@ from ..._internal import create_getattr_importer
 
 
 if TYPE_CHECKING:
-    from fasta2a import (
-        FastA2A
-    )
+    from fasta2a import FastA2A
     from .workers import (
         as_a2a_app,
         GraphWorker,
@@ -29,4 +27,4 @@ __getattr__ = create_getattr_importer(__all__)
 
 
 def __dir__() -> list[str]:
-    return list(__all__)
+    return list(__all__)

{hammad_python-0.0.29 → hammad_python-0.0.31/deprecated}/hammad/genai/graphs/_utils.py

@@ -1,4 +1,3 @@
-
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
@@ -9,31 +8,39 @@ def visualize_base_graph(graph: "BaseGraph", filename: str) -> None:
     """Generate a visualization of the graph with clean, readable flow."""
     if not graph._action_nodes or not graph._start_action_name:
         raise ValueError("No actions defined in graph")
-    
+
     # Build our own mermaid code for better control over layout
     mermaid_lines = ["graph TD"]  # Top-Down layout
-    
+
     # Track which nodes we've already added
     added_nodes = set()
-    
+
     # Style definitions
     mermaid_lines.append("    %% Styles")
-    mermaid_lines.append("    classDef startNode fill:#4CAF50,stroke:#333,stroke-width:2px,color:#fff")
-    mermaid_lines.append("    classDef endNode fill:#f44336,stroke:#333,stroke-width:2px,color:#fff")
-    mermaid_lines.append("    classDef defaultNode fill:#2196F3,stroke:#333,stroke-width:2px,color:#fff")
+    mermaid_lines.append(
+        "    classDef startNode fill:#4CAF50,stroke:#333,stroke-width:2px,color:#fff"
+    )
+    mermaid_lines.append(
+        "    classDef endNode fill:#f44336,stroke:#333,stroke-width:2px,color:#fff"
+    )
+    mermaid_lines.append(
+        "    classDef defaultNode fill:#2196F3,stroke:#333,stroke-width:2px,color:#fff"
+    )
     mermaid_lines.append("")
-    
+
     # Helper to get clean node ID
     def get_node_id(action_name: str) -> str:
         return action_name.replace(" ", "_").replace("-", "_")
-    
+
     # Helper to add a node if not already added
-    def add_node(action_name: str, is_start: bool = False, is_end: bool = False) -> None:
+    def add_node(
+        action_name: str, is_start: bool = False, is_end: bool = False
+    ) -> None:
         if action_name not in added_nodes:
             node_id = get_node_id(action_name)
             # Use the action name as the display label
             display_name = action_name
-            
+
             if is_start:
                 mermaid_lines.append(f"    {node_id}[{display_name}]:::startNode")
             elif is_end:
@@ -41,32 +48,32 @@ def visualize_base_graph(graph: "BaseGraph", filename: str) -> None:
             else:
                 mermaid_lines.append(f"    {node_id}[{display_name}]:::defaultNode")
             added_nodes.add(action_name)
-    
+
     # Add all nodes and connections
     mermaid_lines.append("    %% Nodes and connections")
-    
+
     # Start with the start node
     add_node(graph._start_action_name, is_start=True)
-    
+
     # Process all actions to find connections
     for action_name in graph._action_nodes:
         action_func = getattr(graph, action_name, None)
-        if action_func and hasattr(action_func, '_action_settings'):
+        if action_func and hasattr(action_func, "_action_settings"):
             settings = action_func._action_settings
-            
+
             # Add the node
             add_node(action_name, is_end=settings.terminates)
-            
+
             # Add connections based on 'next' settings
             if settings.next:
                 source_id = get_node_id(action_name)
-                
+
                 if isinstance(settings.next, str):
                     # Simple string case
                     target_id = get_node_id(settings.next)
                     add_node(settings.next)
                     mermaid_lines.append(f"    {source_id} --> {target_id}")
-                    
+
                 elif isinstance(settings.next, list):
                     # List case - branches to multiple nodes
                     for next_action in settings.next:
@@ -74,14 +81,19 @@ def visualize_base_graph(graph: "BaseGraph", filename: str) -> None:
                             target_id = get_node_id(next_action)
                             add_node(next_action)
                             mermaid_lines.append(f"    {source_id} --> {target_id}")
-                            
-                elif hasattr(settings.next, '__class__') and settings.next.__class__.__name__ == 'SelectionStrategy':
+
+                elif (
+                    hasattr(settings.next, "__class__")
+                    and settings.next.__class__.__name__ == "SelectionStrategy"
+                ):
                     # SelectionStrategy case
                     if settings.next.actions:
                         # Show all possible paths with a decision diamond
                         decision_id = f"{source_id}_decision"
-                        mermaid_lines.append(f"    {source_id} --> {decision_id}{{LLM Selection}}")
-                        
+                        mermaid_lines.append(
+                            f"    {source_id} --> {decision_id}{{LLM Selection}}"
+                        )
+
                         for next_action in settings.next.actions:
                             target_id = get_node_id(next_action)
                             add_node(next_action)
@@ -90,101 +102,116 @@ def visualize_base_graph(graph: "BaseGraph", filename: str) -> None:
                         # If no specific actions, it can go to any node
                         # For visualization, show connections to all non-start nodes
                         decision_id = f"{source_id}_decision"
-                        mermaid_lines.append(f"    {source_id} --> {decision_id}{{LLM Selection}}")
-                        
+                        mermaid_lines.append(
+                            f"    {source_id} --> {decision_id}{{LLM Selection}}"
+                        )
+
                         for other_action in graph._action_nodes:
-                            if other_action != action_name and other_action != graph._start_action_name:
+                            if (
+                                other_action != action_name
+                                and other_action != graph._start_action_name
+                            ):
                                 target_id = get_node_id(other_action)
                                 add_node(other_action)
-                                mermaid_lines.append(f"    {decision_id} -.-> {target_id}")
-    
+                                mermaid_lines.append(
+                                    f"    {decision_id} -.-> {target_id}"
+                                )
+
     # If start node has no explicit next, but there are other nodes, show possible connections
     start_func = getattr(graph, graph._start_action_name, None)
-    if start_func and hasattr(start_func, '_action_settings'):
+    if start_func and hasattr(start_func, "_action_settings"):
         if not start_func._action_settings.next and len(graph._action_nodes) > 1:
             source_id = get_node_id(graph._start_action_name)
             # Find end nodes (terminates=True) to connect to
             for action_name in graph._action_nodes:
                 if action_name != graph._start_action_name:
                     action_func = getattr(graph, action_name, None)
-                    if action_func and hasattr(action_func, '_action_settings'):
+                    if action_func and hasattr(action_func, "_action_settings"):
                         if action_func._action_settings.terminates:
                             target_id = get_node_id(action_name)
                             add_node(action_name, is_end=True)
                             mermaid_lines.append(f"    {source_id} --> {target_id}")
-    
+
     # Join all lines
     mermaid_code = "\n".join(mermaid_lines)
-    
+
     # Render the mermaid diagram and save it
     try:
         import subprocess
         import tempfile
         import os
         import shutil
-        
+
         # Check if mmdc (mermaid CLI) is available
-        if shutil.which('mmdc') is None:
-            raise FileNotFoundError("mermaid-cli (mmdc) not found. Install with: npm install -g @mermaid-js/mermaid-cli")
-        
+        if shutil.which("mmdc") is None:
+            raise FileNotFoundError(
+                "mermaid-cli (mmdc) not found. Install with: npm install -g @mermaid-js/mermaid-cli"
+            )
+
         # Create a temporary mermaid file
-        with tempfile.NamedTemporaryFile(mode='w', suffix='.mmd', delete=False) as temp_file:
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".mmd", delete=False
+        ) as temp_file:
             temp_file.write(mermaid_code)
             temp_mmd_path = temp_file.name
-        
+
         try:
             # Determine output format from filename extension
-            output_format = 'png'  # default
-            if filename.lower().endswith('.svg'):
-                output_format = 'svg'
-            elif filename.lower().endswith('.pdf'):
-                output_format = 'pdf'
-            
+            output_format = "png"  # default
+            if filename.lower().endswith(".svg"):
+                output_format = "svg"
+            elif filename.lower().endswith(".pdf"):
+                output_format = "pdf"
+
             # Use mermaid CLI to render the diagram
-            cmd = ['mmdc', '-i', temp_mmd_path, '-o', filename]
-            
+            cmd = ["mmdc", "-i", temp_mmd_path, "-o", filename]
+
             # Add format flag only if not PNG (PNG is default)
-            if output_format != 'png':
-                cmd.extend(['-f', output_format])
-            
+            if output_format != "png":
+                cmd.extend(["-f", output_format])
+
             # Add theme and background color
-            cmd.extend(['-t', 'default', '-b', 'transparent'])
-            
+            cmd.extend(["-t", "default", "-b", "transparent"])
+
             result = subprocess.run(cmd, capture_output=True, text=True, check=True)
-            
+
             if result.returncode == 0:
                 print(f"Graph visualization saved to: {filename}")
             else:
-                raise subprocess.CalledProcessError(result.returncode, result.args, result.stderr)
-                
+                raise subprocess.CalledProcessError(
+                    result.returncode, result.args, result.stderr
+                )
+
         finally:
             # Clean up temporary file
             if os.path.exists(temp_mmd_path):
                 os.unlink(temp_mmd_path)
-                
+
     except FileNotFoundError as e:
         # Provide helpful error message for missing mermaid CLI
         print(f"Warning: {e}")
         # Save as .mmd file instead
-        mmd_filename = filename.rsplit('.', 1)[0] + '.mmd'
+        mmd_filename = filename.rsplit(".", 1)[0] + ".mmd"
         with open(mmd_filename, "w") as f:
             f.write(mermaid_code)
         print(f"Mermaid code saved to: {mmd_filename}")
-        print("To render as PNG, install mermaid-cli: npm install -g @mermaid-js/mermaid-cli")
-        
+        print(
+            "To render as PNG, install mermaid-cli: npm install -g @mermaid-js/mermaid-cli"
+        )
+
     except subprocess.CalledProcessError as e:
         # Handle mermaid CLI errors
         print(f"Error rendering mermaid diagram: {e.stderr if e.stderr else str(e)}")
         # Save as .mmd file as fallback
-        mmd_filename = filename.rsplit('.', 1)[0] + '.mmd'
+        mmd_filename = filename.rsplit(".", 1)[0] + ".mmd"
         with open(mmd_filename, "w") as f:
             f.write(mermaid_code)
         print(f"Mermaid code saved to: {mmd_filename} (rendering failed)")
-        
+
     except Exception as e:
         # General fallback: save the mermaid code
         print(f"Unexpected error: {e}")
-        mmd_filename = filename.rsplit('.', 1)[0] + '.mmd'
+        mmd_filename = filename.rsplit(".", 1)[0] + ".mmd"
         with open(mmd_filename, "w") as f:
             f.write(mermaid_code)
-        print(f"Mermaid code saved to: {mmd_filename}")
+        print(f"Mermaid code saved to: {mmd_filename}")

{hammad_python-0.0.29 → hammad_python-0.0.31/deprecated}/hammad/genai/graphs/base.py

@@ -826,13 +826,21 @@ class ActionDecorator:
 
         def decorator(f: Callable) -> Callable:
             action_name = name or f.__name__
-            
+
             # Check if action name is reserved
             reserved_names = {
-                'run', 'async_run', 'iter', 'async_iter', 
-                'visualize', 'builder', 'as_a2a',
-                '_initialize', '_collect_state_class', '_collect_actions',
-                '_create_pydantic_graph', '_get_start_action_signature'
+                "run",
+                "async_run",
+                "iter",
+                "async_iter",
+                "visualize",
+                "builder",
+                "as_a2a",
+                "_initialize",
+                "_collect_state_class",
+                "_collect_actions",
+                "_create_pydantic_graph",
+                "_get_start_action_signature",
             }
             if action_name in reserved_names:
                 raise ValueError(
@@ -840,10 +848,10 @@ class ActionDecorator:
                     f"Reserved names include: {', '.join(sorted(reserved_names))}. "
                     "Please choose a different name for your action."
                 )
-            
+
             # Check that the action has at least one parameter besides 'self'
             sig = inspect.signature(f)
-            params = [p for p in sig.parameters if p != 'self']
+            params = [p for p in sig.parameters if p != "self"]
             if not params:
                 raise ValueError(
                     f"Action '{action_name}' must have at least one parameter besides 'self'. "
@@ -1184,7 +1192,7 @@ class BaseGraph(Generic[StateT, T]):
         # Merge global settings with provided kwargs
         merged_settings = self._global_settings.copy()
         merged_settings.update(language_model_kwargs)
-        
+
         # Include the global model if it's set and not overridden
         if self._global_model and "model" not in merged_settings:
             merged_settings["model"] = self._global_model
@@ -1357,7 +1365,7 @@ class BaseGraph(Generic[StateT, T]):
         # Merge global settings with provided kwargs
         merged_settings = self._global_settings.copy()
         merged_settings.update(language_model_kwargs)
-        
+
         # Include the global model if it's set and not overridden
         if self._global_model and "model" not in merged_settings:
             merged_settings["model"] = self._global_model
@@ -1498,7 +1506,7 @@ class BaseGraph(Generic[StateT, T]):
         # Merge global settings with provided kwargs
         merged_settings = self._global_settings.copy()
         merged_settings.update(language_model_kwargs)
-        
+
         # Include the global model if it's set and not overridden
         if self._global_model and "model" not in merged_settings:
             merged_settings["model"] = self._global_model
@@ -1670,7 +1678,7 @@ class BaseGraph(Generic[StateT, T]):
         # Merge global settings with provided kwargs
         merged_settings = self._global_settings.copy()
         merged_settings.update(language_model_kwargs)
-        
+
         # Include the global model if it's set and not overridden
         if self._global_model and "model" not in merged_settings:
             merged_settings["model"] = self._global_model
@@ -1825,4 +1833,4 @@ class BaseGraph(Generic[StateT, T]):
             None
 
         """
-        visualize_base_graph(self, filename)
+        visualize_base_graph(self, filename)