lionagi 0.8.8__py3-none-any.whl → 0.9.1__py3-none-any.whl

lionagi/__init__.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/_class_registry.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/_errors.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/file/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/file/chunk.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/file/file_ops.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/file/params.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/file/process.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/file/save.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/nested/flatten.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/nfilter.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/nget.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/ninsert.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/nmerge.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/npop.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/nset.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/unflatten.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/nested/utils.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/package/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/package/imports.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/package/management.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/package/params.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/package/system.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/parse.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/schema/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/schema/as_readable.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 
@@ -8,103 +8,167 @@ from typing import Any
 from lionagi.utils import to_dict
 
 
-def as_readable_json(input_: Any, /, **kwargs) -> str:
-    """Convert input to a human-readable JSON string.
-
-    Args:
-        input_: Object to convert to readable JSON
-        **kwargs: Additional arguments passed to json.dumps()
-
-    Returns:
-        A formatted, human-readable JSON string
-
-    Raises:
-        ValueError: If conversion to JSON fails
+def in_notebook() -> bool:
+    """
+    Checks if we're running inside a Jupyter notebook.
+    Returns True if yes, False otherwise.
     """
-    # Extract to_dict kwargs
-    to_dict_kwargs = {
-        "use_model_dump": True,
-        "fuzzy_parse": True,
-        "recursive": True,
-        "recursive_python_only": False,
-        "max_recursive_depth": 5,
-    }
-    to_dict_kwargs.update(kwargs)
-
-    # Handle empty input
-    if not input_:
-        if isinstance(input_, list):
-            return ""
-        return "{}"
-
     try:
-        if isinstance(input_, list):
-            # For lists, convert and format each item separately
-            items = []
-            for item in input_:
-                dict_ = to_dict(item, **to_dict_kwargs)
-                items.append(
-                    json.dumps(
-                        dict_,
-                        indent=2,
-                        ensure_ascii=False,
-                        default=lambda o: to_dict(o),
-                    )
-                )
-            return "\n\n".join(items)
-
-        # Handle single items
-        dict_ = to_dict(input_, **to_dict_kwargs)
-
-        # Extract json.dumps kwargs from input kwargs
-        json_kwargs = {
-            "indent": 2,
-            "ensure_ascii": kwargs.get("ensure_ascii", False),
-            "default": lambda o: to_dict(o),
-        }
-
-        # Add any other JSON-specific kwargs
-        for k in ["indent", "separators", "cls"]:
-            if k in kwargs:
-                json_kwargs[k] = kwargs[k]
+        from IPython import get_ipython
 
-        # Convert to JSON string
-        if kwargs.get("ensure_ascii", False):
-            # Force ASCII encoding for special characters
-            return json.dumps(
-                dict_,
-                ensure_ascii=True,
-                **{
-                    k: v for k, v in json_kwargs.items() if k != "ensure_ascii"
-                },
-            )
+        shell = get_ipython().__class__.__name__
+        return "ZMQInteractiveShell" in shell
+    except Exception:
+        return False
 
-        return json.dumps(dict_, **json_kwargs)
 
-    except Exception as e:
-        raise ValueError(
-            f"Failed to convert input to readable JSON: {e}"
-        ) from e
+def format_dict(data: Any, indent: int = 0) -> str:
+    """
+    Recursively format Python data (dicts, lists, strings, etc.) into a
+    YAML-like readable string.
 
+    - Multi-line strings are displayed using a '|' block style, each line indented.
+    - Lists are shown with a '- ' prefix per item at the appropriate indentation.
+    - Dict keys are shown as "key:" lines, with values on subsequent lines if complex.
+    """
+    lines = []
+    prefix = "  " * indent  # 2 spaces per indent level
+
+    if isinstance(data, dict):
+        for key, value in data.items():
+            if isinstance(value, dict):
+                # Nested dict
+                lines.append(f"{prefix}{key}:")
+                lines.append(format_dict(value, indent + 1))
+            elif isinstance(value, list):
+                # List under a key
+                lines.append(f"{prefix}{key}:")
+                for item in value:
+                    item_str = format_dict(item, indent + 2).lstrip()
+                    lines.append(f"{prefix}  - {item_str}")
+            elif isinstance(value, str) and "\n" in value:
+                # Multi-line string
+                lines.append(f"{prefix}{key}: |")
+                subprefix = "  " * (indent + 1)
+                for line in value.splitlines():
+                    lines.append(f"{subprefix}{line}")
+            else:
+                # Simple single-line scalar
+                item_str = format_dict(value, indent + 1).lstrip()
+                lines.append(f"{prefix}{key}: {item_str}")
+        return "\n".join(lines)
+
+    elif isinstance(data, list):
+        # For top-level or nested lists
+        for item in data:
+            item_str = format_dict(item, indent + 1).lstrip()
+            lines.append(f"{prefix}- {item_str}")
+        return "\n".join(lines)
+
+    # Base case: single-line scalar
+    return prefix + str(data)
+
+
+def as_readable(
+    input_: Any,
+    /,
+    *,
+    md: bool = False,
+    format_curly: bool = False,
+    display_str: bool = False,
+    max_chars: int | None = None,
+) -> str:
+    """
+    Convert `input_` into a human-readable string. If `format_curly=True`, uses
+    a YAML-like style (`format_dict`). Otherwise, pretty-printed JSON.
 
-def as_readable(input_: Any, /, *, md: bool = False, **kwargs) -> str:
-    """Convert input to readable string with optional markdown formatting.
+    - For Pydantic models or nested data, uses `to_dict` to get a dictionary.
+    - If the result is a list of items, each is processed and concatenated.
 
     Args:
-        input_: Object to convert
-        md: Whether to wrap in markdown block
-        **kwargs: Additional arguments for as_readable_json()
+        input_: The data to convert (could be a single item or list).
+        md: If True, wraps the final output in code fences for Markdown display.
+        format_curly: If True, use `format_dict`. Otherwise, produce JSON text.
 
     Returns:
-        Formatted string representation
+        A formatted string representation of `input_`.
     """
-    try:
-        result = as_readable_json(input_, **kwargs)
-        if md:
-            return f"```json\n{result}\n```"
-        return result
 
-    except Exception:
+    # 1) Convert the input to a Python dict/list structure
+    #    (handles recursion, Pydantic models, etc.)
+    def to_dict_safe(obj: Any) -> Any:
+        # Attempt to call to_dict with typical recursion flags
+        to_dict_kwargs = {
+            "use_model_dump": True,
+            "fuzzy_parse": True,
+            "recursive": True,
+            "recursive_python_only": False,
+            "max_recursive_depth": 5,
+        }
+        return to_dict(obj, **to_dict_kwargs)
+
+    def _inner(i_: Any) -> Any:
+        try:
+            if isinstance(i_, list):
+                # Already a list. Convert each item
+                items = [to_dict_safe(x) for x in i_]
+            else:
+                # Single item
+                maybe_list = to_dict_safe(i_)
+                # If it's a list, store as items; else just single
+                items = (
+                    maybe_list
+                    if isinstance(maybe_list, list)
+                    else [maybe_list]
+                )
+        except Exception:
+            # If conversion fails, fallback to str
+            return str(i_)
+
+        # 2) For each item in `items`, either format with YAML-like or JSON
+        rendered = []
+        for item in items:
+            if format_curly:
+                # YAML-like
+                rendered.append(format_dict(item))
+            else:
+                # JSON approach
+                try:
+                    # Provide indentation, ensure ASCII not forced
+                    rendered.append(
+                        json.dumps(item, indent=2, ensure_ascii=False)
+                    )
+                except Exception:
+                    # fallback
+                    rendered.append(str(item))
+
+        # 3) Combine
+        final_str = "\n\n".join(rendered).strip()
+
+        # 4) If Markdown requested, wrap with code fences
+        #    - If we used format_curly, we might do "```yaml" instead. But user specifically asked for JSON code blocks previously
         if md:
-            return f"```json\n{str(input_)}\n```"
-        return str(input_)
+            if format_curly:
+                return f"```yaml\n{final_str}\n```"
+            else:
+                return f"```json\n{final_str}\n```"
+
+        return final_str
+
+    str_ = _inner(input_).strip()
+    if max_chars is not None and len(str_) > max_chars:
+        str1 = str_[:max_chars] + "...\n\n[Truncated output]\n\n"
+        if str_.endswith("\n```"):
+            str1 += "```"
+        str_ = str1
+    if display_str:
+        if md and in_notebook():
+            # If in IPython environment, display Markdown
+            from IPython.display import Markdown, display
+
+            display(Markdown(str_))
+        else:
+            # Otherwise, just print the string
+            print(str_)
+    else:
+        return str_

lionagi/libs/schema/extract_code_block.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/schema/extract_docstring.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/schema/function_to_schema.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/schema/json_schema.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/validate/__init__.py

@@ -1,3 +1,3 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0

lionagi/libs/validate/common_field_validators.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/validate/fuzzy_match_keys.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/validate/fuzzy_validate_mapping.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/validate/string_similarity.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0
 

lionagi/libs/validate/validate_boolean.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2023 - 2024, HaiyangLi <quantocean.li at gmail dot com>
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
 #
 # SPDX-License-Identifier: Apache-2.0