flock-core 0.3.41__py3-none-any.whl → 0.4.0b2__py3-none-any.whl

flock/core/util/file_path_utils.py

@@ -0,0 +1,223 @@
+"""Utility functions for handling file paths in Flock.
+
+This module provides utilities for working with file paths,
+especially for components that may be loaded from file system paths
+rather than module imports.
+"""
+
+import importlib.util
+import inspect
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+
+def get_file_path(obj: Any) -> str | None:
+    """Get the file path for a Python object.
+
+    Args:
+        obj: The object to get the file path for
+
+    Returns:
+        The file path if it can be determined, None otherwise
+    """
+    try:
+        if inspect.ismodule(obj):
+            return obj.__file__
+        elif inspect.isclass(obj) or inspect.isfunction(obj):
+            return inspect.getfile(obj)
+        return None
+    except (TypeError, ValueError):
+        return None
+
+
+def normalize_path(path: str) -> str:
+    """Normalize a path for consistent representation.
+
+    Args:
+        path: The path to normalize
+
+    Returns:
+        The normalized path
+    """
+    return os.path.normpath(path)
+
+
+def is_same_path(path1: str, path2: str) -> bool:
+    """Check if two paths point to the same file.
+
+    Args:
+        path1: The first path
+        path2: The second path
+
+    Returns:
+        True if the paths point to the same file, False otherwise
+    """
+    return os.path.normpath(os.path.abspath(path1)) == os.path.normpath(
+        os.path.abspath(path2)
+    )
+
+
+def get_relative_path(path: str, base_path: str | None = None) -> str:
+    """Get a path relative to a base path.
+
+    Args:
+        path: The path to make relative
+        base_path: The base path (defaults to current working directory)
+
+    Returns:
+        The relative path
+    """
+    if base_path is None:
+        base_path = os.getcwd()
+
+    return os.path.relpath(path, base_path)
+
+
+def load_class_from_file(file_path: str, class_name: str) -> type | None:
+    """Load a class from a file.
+
+    Args:
+        file_path: The path to the file
+        class_name: The name of the class to load
+
+    Returns:
+        The loaded class, or None if it could not be loaded
+    """
+    try:
+        # Generate a unique module name to avoid conflicts
+        module_name = f"flock_dynamic_import_{hash(file_path)}"
+
+        # Create a spec for the module
+        spec = importlib.util.spec_from_file_location(module_name, file_path)
+        if not spec or not spec.loader:
+            return None
+
+        # Create and load the module
+        module = importlib.util.module_from_spec(spec)
+        sys.modules[module_name] = module
+        spec.loader.exec_module(module)
+
+        # Get the class from the module
+        if not hasattr(module, class_name):
+            return None
+
+        return getattr(module, class_name)
+    except Exception:
+        return None
+
+
+def get_project_root() -> Path:
+    """Get the project root directory.
+
+    Returns:
+        The project root path
+    """
+    # Try to find the directory containing pyproject.toml or setup.py
+    current_dir = Path(os.getcwd())
+
+    # Walk up the directory tree looking for project markers
+    for path in [current_dir, *current_dir.parents]:
+        if (path / "pyproject.toml").exists() or (path / "setup.py").exists():
+            return path
+
+    # Default to current directory if no project markers found
+    return current_dir
+
+
+def component_path_to_file_path(component_path: str) -> str | None:
+    """Convert a component path (module.ClassName) to a file path.
+
+    Args:
+        component_path: The component path in the form module.ClassName
+
+    Returns:
+        The file path if it can be determined, None otherwise
+    """
+    try:
+        # Split into module path and class name
+        if "." not in component_path:
+            return None
+
+        module_path, class_name = component_path.rsplit(".", 1)
+
+        # Import the module
+        module = importlib.import_module(module_path)
+
+        # Get the file path
+        if hasattr(module, "__file__"):
+            return module.__file__
+
+        return None
+    except (ImportError, AttributeError):
+        return None
+
+
+def file_path_to_component_path(file_path: str, class_name: str) -> str | None:
+    """Convert a file path and class name to a component path (module.ClassName).
+
+    This is approximate and may not work in all cases, especially for non-standard
+    module structures.
+
+    Args:
+        file_path: The file path to the module
+        class_name: The name of the class
+
+    Returns:
+        The component path if it can be determined, None otherwise
+    """
+    try:
+        # Convert the file path to an absolute path
+        abs_path = os.path.abspath(file_path)
+
+        # Get the project root
+        root = get_project_root()
+
+        # Get the relative path from the project root
+        rel_path = os.path.relpath(abs_path, root)
+
+        # Convert to a module path
+        module_path = os.path.splitext(rel_path)[0].replace(os.sep, ".")
+
+        # Remove 'src.' prefix if present (common in Python projects)
+        if module_path.startswith("src."):
+            module_path = module_path[4:]
+
+        # Combine with the class name
+        return f"{module_path}.{class_name}"
+    except Exception:
+        return None
+
+
+def register_file_paths_in_registry(
+    component_paths: dict[str, str], registry: Any | None = None
+) -> bool:
+    """Register file paths in the registry.
+
+    Args:
+        component_paths: Dictionary mapping component paths to file paths
+        registry: The registry to register in (defaults to the global registry)
+
+    Returns:
+        True if all paths were registered, False otherwise
+    """
+    try:
+        # Get the global registry if none provided
+        if registry is None:
+            from flock.core.flock_registry import get_registry
+
+            registry = get_registry()
+
+        # Initialize component_file_paths if needed
+        if not hasattr(registry, "_component_file_paths"):
+            registry._component_file_paths = {}
+
+        # Register each path
+        for component_name, file_path in component_paths.items():
+            if component_name in registry._components:
+                registry._component_file_paths[component_name] = file_path
+
+        return True
+    except Exception:
+        return False

{flock_core-0.3.41.dist-info → flock_core-0.4.0b2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.3.41
+Version: 0.4.0b2
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE

{flock_core-0.3.41.dist-info → flock_core-0.4.0b2.dist-info}/RECORD

@@ -1,27 +1,27 @@
-flock/__init__.py,sha256=tupCoJ_D101SlxWdtQFLZhtWGpp8OgWDl2ksNfqNalQ,2825
+flock/__init__.py,sha256=LhuAmkwwNuNbEvo2N4r1myDgGqQwDRe_HYU3sTZQgDc,4139
 flock/config.py,sha256=O5QJGlStf4DWSK4ovZsKw01ud4YK3_ij6Ay8sWU8ih0,1522
 flock/cli/constants.py,sha256=EgGwFYl6TD7GVm9gASPJTjSl-aYROiFGltwFYp7u1AQ,668
 flock/cli/create_agent.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
-flock/cli/create_flock.py,sha256=Lry15fAwvnh0rHl1pIJ1xKqVj-nYBteNAE1G83LRaAo,6123
+flock/cli/create_flock.py,sha256=XjTZEMQcEuAhniDJFrZoV103c-iTS1j-8AnagWZYxGE,8229
 flock/cli/execute_flock.py,sha256=rAP-5nFfyOivi5uWG8mloZwXF9Tj9iD8MYSbllPllQ4,5726
 flock/cli/load_agent.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
 flock/cli/load_examples.py,sha256=DkeLUlrb7rGx3nZ04aADU9HXXu5mZTf_DBwT0xhzIv4,7
-flock/cli/load_flock.py,sha256=5bsdjO5olLtpnFEl_UfisnwR8iSQAkOIWI49tnSwJHc,1537
+flock/cli/load_flock.py,sha256=sfZ9B9aiyC5TCEbn1xR5Yd5SoaVji6MBNYzXlWOpoZ4,7111
 flock/cli/load_release_notes.py,sha256=qFcgUrMddAE_TP6x1P-6ZywTUjTknfhTDW5LTxtg1yk,599
 flock/cli/loaded_flock_cli.py,sha256=LpPBBSMOw0780EQ4KHz7QMpwz29KZZW7AuTerHvramw,6351
 flock/cli/manage_agents.py,sha256=wkNF0IqNFfePrFueR57SILPW885IPqs3U8Cp-fcPPmo,12710
-flock/cli/registry_management.py,sha256=z1ip6AeC78C_YCjGM3PA5rD4eEauqtG9v5Qud1QFRr4,19705
+flock/cli/registry_management.py,sha256=mAHy3wT97YgODR0gVOkTXDqR5NIPzM-E-z9dEtw9-tw,29790
 flock/cli/settings.py,sha256=Z_TXBzCYlCmSaKrJ_CQCdYy-Cj29gpI4kbC_2KzoKqg,27025
 flock/cli/view_results.py,sha256=dOzK0O1FHSIDERnx48y-2Xke9BkOHS7pcOhs64AyIg0,781
-flock/cli/yaml_editor.py,sha256=VpaSwC-Xcbu_gk4HgUeIL7PXNFu1CdstuJ3mRZOkmIk,8096
+flock/cli/yaml_editor.py,sha256=K3N0bh61G1TSDAZDnurqW9e_-hO6CtSQKXQqlDhCjVo,12527
 flock/cli/assets/release_notes.md,sha256=bqnk50jxM3w5uY44Dc7MkdT8XmRREFxrVBAG9XCOSSU,4896
-flock/core/__init__.py,sha256=6NmSXsdQOoOPWjWqdF8BYiUveb54CjH8Ta0WAjNM0Ps,574
-flock/core/flock.py,sha256=7bve-XWSW18BlxAJrkCHEs0qZEtDhQasVpZWJ4gZk-c,24592
-flock/core/flock_agent.py,sha256=jkDwB7yVGYyLfg-WuwvR2X4XblXOs5DrB2dB30xBL7Q,24754
+flock/core/__init__.py,sha256=R64A7zi51Uz6jzzCFWGol9SZQnMFz3ynEse5ivhSkEA,805
+flock/core/flock.py,sha256=jKhI1UyrgPpel-r8Qjwp82Zwz2AghHMudKQYgy-8kYA,62329
+flock/core/flock_agent.py,sha256=L5sZ6weY4pNFbk8CEUrRD1506ojq_tx1jjQy02qEdC8,29126
 flock/core/flock_evaluator.py,sha256=dOXZeDOGZcAmJ9ahqq_2bdGUU1VOXY4skmwTVpAjiVw,1685
 flock/core/flock_factory.py,sha256=MGTkJCP1WGpV614f87r1vwe0tqAvBCoH9PlqtqDyJDk,2828
 flock/core/flock_module.py,sha256=96aFVYAgwpKN53xGbivQDUpikOYGFCxK5mqhclOcxY0,3003
-flock/core/flock_registry.py,sha256=tX16sNy-ViK608WMT9JtK2fVZrtAHaBJOg5xXdhsndk,19446
+flock/core/flock_registry.py,sha256=ax2pIxv6hVqRw3eJCPQ9jAul_ocYWfl9BZttmu054d0,20830
 flock/core/flock_router.py,sha256=A5GaxcGvtiFlRLHBTW7okh5RDm3BdKam2uXvRHRaj7k,2187
 flock/core/api/__init__.py,sha256=OKlhzDWZJfA6ddBwxQUmATY0TSzESsH032u00iVGvdA,228
 flock/core/api/endpoints.py,sha256=m-QAyizCHGh3sd5IXaDEhquSxNgTZLpUVTXLdVjiDVw,9086
@@ -55,14 +55,15 @@ flock/core/serialization/__init__.py,sha256=CML7fPgG6p4c0CDBlJ_uwV1aZZhJKK9uy3Io
 flock/core/serialization/callable_registry.py,sha256=sUZECTZWsM3fJ8FDRQ-FgLNW9hF26nY17AD6fJKADMc,1419
 flock/core/serialization/json_encoder.py,sha256=gAKj2zU_8wQiNvdkby2hksSA4fbPNwTjup_yz1Le1Vw,1229
 flock/core/serialization/secure_serializer.py,sha256=n5-zRvvXddgJv1FFHsaQ2wuYdL3WUSGPvG_LGaffEJo,6144
-flock/core/serialization/serializable.py,sha256=ymuJmm8teLbyUFMakkD7W3a_N8H4igZ1ITQnOqoLt0o,11270
-flock/core/serialization/serialization_utils.py,sha256=YxlPoHFPtj5otWUlKEsKphWxnd_d6b8yMZN_5MDlzB4,7577
+flock/core/serialization/serializable.py,sha256=qlv8TsTqRuklXiNuCMrvro5VKz764xC2i3FlgLJSkdk,12129
+flock/core/serialization/serialization_utils.py,sha256=ONv7KUhc66e4sKYu9uFc3qU1jOg4DvIXRJ5QXaTIQj0,10298
 flock/core/tools/azure_tools.py,sha256=9Bi6IrB5pzBTBhBSxpCVMgx8HBud8nl4gDp8aN0NT6c,17031
 flock/core/tools/basic_tools.py,sha256=hEG14jNZ2itVvubCHTfsWkuJK6yuNwBtuFj2Js0VHZs,9043
 flock/core/tools/llm_tools.py,sha256=Bdt4Dpur5dGpxd2KFEQyxjfZazvW1HCDKY6ydMj6UgQ,21811
 flock/core/tools/markdown_tools.py,sha256=W6fGM48yGHbifVlaOk1jOtVcybfRbRmf20VbDOZv8S4,6031
 flock/core/tools/dev_tools/github.py,sha256=a2OTPXS7kWOVA4zrZHynQDcsmEi4Pac5MfSjQOLePzA,5308
-flock/core/util/cli_helper.py,sha256=QSpP10WRNcjXzVFwpTQA8lSBy7707Qlv7uCit1XjUms,49808
+flock/core/util/cli_helper.py,sha256=mbxFhAGDES1AySbz5D672Az-EWk88FIvtFIGJMEp6fc,49800
+flock/core/util/file_path_utils.py,sha256=Odf7uU32C-x1KNighbNERSiMtkzW4h8laABIoFK7A5M,6246
 flock/core/util/hydrator.py,sha256=6qNwOwCZB7r6y25BZ--0PGofrAlfMaXbDKFQeP5NLts,11196
 flock/core/util/input_resolver.py,sha256=g9vDPdY4OH-G7qjas5ksGEHueokHGFPMoLOvC-ngeLo,5984
 flock/evaluators/declarative/declarative_evaluator.py,sha256=WZ74LG81JcuApG2KcTk8plh0fFqDhJjtl6ubW1K-fqc,1750
@@ -429,8 +430,8 @@ flock/workflow/activities.py,sha256=eVZDnxGJl_quNO-UTV3YgvTV8LrRaHN3QDAA1ANKzac,
 flock/workflow/agent_activities.py,sha256=NhBZscflEf2IMfSRa_pBM_TRP7uVEF_O0ROvWZ33eDc,963
 flock/workflow/temporal_setup.py,sha256=VWBgmBgfTBjwM5ruS_dVpA5AVxx6EZ7oFPGw4j3m0l0,1091
 flock/workflow/workflow.py,sha256=I9MryXW_bqYVTHx-nl2epbTqeRy27CAWHHA7ZZA0nAk,1696
-flock_core-0.3.41.dist-info/METADATA,sha256=y1g8FMNb_00Kao6g_aQ8P6Q8mxTvYY0HPaxXV287VxI,20772
-flock_core-0.3.41.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-flock_core-0.3.41.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
-flock_core-0.3.41.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
-flock_core-0.3.41.dist-info/RECORD,,
+flock_core-0.4.0b2.dist-info/METADATA,sha256=qGomy57c5JrnrpayoVAJK7xq6eJ20uM97ydTKJdttwQ,20773
+flock_core-0.4.0b2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+flock_core-0.4.0b2.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
+flock_core-0.4.0b2.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
+flock_core-0.4.0b2.dist-info/RECORD,,