fmtr.tools 1.3.26__py3-none-any.whl → 1.3.27__py3-none-any.whl

fmtr/tools/constants.py

@@ -49,3 +49,5 @@ class Constants:
     PRODUCTION = "production"
 
     INFRA = 'infra'
+
+    PROMPT_NOT_SPECIFIED = '[None Specified]'

fmtr/tools/interface_tools/controls.py

@@ -1,35 +1,32 @@
+import inspect
+
 import flet as ft
 
 
-class ContextRing(ft.ProgressRing):
+class ContextBase:
     """
 
-    Context manager progress ring.
+    A mixin base that can be used as both a synchronous and asynchronous context manager,
+    or as a decorator to wrap synchronous or asynchronous functions.
+    The control becomes visible when entering the context or invoking the wrapped function,
+    and is hidden again when exiting.
 
     """
 
-    def __init__(self, *args, **kwargs):
-        """
-
-        Start out not visible.
-
-        """
-        super().__init__(*args, **kwargs, visible=False)
-
     def start(self):
         """
 
-        Update to visible when in context.
-
+        Show the control and update the page.
         """
+
         self.visible = True
         self.page.update()
 
     def stop(self):
         """
 
-        Update to not visible when exiting context.
-
+        Hide the control and update the page.
+        
         """
         self.visible = False
         self.page.update()
@@ -37,38 +34,92 @@ class ContextRing(ft.ProgressRing):
     def context(self, func):
         """
 
-        Context manager decorator.
+        Decorator that wraps a synchronous or asynchronous function.
+        While the function runs, the control is visible.
 
         """
+        if inspect.iscoroutinefunction(func):
+            async def async_wrapped(*args, **kwargs):
+                async with self:
+                    return await func(*args, **kwargs)
 
-        def wrapped(*args, **kwargs):
-            with self:
-                func(*args, **kwargs)
+            return async_wrapped
+        else:
+            def sync_wrapped(*args, **kwargs):
+                with self:
+                    return func(*args, **kwargs)
 
-        return wrapped
+            return sync_wrapped
 
     def __enter__(self):
+        """
+
+        Enter the control context (sync).
+
+        """
         self.start()
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb):
+        """
+
+        Exit the control context (sync).
+
+        """
         self.stop()
 
+    async def __aenter__(self):
+        """
+
+        Enter the control context (async).
+        """
+
+        result = self.start()
+        if inspect.isawaitable(result):
+            await result
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb):
+        """
+
+        Exit the control context (async).
+        """
+
+        result = self.stop()
+        if inspect.isawaitable(result):
+            await result
+
+
+class ContextRing(ft.ProgressRing, ContextBase):
+    """
+
+    A progress ring as a context manager.
+
+    """
+
+    def __init__(self, *args, **kwargs):
+        """
+
+        Initialize the progress ring as hidden by default.
+
+        """
+        super().__init__(*args, **kwargs, visible=False)
 
 class ProgressButton(ft.Button):
     """
 
-    Button with progress ring.
+    Button containing a progress ring.
 
     """
 
-    def __init__(self, *args, on_click=None, **kwargs):
+    def __init__(self, *args, on_click=None, ring: ContextRing = None, **kwargs):
         """
 
         Run on_click in run context manager
 
         """
-        self.ring = ContextRing()
+        self.ring = ring or ContextRing()
+
         super().__init__(*args, content=self.ring, on_click=self.ring.context(on_click), **kwargs)
         self.context = self.ring.context
 

fmtr/tools/version

@@ -1 +1 @@
-1.3.26
+1.3.27

{fmtr_tools-1.3.26.dist-info → fmtr_tools-1.3.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.3.26
+Version: 1.3.27
 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
@@ -126,61 +126,61 @@ Requires-Dist: logfire[httpx]; extra == "http"
 Provides-Extra: setup
 Requires-Dist: setuptools; extra == "setup"
 Provides-Extra: all
-Requires-Dist: logfire[httpx]; extra == "all"
-Requires-Dist: dask[bag]; extra == "all"
-Requires-Dist: logfire[fastapi]; extra == "all"
-Requires-Dist: httpx; extra == "all"
-Requires-Dist: google-auth; extra == "all"
-Requires-Dist: tabulate; extra == "all"
-Requires-Dist: diskcache; extra == "all"
-Requires-Dist: sre_yield; extra == "all"
-Requires-Dist: yamlscript; extra == "all"
-Requires-Dist: sentence_transformers; extra == "all"
-Requires-Dist: uvicorn[standard]; extra == "all"
-Requires-Dist: cachetools; extra == "all"
-Requires-Dist: httpx_retries; extra == "all"
-Requires-Dist: docker; extra == "all"
-Requires-Dist: pymupdf; extra == "all"
-Requires-Dist: distributed; extra == "all"
-Requires-Dist: peft; extra == "all"
-Requires-Dist: fastapi; extra == "all"
-Requires-Dist: flet-video; extra == "all"
 Requires-Dist: tokenizers; extra == "all"
+Requires-Dist: uvicorn[standard]; extra == "all"
 Requires-Dist: pytest-cov; extra == "all"
-Requires-Dist: faker; extra == "all"
+Requires-Dist: google-auth; extra == "all"
+Requires-Dist: diskcache; extra == "all"
 Requires-Dist: contexttimer; extra == "all"
-Requires-Dist: google-auth-oauthlib; extra == "all"
-Requires-Dist: huggingface_hub; extra == "all"
+Requires-Dist: pydantic; extra == "all"
 Requires-Dist: logfire; extra == "all"
-Requires-Dist: deepmerge; extra == "all"
-Requires-Dist: tinynetrc; extra == "all"
-Requires-Dist: bokeh; extra == "all"
-Requires-Dist: torchaudio; extra == "all"
-Requires-Dist: pydantic-ai[logfire,openai]; extra == "all"
-Requires-Dist: html2text; extra == "all"
-Requires-Dist: flet[all]; extra == "all"
-Requires-Dist: google-auth-httplib2; extra == "all"
-Requires-Dist: regex; extra == "all"
 Requires-Dist: appdirs; extra == "all"
-Requires-Dist: pydantic-settings; extra == "all"
 Requires-Dist: pandas; extra == "all"
-Requires-Dist: pydantic; extra == "all"
-Requires-Dist: pydevd-pycharm~=251.25410.159; extra == "all"
-Requires-Dist: Unidecode; extra == "all"
+Requires-Dist: sentence_transformers; extra == "all"
 Requires-Dist: openai; extra == "all"
+Requires-Dist: torchaudio; extra == "all"
 Requires-Dist: google-api-python-client; extra == "all"
+Requires-Dist: dask[bag]; extra == "all"
+Requires-Dist: ollama; extra == "all"
 Requires-Dist: dnspython[doh]; extra == "all"
-Requires-Dist: pymupdf4llm; extra == "all"
-Requires-Dist: setuptools; extra == "all"
+Requires-Dist: google-auth-httplib2; extra == "all"
+Requires-Dist: fastapi; extra == "all"
+Requires-Dist: regex; extra == "all"
+Requires-Dist: google-auth-oauthlib; extra == "all"
+Requires-Dist: peft; extra == "all"
+Requires-Dist: flet[all]; extra == "all"
+Requires-Dist: pymupdf; extra == "all"
+Requires-Dist: huggingface_hub; extra == "all"
 Requires-Dist: filetype; extra == "all"
-Requires-Dist: transformers[sentencepiece]; extra == "all"
+Requires-Dist: cachetools; extra == "all"
+Requires-Dist: httpx_retries; extra == "all"
+Requires-Dist: yamlscript; extra == "all"
+Requires-Dist: faker; extra == "all"
+Requires-Dist: sre_yield; extra == "all"
+Requires-Dist: torchvision; extra == "all"
+Requires-Dist: distributed; extra == "all"
+Requires-Dist: json_repair; extra == "all"
 Requires-Dist: flet-webview; extra == "all"
+Requires-Dist: setuptools; extra == "all"
+Requires-Dist: tabulate; extra == "all"
+Requires-Dist: deepmerge; extra == "all"
+Requires-Dist: logfire[httpx]; extra == "all"
+Requires-Dist: flet-video; extra == "all"
+Requires-Dist: logfire[fastapi]; extra == "all"
+Requires-Dist: pymupdf4llm; extra == "all"
+Requires-Dist: docker; extra == "all"
+Requires-Dist: pydantic-settings; extra == "all"
+Requires-Dist: Unidecode; extra == "all"
+Requires-Dist: transformers[sentencepiece]; extra == "all"
+Requires-Dist: pyyaml; extra == "all"
+Requires-Dist: pydantic-ai[logfire,openai]; extra == "all"
 Requires-Dist: openpyxl; extra == "all"
-Requires-Dist: json_repair; extra == "all"
+Requires-Dist: html2text; extra == "all"
+Requires-Dist: pydevd-pycharm~=251.25410.159; extra == "all"
 Requires-Dist: semver; extra == "all"
-Requires-Dist: torchvision; extra == "all"
-Requires-Dist: pyyaml; extra == "all"
-Requires-Dist: ollama; extra == "all"
+Requires-Dist: tinynetrc; extra == "all"
+Requires-Dist: httpx; extra == "all"
+Requires-Dist: bokeh; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: description

{fmtr_tools-1.3.26.dist-info → fmtr_tools-1.3.27.dist-info}/RECORD

@@ -3,7 +3,7 @@ fmtr/tools/api_tools.py,sha256=RyZUlTefSQozfl-8feZGauyUkwcFd-jU0KtKHFxHea4,2272
 fmtr/tools/async_tools.py,sha256=ewz757WcveQJd-G5SVr2JDOQVbdLGecCgl-tsBGVZz4,284
 fmtr/tools/augmentation_tools.py,sha256=-6ESbO4CDlKqVOV1J1V6qBeoBMzbFIinkDHRHnCBej0,55
 fmtr/tools/caching_tools.py,sha256=74p7m2GLFfeP41LX69wxgfkilxEAoWkMIfFMjKsYpyg,4976
-fmtr/tools/constants.py,sha256=6kFaD7ZI7rflaVFfSAtVi0pMrMtNYhWhKNkfV3lBd60,1543
+fmtr/tools/constants.py,sha256=5pZ8TOrOwM2vmag6Db4CDCGxs6kAbzjhTi28NBii5eI,1590
 fmtr/tools/data_modelling_tools.py,sha256=0BFm-F_cYzVTxftWQwORkPd0FM2BTLVh9-s0-rTTFoo,1744
 fmtr/tools/dataclass_tools.py,sha256=0Gt6KeLhtPgubo_2tYkIVqB8oQ91Qzag8OAGZDdjvMU,1209
 fmtr/tools/datatype_tools.py,sha256=3P4AWIFGkJ-UqvXlj0Jc9IvkIIgTOE9jRrOk3NVbpH8,1508
@@ -43,7 +43,7 @@ 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=hS5wAr_5edPJvBlKaOvwuUi2O2fdFTHx-Jl3gWrRcC0,6
+fmtr/tools/version,sha256=L22QqrPxBmPDhCXeqD5MlhBpAb3l7G-RhlHUumdO74k,6
 fmtr/tools/yaml_tools.py,sha256=Bhhyd6GQVKO72Lp8ky7bAUjIB_65Hdh0Q45SKIEe6S8,1901
 fmtr/tools/ai_tools/__init__.py,sha256=JZrLuOFNV1A3wvJgonxOgz_4WS-7MfCuowGWA5uYCjs,372
 fmtr/tools/ai_tools/agentic_tools.py,sha256=acSEPFS-aguDXanWGs3fAAlRyJSYPZW7L-Kb2qDLm-I,4300
@@ -60,7 +60,7 @@ fmtr/tools/entrypoints/install_yamlscript.py,sha256=D9-QET4uPkwMvOBQJAgzn1fYb7Z7
 fmtr/tools/entrypoints/remote_debug_test.py,sha256=wmKg9o2pQq7eqeHmaO8oviujNgtnsCVEXOdXLIcQWs4,123
 fmtr/tools/entrypoints/shell_debug.py,sha256=0No3tAg9Ri4_vvSlQCUtAY-11HR0nE45i0VVtiAViwY,106
 fmtr/tools/interface_tools/__init__.py,sha256=RBg-QC7OO-PdAbFBadzHTzgjASchrKavAqdVbmBq4nM,310
-fmtr/tools/interface_tools/controls.py,sha256=C0aE839EnA8tLQN0e2VHRbjCiCp73-3HuW_ceKiK8tQ,1620
+fmtr/tools/interface_tools/controls.py,sha256=W5gVzxLqgiqVp4Ryr3UR4Yrtmoz5IeDpl9hw3Sld2W8,2991
 fmtr/tools/interface_tools/interface_tools.py,sha256=FBvtWSGFvgieDT-cOSY9KAW6csnObFKyj8O-QnsekE4,2252
 fmtr/tools/path_tools/__init__.py,sha256=v5CpmzXq5Ii90FtcmxAJKiLxmguZMrPnQ_HdT872Np0,443
 fmtr/tools/path_tools/app_path_tools.py,sha256=JrJvtTDd_gkCKcZtBCDTMktsM77PZwGV_hzQX0g5GU8,1722
@@ -78,9 +78,9 @@ fmtr/tools/tests/test_path.py,sha256=AkZQa6_8BQ-VaCyL_J-iKmdf2ZaM-xFYR37Kun3k4_g
 fmtr/tools/tests/test_yaml.py,sha256=jc0TwwKu9eC0LvFGNMERdgBue591xwLxYXFbtsRwXVM,287
 fmtr/tools/version_tools/__init__.py,sha256=pg4iLtmIr5HtyEW_j0fMFoIdzqi_w9xH8-grQaXLB28,318
 fmtr/tools/version_tools/version_tools.py,sha256=Hcc6yferZS1hHbugRTdiHhSNmXEEG0hjCiTTXKna-YY,1127
-fmtr_tools-1.3.26.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.3.26.dist-info/METADATA,sha256=NPa0iGerC4VdBPNEfmWWUotvqUz0V2ROXbpf5GzB_0o,15938
-fmtr_tools-1.3.26.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fmtr_tools-1.3.26.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
-fmtr_tools-1.3.26.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
-fmtr_tools-1.3.26.dist-info/RECORD,,
+fmtr_tools-1.3.27.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.3.27.dist-info/METADATA,sha256=fVe8m5ZB4wBTxaDT86g6JvR3NuWwVtIwJLsaX7u1im8,15938
+fmtr_tools-1.3.27.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fmtr_tools-1.3.27.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
+fmtr_tools-1.3.27.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.3.27.dist-info/RECORD,,