fmtr.tools 1.3.33__py3-none-any.whl → 1.3.35__py3-none-any.whl

fmtr/tools/function_tools.py

@@ -47,7 +47,7 @@ class MethodDecorator:
     def __init__(self):
         """
 
-        Initialise with decorator arguments
+        Initialise the decorator itself with any arguments
 
         """
         self.func = None
@@ -55,28 +55,17 @@ class MethodDecorator:
     def __call__(self, func: Callable) -> Self:
         """
 
-        If called, arguments were provided, so return the object with those applied.
+        Add the (unbound) method.
 
         """
         self.func = func
         functools.update_wrapper(self, func)
         return self
 
-    def get_context(self, instance):
-        """
-
-        If the instance has a context attribute, use that - otherwise use a null context.
-
-        """
-        context = getattr(instance, self.CONTEXT_KEY, None)
-        if context:
-            return context
-        return context_tools.null()
-
     def __get__(self, instance, owner):
         """
 
-        Wrap at runtime, call start/stop within context.
+        Wrap bound method at runtime, call start/stop within context.
 
         """
         if instance is None:  # Class method called.
@@ -85,9 +74,9 @@ class MethodDecorator:
         if inspect.iscoroutinefunction(self.func):
             async def async_wrapper(*args, **kwargs):
                 with self.get_context(instance):
-                    self.start(instance)
+                    self.start(instance, *args, **kwargs)
                     result = await self.func(instance, *args, **kwargs)
-                    self.stop(instance)
+                    self.stop(instance, *args, **kwargs)
                     return result
 
             return async_wrapper
@@ -95,15 +84,26 @@ class MethodDecorator:
         else:
             def sync_wrapper(*args, **kwargs):
                 with self.get_context(instance):
-                    self.start(instance)
+                    self.start(instance, *args, **kwargs)
                     result = self.func(instance, *args, **kwargs)
-                    self.stop(instance)
+                    self.stop(instance, *args, **kwargs)
                     return result
 
             return sync_wrapper
 
-    def start(self, instance):
+    def get_context(self, instance):
+        """
+
+        If the instance has a context attribute, use that - otherwise use a null context.
+
+        """
+        context = getattr(instance, self.CONTEXT_KEY, None)
+        if context:
+            return context
+        return context_tools.null()
+
+    def start(self, instance, *args, **kwargs):
         pass
 
-    def stop(self, instance):
+    def stop(self, instance, *args, **kwargs):
         pass

fmtr/tools/interface_tools/interface_tools.py

@@ -1,3 +1,5 @@
+from functools import cached_property
+
 import flet as ft
 from flet.core.types import AppView
 from flet.core.view import View
@@ -88,12 +90,25 @@ class Interface(ft.Column):
         if not page.on_route_change:
             page.theme = cls.get_theme()
             page.views.clear()
-            page.views.append(cls())
+            self = cls()
+            view = self.view
+            if not view:
+                view = self
+            page.views.append(view)
             page.on_route_change = cls.route
             page.on_view_pop = cls.pop
 
             page.go(cls.ROUTE_ROOT)
 
+    @cached_property
+    def view(self):
+        """
+
+        Overridable view definition.
+
+        """
+        return None
+
     @classmethod
     def route(cls, event: ft.RouteChangeEvent):
         """

fmtr/tools/version

@@ -1 +1 @@
-1.3.33
+1.3.35

{fmtr_tools-1.3.33.dist-info → fmtr_tools-1.3.35.dist-info}/METADATA

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

{fmtr_tools-1.3.33.dist-info → fmtr_tools-1.3.35.dist-info}/RECORD

@@ -11,7 +11,7 @@ fmtr/tools/datatype_tools.py,sha256=3P4AWIFGkJ-UqvXlj0Jc9IvkIIgTOE9jRrOk3NVbpH8,
 fmtr/tools/debugging_tools.py,sha256=_xzqS0V5BpL8d06j-jVQjGgI7T020QsqVXKAKMz7Du8,2082
 fmtr/tools/docker_tools.py,sha256=rdaZje2xhlmnfQqZnR7IHgRdWncTLjrJcViUTt5oEwk,617
 fmtr/tools/environment_tools.py,sha256=jlx6LYFVv9tyNBT_pVD-tDhyR3ccNC7w6ENVlnoxCLM,1823
-fmtr/tools/function_tools.py,sha256=c3exfRVTd3fN8N1lT1sdbj7M50XL-GoevkSOb7Eo7EU,2752
+fmtr/tools/function_tools.py,sha256=O1K8HwftXfzrBblNZrj-BhWNbr4poJghrXNr2mFcylI,2831
 fmtr/tools/google_api_tools.py,sha256=owWE0GlnJjmVbXus8ENxT2PH7Fnd3m_r-14xyR7lAnA,1107
 fmtr/tools/hash_tools.py,sha256=tr4HXpeT6rRrDk6TvMlRPUSrLRRaov96y128OI2tzsc,729
 fmtr/tools/hfh_tools.py,sha256=DCDIWuWlhtmIGCtp9cLcOTTEw_4yN_NocLX8w5NZsbk,2384
@@ -45,7 +45,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=vmxTAvLKZhzFgfuMMISjooj9JcEzyYMgvefLRN_twHY,6
+fmtr/tools/version,sha256=zQ9tfgNLSm8eypgWubvyEsSaGYhR9voA6WlTkZPeMVM,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=8su8wmSEoQaDoDnmcKy_DvtWzssBEpNJtH4PzNAKZUE,4782
@@ -63,7 +63,7 @@ fmtr/tools/entrypoints/remote_debug_test.py,sha256=wmKg9o2pQq7eqeHmaO8oviujNgtns
 fmtr/tools/entrypoints/shell_debug.py,sha256=0No3tAg9Ri4_vvSlQCUtAY-11HR0nE45i0VVtiAViwY,106
 fmtr/tools/interface_tools/__init__.py,sha256=nODVT7v657onpmak7qbW4P8NoW2HQqyeEDUSx5pZAFg,331
 fmtr/tools/interface_tools/controls.py,sha256=oOl0_sZB8fkvYB-9A5yjArfQmFQLMCsVGgRNrJAFJm4,332
-fmtr/tools/interface_tools/interface_tools.py,sha256=kQusNsZZU2VWQ_IZu78muS8RpOZRNNmORRBIA7HKXYY,3307
+fmtr/tools/interface_tools/interface_tools.py,sha256=a7WRwf8TKek8ML08ANfkncLfoMHWk5b_929bFf3Y6cQ,3577
 fmtr/tools/path_tools/__init__.py,sha256=v5CpmzXq5Ii90FtcmxAJKiLxmguZMrPnQ_HdT872Np0,443
 fmtr/tools/path_tools/app_path_tools.py,sha256=JrJvtTDd_gkCKcZtBCDTMktsM77PZwGV_hzQX0g5GU8,1722
 fmtr/tools/path_tools/path_tools.py,sha256=eh30PpmH0wopy0wNWuPT84cmXY1EvqsTSDT7AV_GPOY,8034
@@ -80,9 +80,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.33.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.3.33.dist-info/METADATA,sha256=7H3tjWWEroxKZAxXzbl7jG85b8dtrmnT4nbjy_ROQrA,15938
-fmtr_tools-1.3.33.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fmtr_tools-1.3.33.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
-fmtr_tools-1.3.33.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
-fmtr_tools-1.3.33.dist-info/RECORD,,
+fmtr_tools-1.3.35.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.3.35.dist-info/METADATA,sha256=pY-FlOv8SKARTP-sfVb4Grjd8K853QgmRaKyzImjbcM,15938
+fmtr_tools-1.3.35.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fmtr_tools-1.3.35.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
+fmtr_tools-1.3.35.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.3.35.dist-info/RECORD,,