hammad-python 0.0.18__py3-none-any.whl → 0.0.20__py3-none-any.whl

hammad/__init__.py

@@ -6,148 +6,33 @@ from typing import TYPE_CHECKING
 from ._internal import create_getattr_importer as __hammad_importer__
 
 if TYPE_CHECKING:
-
     # hammad.cache
-    from .cache import (
-        cached,
-        Cache
-    )
+    from .cache import cached, Cache
 
     # hammad.cli
-    from .cli import (
-        print,
-        animate,
-        input
-    )
-
-    # hammad.data
-    from .data.configurations import (
-        Configuration,
-        read_configuration_from_file,
-        read_configuration_from_url,
-        read_configuration_from_os_vars,
-        read_configuration_from_os_prefix,
-        read_configuration_from_dotenv
-    )
-    from .data.collections.collection import (
-        Collection,
-        create_collection
-    )
-    from .data.models import (
-        Model,
-        field,
-        validator,
-        model_settings,
-        convert_to_pydantic_model,
-        convert_to_pydantic_field,
-    )
-    from .data.types import (
-        Audio,
-        Image,
-        Text
-    )
+    from .cli import print, animate, input
 
     # hammad.formatting
-    from .formatting.json import (
-        convert_to_json_schema
-    )
-    from .formatting.text import (
-        convert_to_text,
-        convert_type_to_text
-    )
-
-    # hammad.genai
-    from .genai.embedding_models import (
-        EmbeddingModel,
-        run_embedding_model,
-        async_run_embedding_model
-    )
-    from .genai.language_models import (
-        LanguageModel,
-        run_language_model,
-        async_run_language_model
-    )
+    from .formatting.json import convert_to_json_schema
+    from .formatting.text import convert_to_text, convert_type_to_text
 
     # hammad.logging
-    from .logging.logger import (
-        Logger,
-        create_logger
-    )
-    from .logging.decorators import (
-        trace,
-        trace_cls,
-        trace_function,
-        trace_http
-    )
-    
-    # hammad.service
-    from .service.decorators import (
-        serve as serve_function,
-        serve_mcp as serve_function_as_mcp
-    )
-
-    # hammad.web
-    from .web.http.client import (
-        create_http_client
-    )
-    from .web.openapi.client import (
-        create_openapi_client
-    )
-    from .web.search.client import (
-        create_search_client
-    )
-    from .web.utils import (
-        run_web_request,
-        read_web_page,
-        read_web_pages,
-        run_news_search,
-        run_web_search,
-        extract_web_page_links,
-    )
+    from .logging.logger import Logger, create_logger
+    from .logging.decorators import trace, trace_cls, trace_function, trace_http
 
 
 __all__ = [
     # hammad.cache
     "cached",
     "Cache",
-
     # hammad.cli
     "print",
     "animate",
     "input",
-
-    # hammad.data
-    "Configuration",
-    "read_configuration_from_file",
-    "read_configuration_from_url",
-    "read_configuration_from_os_vars",
-    "read_configuration_from_os_prefix",
-    "read_configuration_from_dotenv",
-    "Collection",
-    "create_collection",
-    "Model",
-    "field",
-    "validator",
-    "model_settings",
-    "convert_to_pydantic_model",
-    "convert_to_pydantic_field",
-    "Audio",
-    "Image",
-    "Text",
-
     # hammad.formatting
     "convert_to_json_schema",
     "convert_to_text",
     "convert_type_to_text",
-
-    # hammad.genai
-    "EmbeddingModel",
-    "run_embedding_model",
-    "async_run_embedding_model",
-    "LanguageModel",
-    "run_language_model",
-    "async_run_language_model",
-
     # hammad.logging
     "Logger",
     "create_logger",
@@ -155,21 +40,6 @@ __all__ = [
     "trace_cls",
     "trace_function",
     "trace_http",
-
-    # hammad.service
-    "serve_function",
-    "serve_function_as_mcp",
-    
-    # hammad.web
-    "create_http_client",
-    "create_openapi_client",
-    "create_search_client",
-    "run_web_request",
-    "read_web_page",
-    "read_web_pages",
-    "run_web_search",
-    "run_news_search",
-    "extract_web_page_links",
 ]
 
 
@@ -177,4 +47,4 @@ __getattr__ = __hammad_importer__(__all__)
 
 
 def __dir__() -> list[str]:
-    return __all__
+    return __all__

hammad/_internal.py

@@ -9,6 +9,7 @@ import hashlib
 
 # pretty
 from rich.traceback import install
+
 install()
 
 __all__ = ("create_getattr_importer",)

hammad/cli/_runner.py

@@ -35,10 +35,7 @@ if TYPE_CHECKING:
     )
 
 
-__all__ = (
-    "CLIRunner",
-)
-
+__all__ = ("CLIRunner",)
 
 
 class CLIRunner:
@@ -54,7 +51,6 @@ class CLIRunner:
         flush: bool = False,
     ) -> None: ...
 
-
     @overload
     @staticmethod
     def print(
@@ -70,7 +66,6 @@ class CLIRunner:
         live: "CLIStyleLiveSettings | int | None" = None,
     ) -> None: ...
 
-
     @staticmethod
     def print(
         *values: object,
@@ -109,6 +104,7 @@ class CLIRunner:
             Live settings object if live=True, otherwise None
         """
         from ..cli import print as _run_cli_print_fn
+
         return _run_cli_print_fn(
             *values,
             sep=sep,
@@ -171,6 +167,7 @@ class CLIRunner:
             The user's input, potentially validated and converted according to the schema.
         """
         from ..cli import input as _run_cli_input_fn
+
         return _run_cli_input_fn(
             prompt=prompt,
             schema=schema,
@@ -188,7 +185,9 @@ class CLIRunner:
     @staticmethod
     def animate(
         renderable: "RenderableType | str",
-        type: Literal["flashing", "pulsing", "shaking", "typing", "spinning", "rainbow"],
+        type: Literal[
+            "flashing", "pulsing", "shaking", "typing", "spinning", "rainbow"
+        ],
         duration: Optional[float] = None,
         # Animation parameters (defaults are handled by the specific animation classes)
         speed: Optional[float] = None,
@@ -239,6 +238,7 @@ class CLIRunner:
             vertical_overflow: How to handle vertical overflow
         """
         from ..cli import animate as _run_cli_animate_fn
+
         _run_cli_animate_fn(
             renderable=renderable,
             type=type,
@@ -262,4 +262,4 @@ class CLIRunner:
             console=console,
             screen=screen,
             vertical_overflow=vertical_overflow,
-        )
+        )

hammad/cli/plugins.py

@@ -159,6 +159,7 @@ def print(
     title: Optional[str] = None,
     expand: Optional[bool] = None,
     live: "CLIStyleLiveSettings | int | None" = None,
+    duration: Optional[float] = None,
     transient: bool = False,
     new_line_start: bool = False,
 ) -> None:
@@ -190,6 +191,7 @@ def print(
         title : Title for panel rendering.
         expand : Whether to expand panel to full width.
         live : A dictionary of live settings or an integer in seconds to run the print in a live renderable.
+        duration : The duration of the live renderable.
         transient : Whether to clear the output after completion.
         new_line_start : Start with a new line before printing.
 
@@ -221,6 +223,7 @@ def print(
         and padding is None
         and title is None
         and expand is None
+        and not transient
     ):
         builtins.print(*values, sep=sep, end=end, file=file, flush=flush)
         return
@@ -250,7 +253,7 @@ def print(
 
             live_settings: CLIStyleLiveSettings = {
                 "duration": float(live),
-                "transient": False,  # Changed to False for testing
+                "transient": transient,  # Use the transient parameter
             }
         else:
             live_settings = live
@@ -281,19 +284,41 @@ def print(
         get_console = _get_rich_console()
         Console, _ = _get_rich_console_classes()
         console = get_console() if file is None else Console(file=file)
-        console.print(
-            styled_content,
-            end=end,
-            justify=justify,
-            overflow=overflow,
-            no_wrap=no_wrap,
-            emoji=emoji,
-            markup=markup,
-            highlight=highlight,
-            width=width,
-            height=height,
-            new_line_start=new_line_start,
-        )
+
+        if transient:
+            # Use Rich's Live with transient for temporary output
+            import time
+            from rich.live import Live
+
+            # Auto-set duration to 2.5 when transient=True and duration is None
+            display_duration = duration if duration is not None else 2.5
+
+            with Live(
+                styled_content,
+                console=console,
+                refresh_per_second=1,
+                transient=True,
+                auto_refresh=False,
+            ) as live:
+                live.update(styled_content)
+                live.refresh()
+                time.sleep(
+                    display_duration
+                )  # Use duration parameter for transient content
+        else:
+            console.print(
+                styled_content,
+                end=end,
+                justify=justify,
+                overflow=overflow,
+                no_wrap=no_wrap,
+                emoji=emoji,
+                markup=markup,
+                highlight=highlight,
+                width=width,
+                height=height,
+                new_line_start=new_line_start,
+            )
 
 
 class InputError(Exception):
@@ -771,10 +796,10 @@ def animate(
         animation = animations["CLIFlashingAnimation"](
             renderable,
             speed=speed if speed is not None else 0.5,
-            colors=colors, # Class handles default if None
+            colors=colors,  # Class handles default if None
             on_color=on_color if on_color is not None else "white",
             off_color=off_color if off_color is not None else "dim white",
-            duration=duration, # Base class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     elif type == "pulsing":
         animation = animations["CLIPulsingAnimation"](
@@ -783,39 +808,43 @@ def animate(
             min_opacity=min_opacity if min_opacity is not None else 0.3,
             max_opacity=max_opacity if max_opacity is not None else 1.0,
             color=color if color is not None else "white",
-            duration=duration, # Base class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     elif type == "shaking":
         animation = animations["CLIShakingAnimation"](
             renderable,
             intensity=intensity if intensity is not None else 1,
             speed=speed if speed is not None else 0.1,
-            duration=duration, # Base class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     elif type == "typing":
         # Note: CLITypingAnimation expects 'text', assuming renderable is a string here.
-        animation = animations["CLITypingAnimation"](
+        animation = animations[
+            "CLITypingAnimation"
+        ](
             renderable,
-            speed=speed if speed is not None else 0.05, # Pass animate's speed, using CLITypingAnimation's speed default
-            typing_speed=typing_speed, # Pass animate's typing_speed, CLITypingAnimation handles its None default
+            speed=speed
+            if speed is not None
+            else 0.05,  # Pass animate's speed, using CLITypingAnimation's speed default
+            typing_speed=typing_speed,  # Pass animate's typing_speed, CLITypingAnimation handles its None default
             cursor=cursor if cursor is not None else "█",
             show_cursor=show_cursor if show_cursor is not None else True,
-            duration=duration, # Base class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     elif type == "spinning":
         animation = animations["CLISpinningAnimation"](
             renderable,
-            frames=frames, # Class handles default if None
+            frames=frames,  # Class handles default if None
             speed=speed if speed is not None else 0.1,
             prefix=prefix if prefix is not None else True,
-            duration=duration, # Base class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     elif type == "rainbow":
         animation = animations["CLIRainbowAnimation"](
             renderable,
             speed=speed if speed is not None else 0.5,
-            colors=colors, # Class handles default if None
-            duration=duration, # Base class handles default if None
+            colors=colors,  # Class handles default if None
+            duration=duration,  # Base class handles default if None
         )
     else:
         raise ValueError(f"Unknown animation type: {type}")

hammad/cli/styles/utils.py

@@ -119,8 +119,8 @@ def style_renderable(
     style_settings: CLIStyleRenderableSettings | None = None,
     bg: CLIStyleBackgroundType | None = None,
     bg_settings: CLIStyleBackgroundSettings | None = None,
-    border = None,
-    padding = None,
+    border=None,
+    padding=None,
     title: str | None = None,
     expand: bool | None = None,
 ):
@@ -383,7 +383,7 @@ def style_renderable(
                             except Exception:
                                 # Skip property if processing fails
                                 continue
-                    
+
                     # Handle direct panel parameters
                     if title is not None:
                         panel_kwargs["title"] = title
@@ -394,6 +394,7 @@ def style_renderable(
                     if border is not None:
                         try:
                             from rich import box as rich_box_module
+
                             box_map = {
                                 "ascii": rich_box_module.ASCII,
                                 "ascii2": rich_box_module.ASCII2,
@@ -516,7 +517,7 @@ def style_renderable(
                         panel_kwargs = {}
                         bg_style = Style(bgcolor=bg)
                         panel_kwargs["style"] = bg_style
-                        
+
                         # Handle direct panel parameters even with simple bg
                         if title is not None:
                             panel_kwargs["title"] = title
@@ -527,6 +528,7 @@ def style_renderable(
                         if border is not None:
                             try:
                                 from rich import box as rich_box_module
+
                                 box_map = {
                                     "ascii": rich_box_module.ASCII,
                                     "ascii2": rich_box_module.ASCII2,
@@ -558,17 +560,22 @@ def style_renderable(
                             except Exception:
                                 # Use default box if box processing fails
                                 pass
-                        
+
                         return Panel(styled_renderable, **panel_kwargs)
                     except Exception:
                         # Fallback to styled renderable if panel creation fails
                         return styled_renderable
                 else:
                     # Handle panel parameters without background
-                    if title is not None or padding is not None or expand is not None or border is not None:
+                    if (
+                        title is not None
+                        or padding is not None
+                        or expand is not None
+                        or border is not None
+                    ):
                         try:
                             panel_kwargs = {}
-                            
+
                             if title is not None:
                                 panel_kwargs["title"] = title
                             if padding is not None:
@@ -578,6 +585,7 @@ def style_renderable(
                             if border is not None:
                                 try:
                                     from rich import box as rich_box_module
+
                                     box_map = {
                                         "ascii": rich_box_module.ASCII,
                                         "ascii2": rich_box_module.ASCII2,
@@ -609,7 +617,7 @@ def style_renderable(
                                 except Exception:
                                     # Use default box if box processing fails
                                     pass
-                            
+
                             return Panel(styled_renderable, **panel_kwargs)
                         except Exception:
                             # Fallback to styled renderable if panel creation fails

hammad/data/__init__.py

@@ -47,7 +47,6 @@ __all__ = (
     # hammad.data.types
     "BaseText",
     "Text",
-
     # hammad.data.models
     "Model",
     "model_settings",
@@ -55,7 +54,6 @@ __all__ = (
     "validator",
     "is_field",
     "is_model",
-
     # hammad.data.collections
     "Collection",
     "TantivyCollectionIndex",
@@ -64,12 +62,10 @@ __all__ = (
     "TantivyCollectionIndexQuerySettings",
     "QdrantCollectionIndexSettings",
     "QdrantCollectionIndexQuerySettings",
-
     # hammad.data.sql
     "DatabaseItemType",
     "DatabaseItem",
     "Database",
-
     # hammad.data.configurations
     "Configuration",
 )
@@ -80,4 +76,4 @@ __getattr__ = create_getattr_importer(__all__)
 
 def __dir__() -> list[str]:
     """Get the attributes of the hammad.data module."""
-    return list(__all__)
+    return list(__all__)

hammad/data/collections/__init__.py

@@ -5,7 +5,7 @@ from ..._internal import create_getattr_importer
 
 if TYPE_CHECKING:
     from .collection import Collection
-    
+
     from .indexes import (
         TantivyCollectionIndex,
         QdrantCollectionIndex,
@@ -25,7 +25,6 @@ if TYPE_CHECKING:
 __all__ = (
     # hammad.data.collections.collection
     "Collection",
-
     # hammad.data.collections.indexes
     "TantivyCollectionIndex",
     "QdrantCollectionIndex",
@@ -41,4 +40,4 @@ __getattr__ = create_getattr_importer(__all__)
 
 def __dir__() -> list[str]:
     """Get the attributes of the hammad.data.collections module."""
-    return list(__all__)
+    return list(__all__)