fmtr.tools 1.1.8__py3-none-any.whl → 1.1.10__py3-none-any.whl

fmtr/tools/__init__.py

@@ -19,6 +19,7 @@ import fmtr.tools.string_tools as string
 import fmtr.tools.name_tools as name
 import fmtr.tools.logging_tools as logging
 import fmtr.tools.async_tools as asyncio
+import fmtr.tools.packaging_tools as packaging
 from fmtr.tools.logging_tools import logger
 
 from fmtr.tools.import_tools import MissingExtraMockModule

fmtr/tools/ai_tools/agentic_tools.py

@@ -1,12 +1,14 @@
+from typing import List, Optional
+
 import pydantic_ai
 from pydantic_ai import RunContext
 from pydantic_ai.agent import AgentRunResult, Agent
 from pydantic_ai.models.openai import OpenAIModel
 from pydantic_ai.providers.openai import OpenAIProvider
-from typing import List, Optional
 
 from fmtr.tools import environment_tools as env
 from fmtr.tools.constants import Constants
+from fmtr.tools.string_tools import truncate_mid
 
 pydantic_ai.Agent.instrument_all()
 
@@ -97,6 +99,14 @@ class Task:
 
         return []
 
+    def __repr__(self):
+        """
+
+        String representation of the object
+
+        """
+        return f'{self.__class__.__name__}({repr(truncate_mid(self.SYSTEM_PROMPT_STATIC, 100))})'
+
 if __name__ == '__main__':
     import asyncio
     from fmtr.tools import dm

fmtr/tools/packaging_tools.py

@@ -0,0 +1,14 @@
+import importlib.metadata
+
+
+def get_version(module):
+    """
+
+    Retrieve the version of a specified module.
+
+    """
+
+    if type(module) is not str:
+        module = module.__name__
+    version = importlib.metadata.version(module)
+    return version

fmtr/tools/version

@@ -1 +1 @@
-1.1.8
+1.1.10

fmtr/tools/yaml_tools.py

@@ -1,12 +1,58 @@
+from functools import lru_cache
 from typing import Any
-from yaml import CLoader as Loader, CDumper as Dumper
-from yaml import load, dump
+from yaml import CDumper as Dumper
+from yaml import dump
 
+from fmtr.tools import environment_tools as env
+
+
+def install():
+    """
+
+    Installs the YAML Script runtime binary of the specified version.
 
-def to_yaml(obj: Any) -> str:
     """
+    import subprocess
+    from fmtr.tools import logger, packaging
+
+    version = packaging.get_version('yamlscript')
+    logger.warning(f"Installing YAML Script runtime binary version {version}...")
+    result = subprocess.run(f"curl https://yamlscript.org/install | VERSION={version} LIB=1 bash", shell=True, check=True)
+    return result
 
 
+@lru_cache
+def get_module(is_auto=env.IS_DEBUG):
+    """
+
+    Get the YAML Script runtime module, installing the runtime if specified
+
+    """
+    try:
+        import yamlscript
+    except Exception as exception:
+        if not is_auto:
+            raise ImportError(f'YAML Script runtime missing and {is_auto=}. Set to {True} to install.') from exception
+        install()
+        import yamlscript
+    return yamlscript
+
+
+@lru_cache
+def get_interpreter():
+    """
+
+    Fetches and returns a cached instance of the YAMLScript interpreter.
+
+    """
+    module = get_module()
+    interpreter = module.YAMLScript()
+    return interpreter
+
+def to_yaml(obj: Any) -> str:
+    """
+
+    Serialize to YAML
 
     """
     yaml_str = dump(obj, allow_unicode=True, Dumper=Dumper)
@@ -16,8 +62,8 @@ def to_yaml(obj: Any) -> str:
 def from_yaml(yaml_str: str) -> Any:
     """
 
-
+    Deserialize from YAML
 
     """
-    obj = load(yaml_str, Loader=Loader)
+    obj = get_interpreter().load(yaml_str)
     return obj

{fmtr_tools-1.1.8.dist-info → fmtr_tools-1.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.1.8
+Version: 1.1.10
 Summary: Collection of high-level tools to simplify everyday development tasks, with a focus on AI/ML
 Home-page: https://github.com/fmtr/fmtr.tools
 Author: Frontmatter
@@ -9,53 +9,53 @@ License: Copyright © 2025 Frontmatter. All rights reserved.
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: test
-Requires-Dist: pymupdf4llm; extra == "test"
 Requires-Dist: pydantic-settings; extra == "test"
-Requires-Dist: tinynetrc; extra == "test"
-Requires-Dist: torchvision; extra == "test"
-Requires-Dist: pyyaml; extra == "test"
-Requires-Dist: openai; extra == "test"
-Requires-Dist: flet-webview; extra == "test"
+Requires-Dist: flet-video; extra == "test"
+Requires-Dist: pydantic; extra == "test"
 Requires-Dist: pymupdf; extra == "test"
-Requires-Dist: faker; extra == "test"
-Requires-Dist: pydevd-pycharm; extra == "test"
-Requires-Dist: distributed; extra == "test"
-Requires-Dist: contexttimer; extra == "test"
-Requires-Dist: semver; extra == "test"
-Requires-Dist: bokeh; extra == "test"
-Requires-Dist: torchaudio; extra == "test"
-Requires-Dist: huggingface_hub; extra == "test"
-Requires-Dist: google-auth-oauthlib; extra == "test"
-Requires-Dist: openpyxl; extra == "test"
-Requires-Dist: docker; extra == "test"
+Requires-Dist: flet-webview; extra == "test"
+Requires-Dist: logfire[fastapi]; extra == "test"
+Requires-Dist: sre_yield; extra == "test"
+Requires-Dist: peft; extra == "test"
+Requires-Dist: pandas; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: uvicorn[standard]; extra == "test"
+Requires-Dist: google-auth-oauthlib; extra == "test"
+Requires-Dist: json_repair; extra == "test"
+Requires-Dist: huggingface_hub; extra == "test"
+Requires-Dist: logfire; extra == "test"
 Requires-Dist: html2text; extra == "test"
+Requires-Dist: openai; extra == "test"
+Requires-Dist: pydevd-pycharm; extra == "test"
+Requires-Dist: bokeh; extra == "test"
+Requires-Dist: dask[bag]; extra == "test"
+Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
+Requires-Dist: contexttimer; extra == "test"
+Requires-Dist: flet[all]; extra == "test"
 Requires-Dist: google-api-python-client; extra == "test"
-Requires-Dist: sentence_transformers; extra == "test"
-Requires-Dist: logfire; extra == "test"
+Requires-Dist: tabulate; extra == "test"
+Requires-Dist: deepmerge; extra == "test"
+Requires-Dist: tinynetrc; extra == "test"
+Requires-Dist: distributed; extra == "test"
+Requires-Dist: yamlscript; extra == "test"
+Requires-Dist: ollama; extra == "test"
 Requires-Dist: Unidecode; extra == "test"
-Requires-Dist: diskcache; extra == "test"
-Requires-Dist: flet[all]; extra == "test"
-Requires-Dist: pandas; extra == "test"
+Requires-Dist: semver; extra == "test"
+Requires-Dist: uvicorn[standard]; extra == "test"
+Requires-Dist: docker; extra == "test"
+Requires-Dist: faker; extra == "test"
 Requires-Dist: tokenizers; extra == "test"
-Requires-Dist: fastapi; extra == "test"
-Requires-Dist: peft; extra == "test"
-Requires-Dist: json_repair; extra == "test"
-Requires-Dist: google-auth; extra == "test"
 Requires-Dist: transformers[sentencepiece]; extra == "test"
-Requires-Dist: tabulate; extra == "test"
-Requires-Dist: logfire[fastapi]; extra == "test"
-Requires-Dist: ollama; extra == "test"
-Requires-Dist: flet-video; extra == "test"
-Requires-Dist: deepmerge; extra == "test"
-Requires-Dist: sre_yield; extra == "test"
-Requires-Dist: pydantic; extra == "test"
-Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
-Requires-Dist: dask[bag]; extra == "test"
+Requires-Dist: sentence_transformers; extra == "test"
 Requires-Dist: google-auth-httplib2; extra == "test"
+Requires-Dist: pymupdf4llm; extra == "test"
+Requires-Dist: torchaudio; extra == "test"
+Requires-Dist: google-auth; extra == "test"
+Requires-Dist: diskcache; extra == "test"
+Requires-Dist: fastapi; extra == "test"
+Requires-Dist: openpyxl; extra == "test"
+Requires-Dist: torchvision; extra == "test"
 Provides-Extra: yaml
-Requires-Dist: pyyaml; extra == "yaml"
+Requires-Dist: yamlscript; extra == "yaml"
 Provides-Extra: logging
 Requires-Dist: logfire; extra == "logging"
 Requires-Dist: semver; extra == "logging"

{fmtr_tools-1.1.8.dist-info → fmtr_tools-1.1.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-fmtr/tools/__init__.py,sha256=_p8-qJSEfrdI5Kc1tTQ7RzIk7dbAcJ9yf0lpLEN4n80,5196
+fmtr/tools/__init__.py,sha256=l1hbOcGF5ET8uHUBiIMHenu4MUTIEcc45XhLp8__mog,5243
 fmtr/tools/api_tools.py,sha256=w8Zrp_EwN5KlUghwLoTCXo4z1irg5tAsReCqDLjASfE,2133
 fmtr/tools/async_tools.py,sha256=ewz757WcveQJd-G5SVr2JDOQVbdLGecCgl-tsBGVZz4,284
 fmtr/tools/augmentation_tools.py,sha256=-6ESbO4CDlKqVOV1J1V6qBeoBMzbFIinkDHRHnCBej0,55
@@ -28,6 +28,7 @@ fmtr/tools/metric_tools.py,sha256=Lvia5CGFRIfrDFA8s37btIfTU5zHbo04cPJdAMtbndQ,27
 fmtr/tools/name_tools.py,sha256=5CB_phqhHjl66iI8oLxOGPF2odC1apdul-M8Fv2xBhs,5514
 fmtr/tools/netrc_tools.py,sha256=PpNpz_mWlQi6VHGromKwFfTyLpHUXsd4LY6-OKLCbeI,376
 fmtr/tools/openai_tools.py,sha256=6SUgejgzUzmlKKct2_ePXntvMegu3FJgfk9x7aqtqYc,742
+fmtr/tools/packaging_tools.py,sha256=FlgOTnDRHZWQL2iR-wucTsyGEHRE-MlddKL30MPmUqE,253
 fmtr/tools/parallel_tools.py,sha256=QEb_gN1StkxsqYaH4HSjiJX8Y3gpb2uKNsOzG4uFpaM,3071
 fmtr/tools/path_tools.py,sha256=f4FOFhWdC5U1yeMtHPQatvXhs6cCTCC4RuPoLZo0kRE,7094
 fmtr/tools/pdf_tools.py,sha256=xvv9B84uAF81rFJRnXhSsxYuP42vY9ZdPVFrSMVe8G8,4069
@@ -43,11 +44,11 @@ fmtr/tools/tabular_tools.py,sha256=tpIpZzYku1HcJrHZJL6BC39LmN3WUWVhFbK2N7nDVmE,1
 fmtr/tools/tokenization_tools.py,sha256=me-IBzSLyNYejLybwjO9CNB6Mj2NYfKPaOVThXyaGNg,4268
 fmtr/tools/tools.py,sha256=CAsApa1YwVdNE6H66Vjivs_mXYvOas3rh7fPELAnTpk,795
 fmtr/tools/unicode_tools.py,sha256=yS_9wpu8ogNoiIL7s1G_8bETFFO_YQlo4LNPv1NLDeY,52
-fmtr/tools/version,sha256=mTnviWxfu32TdnriwXIi9L7V08GJiIKe9xvXj3QQt_k,5
+fmtr/tools/version,sha256=fwouFtO6CLpL2yNldE6I_4EcNV5NzZtvFNNjL9rePsc,6
 fmtr/tools/version_tools.py,sha256=yNs_CGqWpqE4jbK9wsPIi14peJVXYbhIcMqHAFOw3yE,1480
-fmtr/tools/yaml_tools.py,sha256=Ol43ZwbnSXGnn1K98Uxx61KPGSqfC4axE-X2q1LKMwk,349
+fmtr/tools/yaml_tools.py,sha256=RVm-PuTv5XNneMea9iZ-x-oI3UdpbLi2-KA0rSf2ybk,1537
 fmtr/tools/ai_tools/__init__.py,sha256=JZrLuOFNV1A3wvJgonxOgz_4WS-7MfCuowGWA5uYCjs,372
-fmtr/tools/ai_tools/agentic_tools.py,sha256=pHmsWixulpIBEoIQvamfkQT9BDJ39unqS9ndVw0JVUw,3477
+fmtr/tools/ai_tools/agentic_tools.py,sha256=YebH7R9ovVo3GzfWAZxY49e2fNt13APDMe290xx7zks,3720
 fmtr/tools/ai_tools/inference_tools.py,sha256=yF8Oxph0L8W2CnK_o-MVztBhWVwBpgOEkx9_m3uqQww,11840
 fmtr/tools/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 fmtr/tools/tests/conftest.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -57,9 +58,9 @@ fmtr/tools/tests/test_environment.py,sha256=iHaiMQfECYZPkPKwfuIZV9uHuWe3aE-p_dN_
 fmtr/tools/tests/test_json.py,sha256=IeSP4ziPvRcmS8kq7k9tHonC9rN5YYq9GSNT2ul6Msk,287
 fmtr/tools/tests/test_path.py,sha256=AkZQa6_8BQ-VaCyL_J-iKmdf2ZaM-xFYR37Kun3k4_g,2188
 fmtr/tools/tests/test_yaml.py,sha256=jc0TwwKu9eC0LvFGNMERdgBue591xwLxYXFbtsRwXVM,287
-fmtr_tools-1.1.8.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.1.8.dist-info/METADATA,sha256=lRqf1T5nQM155_hTay8XZjAK5A7YukM321G73D4BSWw,14646
-fmtr_tools-1.1.8.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-fmtr_tools-1.1.8.dist-info/entry_points.txt,sha256=e-eOW1Ml13tbxHC6Er1MnVOEDePeWw7DKwlE-l-gCY0,205
-fmtr_tools-1.1.8.dist-info/top_level.txt,sha256=t5341a8ii3n4RFizwTeXGmcq_pf4GqL1h9ylE5LIWRk,12
-fmtr_tools-1.1.8.dist-info/RECORD,,
+fmtr_tools-1.1.10.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.1.10.dist-info/METADATA,sha256=syY6z8ssJ9lkXfiUgexn8tnVX6yo_gYY4ICnmG2kVgs,14655
+fmtr_tools-1.1.10.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+fmtr_tools-1.1.10.dist-info/entry_points.txt,sha256=e-eOW1Ml13tbxHC6Er1MnVOEDePeWw7DKwlE-l-gCY0,205
+fmtr_tools-1.1.10.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.1.10.dist-info/RECORD,,

fmtr_tools-1.1.10.dist-info/top_level.txt

@@ -0,0 +1 @@
+fmtr

fmtr_tools-1.1.8.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-docker
-fmtr