hammad-python 0.0.31__py3-none-any.whl → 0.0.33__py3-none-any.whl

ham/__init__.py

@@ -4,7 +4,197 @@
 ## `hammad-python`
 
 Fun bunch of stuff ***:)***
+
+This module is a collection over various sub-packages that
+define the `ham` namespace. These packages include:
+
+- `hammad-python-core`
+- `hammad-python-data`
+- `hammad-python-genai`
+- `hammad-python-http`
 ```
+
+You can access a variety of the primary resources from these modules
+directly from this top level module.
 """
 
 __path__ = __import__("pkgutil").extend_path(__path__, __name__)
+
+from typing import TYPE_CHECKING
+
+try:
+    from ham.core._internal import type_checking_importer
+except ImportError:
+    from .core._internal import type_checking_importer  # type: ignore
+
+
+if TYPE_CHECKING:
+    try:
+        # ham.core
+        from ham.core._internal._logging import set_debug, set_verbose
+        from ham.core.cache import cached, auto_cached
+        from ham.core.cli import print, animate, input, log, log_iterable, log_progress
+        from ham.core.conversion import (
+            convert_to_text,
+            convert_to_json_schema,
+            convert_to_model,
+            convert_to_pydantic_model,
+        )
+        from ham.core.logging import get_logger, trace, trace_http
+
+        # ham.data
+        from ham.data.collections import (
+            create_collection,
+        )
+
+        # ham.genai
+        from ham.genai.models.embeddings import run_embedding_model
+        from ham.genai.models.language import run_language_model
+        from ham.genai.models.reranking import run_reranking_model
+        from ham.genai.models.multimodal import (
+            run_image_generation_model,
+            run_transcription_model,
+            run_tts_model,
+        )
+        from ham.genai.agents import create_agent, run_agent, run_agent_iter
+        from ham.genai.graphs import (
+            # NOTE: lol... uh i just really wanted everything to be lowercase..
+            # this may need a once over
+            BaseGraph as basegraph,
+            action as graphaction,
+        )
+        from ham.genai.prompted import (
+            prompted_fn as prompted,
+            contextualize,
+            itemize,
+            select,
+            tool,
+        )
+        from ham.genai.a2a import as_a2a_app
+
+        # ham.http
+        from ham.http import (
+            create_client,
+            create_openapi_client,
+            create_http_client,
+            create_mcp_client,
+            create_server,
+            create_fast_service,
+            function_server,
+            function_mcp_server,
+            run_web_request,
+            read_web_page,
+            read_web_pages,
+            run_web_search,
+            run_news_search,
+            extract_web_page_links,
+            create_search_client,
+        )
+    except ImportError:
+        from ham.core._internal import (  # type: ignore
+            set_debug,
+            set_verbose,
+        )
+        from ham.data import (  # type: ignore
+            create_collection,
+        )
+        from ham.genai import (  # type: ignore
+            create_agent,
+            run_agent,
+            run_agent_iter,
+            run_embedding_model,
+            run_language_model,
+            run_reranking_model,
+            run_image_generation_model,
+            run_transcription_model,
+            run_tts_model,
+            basegraph,
+            graphaction,
+            prompted,
+            contextualize,
+            itemize,
+            select,
+            tool,
+        )
+        from ham.http import (  # type: ignore
+            create_client,
+            create_openapi_client,
+            create_http_client,
+            create_mcp_client,
+            create_server,
+            create_fast_service,
+            function_server,
+            function_mcp_server,
+            run_web_request,
+            read_web_page,
+            read_web_pages,
+            run_web_search,
+            run_news_search,
+            extract_web_page_links,
+            create_search_client,
+        )
+
+
+__all__ = (
+    # ham.core
+    "set_debug",
+    "set_verbose",
+    "cached",
+    "auto_cached",
+    "print",
+    "animate",
+    "input",
+    "log",
+    "log_iterable",
+    "log_progress",
+    "convert_to_text",
+    "convert_to_json_schema",
+    "convert_to_model",
+    "convert_to_pydantic_model",
+    "get_logger",
+    "trace",
+    "trace_http",
+    # ham.data
+    "create_collection",
+    # ham.genai
+    "create_agent",
+    "run_agent",
+    "run_agent_iter",
+    "run_embedding_model",
+    "run_language_model",
+    "run_reranking_model",
+    "run_image_generation_model",
+    "run_transcription_model",
+    "run_tts_model",
+    "basegraph",
+    "graphaction",
+    "prompted",
+    "contextualize",
+    "itemize",
+    "select",
+    "tool",
+    # ham.http
+    "create_client",
+    "create_openapi_client",
+    "create_http_client",
+    "create_mcp_client",
+    "create_server",
+    "create_fast_service",
+    "function_server",
+    "function_mcp_server",
+    "run_web_request",
+    "read_web_page",
+    "read_web_pages",
+    "run_web_search",
+    "run_news_search",
+    "extract_web_page_links",
+    "create_search_client",
+)
+
+
+__getattr__ = type_checking_importer(__all__)
+
+
+def __dir__() -> list[str]:
+    """Get the attributes of the hammad module."""
+    return __all__

{hammad_python-0.0.31.dist-info → hammad_python-0.0.33.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hammad-python
-Version: 0.0.31
+Version: 0.0.33
 Summary: Personal Python utilities and tools
 Author-email: Hammad Saeed <hammadaidev@gmail.com>
 License: MIT License
@@ -26,10 +26,10 @@ License: MIT License
         SOFTWARE.
 License-File: LICENSE
 Requires-Python: >=3.11
-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
+Requires-Dist: hammad-python-core>=0.0.2
+Requires-Dist: hammad-python-data>=0.0.2
+Requires-Dist: hammad-python-genai>=0.0.2
+Requires-Dist: hammad-python-http>=0.0.2
 Description-Content-Type: text/markdown
 
 ## hammad-python

hammad_python-0.0.33.dist-info/RECORD

@@ -0,0 +1,6 @@
+ham/__init__.py,sha256=J1ye-mmybVCdFvMaYJjYVNJa7CEME4W6bIzLuGsQvKE,5215
+ham/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hammad_python-0.0.33.dist-info/METADATA,sha256=V40VBFYdpwiyvii0DQMNRMFfTlmgh3-FWlbKPpAFabs,5454
+hammad_python-0.0.33.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hammad_python-0.0.33.dist-info/licenses/LICENSE,sha256=h74yFUWjbBaodcWG5wNmm30npjl8obVcxD-1nQfUp2I,1069
+hammad_python-0.0.33.dist-info/RECORD,,

hammad_python-0.0.31.dist-info/RECORD

@@ -1,6 +0,0 @@
-ham/__init__.py,sha256=MA_bJzOy-7HH-wzIPpMiWFlDq_6MwvRFtRinBFdHJ0Y,142
-ham/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hammad_python-0.0.31.dist-info/METADATA,sha256=IfpcOHTQGdS5OddkPu0V9MKX6646xdKJHDY0iQ3NQfc,5454
-hammad_python-0.0.31.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hammad_python-0.0.31.dist-info/licenses/LICENSE,sha256=h74yFUWjbBaodcWG5wNmm30npjl8obVcxD-1nQfUp2I,1069
-hammad_python-0.0.31.dist-info/RECORD,,