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

fmtr/tools/__init__.py

@@ -6,6 +6,7 @@ import fmtr.tools.environment_tools as environment
 import fmtr.tools.function_tools as function
 import fmtr.tools.hash_tools as hash
 import fmtr.tools.import_tools as import_
+import fmtr.tools.inherit_tools as inherit
 import fmtr.tools.iterator_tools as iterator
 import fmtr.tools.json_tools as json
 import fmtr.tools.logging_tools as logging

fmtr/tools/context_tools.py

@@ -0,0 +1,23 @@
+from contextlib import contextmanager, ExitStack
+
+
+@contextmanager
+def null():
+    """
+
+    Null context manager.
+
+    """
+    yield
+
+
+@contextmanager
+def contexts(*contexts):
+    """
+
+    Tee context managers.
+
+    """
+    with ExitStack() as stack:
+        resources = [stack.enter_context(context) for context in contexts]
+        yield resources

fmtr/tools/function_tools.py

@@ -1,5 +1,9 @@
+import functools
+import inspect
 from typing import Tuple
 
+from fmtr.tools import context_tools
+
 
 def combine_args_kwargs(args: dict=None, kwargs: dict=None) -> dict:
     """
@@ -31,3 +35,57 @@ def split_args_kwargs(args_kwargs: dict) -> Tuple[list, dict]:
     return args, kwargs
 
 
+class BoundDecorator:
+    """
+
+    Bound method decorator with overridable start/stop and context manager
+
+    """
+
+    def __init__(self, func):
+        self.func = func
+        self.context_null = context_tools.null()
+        functools.update_wrapper(self, func)
+
+    def get_context(self, instance):
+        """
+
+        By default use a null context.
+
+        """
+        return self.context_null
+
+    def __get__(self, instance, owner):
+        """
+
+        Wrap at runtime, call start/stop within context.
+
+        """
+        if instance is None:
+            return self.func
+
+        if inspect.iscoroutinefunction(self.func):
+            async def async_wrapper(*args, **kwargs):
+                with self.get_context(instance):
+                    self.start(instance)
+                    result = await self.func(instance, *args, **kwargs)
+                    self.stop(instance)
+                    return result
+
+            return functools.update_wrapper(async_wrapper, self.func)
+
+        else:
+            def sync_wrapper(*args, **kwargs):
+                with self.get_context(instance):
+                    self.start(instance)
+                    result = self.func(instance, *args, **kwargs)
+                    self.stop(instance)
+                    return result
+
+            return functools.update_wrapper(sync_wrapper, self.func)
+
+    def start(self, instance):
+        pass
+
+    def stop(self, instance):
+        pass

fmtr/tools/inherit_tools.py

@@ -0,0 +1,27 @@
+from typing import TypeVar, Generic
+
+T = TypeVar("T")
+
+
+class Inherit(Generic[T]):
+    """
+
+    Runtime inheritance. Acts like a wrapper around an instantiated base class of type T, and allows overriding methods in subclasses like regular inheritance.
+
+    """
+
+    def __init__(self, parent: T):
+        """
+
+        Set parent
+
+        """
+        object.__setattr__(self, "_parent", parent)
+
+    def __getattr__(self, name):
+        """
+
+        Since regular attribute access checks own methods first, we don't need to do anything fancy to fall back to the parent when not implemented.
+
+        """
+        return getattr(self._parent, name)

fmtr/tools/version

@@ -1 +1 @@
-1.3.27
+1.3.29

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.3.27
+Version: 1.3.29
 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: tokenizers; extra == "all"
-Requires-Dist: uvicorn[standard]; extra == "all"
-Requires-Dist: pytest-cov; extra == "all"
+Requires-Dist: httpx_retries; extra == "all"
 Requires-Dist: google-auth; extra == "all"
-Requires-Dist: diskcache; extra == "all"
-Requires-Dist: contexttimer; extra == "all"
-Requires-Dist: pydantic; extra == "all"
-Requires-Dist: logfire; extra == "all"
-Requires-Dist: appdirs; extra == "all"
-Requires-Dist: pandas; 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: 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: transformers[sentencepiece]; extra == "all"
 Requires-Dist: pymupdf; extra == "all"
+Requires-Dist: faker; extra == "all"
+Requires-Dist: cachetools; extra == "all"
+Requires-Dist: tabulate; extra == "all"
 Requires-Dist: huggingface_hub; extra == "all"
+Requires-Dist: diskcache; extra == "all"
+Requires-Dist: pydantic-settings; extra == "all"
 Requires-Dist: filetype; extra == "all"
-Requires-Dist: cachetools; extra == "all"
-Requires-Dist: httpx_retries; extra == "all"
+Requires-Dist: logfire[fastapi]; extra == "all"
+Requires-Dist: pydantic; extra == "all"
+Requires-Dist: torchaudio; extra == "all"
+Requires-Dist: pandas; extra == "all"
+Requires-Dist: distributed; extra == "all"
+Requires-Dist: dnspython[doh]; extra == "all"
+Requires-Dist: regex; extra == "all"
+Requires-Dist: sentence_transformers; extra == "all"
+Requires-Dist: contexttimer; extra == "all"
+Requires-Dist: google-auth-httplib2; extra == "all"
+Requires-Dist: tinynetrc; extra == "all"
+Requires-Dist: ollama; extra == "all"
+Requires-Dist: docker; extra == "all"
+Requires-Dist: logfire[httpx]; extra == "all"
+Requires-Dist: dask[bag]; extra == "all"
 Requires-Dist: yamlscript; extra == "all"
-Requires-Dist: faker; extra == "all"
-Requires-Dist: sre_yield; extra == "all"
+Requires-Dist: flet[all]; extra == "all"
+Requires-Dist: peft; extra == "all"
+Requires-Dist: pytest-cov; extra == "all"
+Requires-Dist: fastapi; extra == "all"
+Requires-Dist: deepmerge; extra == "all"
 Requires-Dist: torchvision; extra == "all"
-Requires-Dist: distributed; extra == "all"
-Requires-Dist: json_repair; extra == "all"
+Requires-Dist: sre_yield; extra == "all"
+Requires-Dist: tokenizers; extra == "all"
+Requires-Dist: html2text; extra == "all"
 Requires-Dist: flet-webview; extra == "all"
+Requires-Dist: appdirs; extra == "all"
+Requires-Dist: json_repair; extra == "all"
+Requires-Dist: google-api-python-client; extra == "all"
+Requires-Dist: pyyaml; extra == "all"
+Requires-Dist: logfire; extra == "all"
+Requires-Dist: Unidecode; extra == "all"
+Requires-Dist: semver; 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: bokeh; extra == "all"
+Requires-Dist: openpyxl; 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: httpx; extra == "all"
 Requires-Dist: pydantic-ai[logfire,openai]; extra == "all"
-Requires-Dist: openpyxl; extra == "all"
-Requires-Dist: html2text; extra == "all"
+Requires-Dist: uvicorn[standard]; extra == "all"
 Requires-Dist: pydevd-pycharm~=251.25410.159; extra == "all"
-Requires-Dist: semver; 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.27.dist-info → fmtr_tools-1.3.29.dist-info}/RECORD

@@ -1,22 +1,24 @@
-fmtr/tools/__init__.py,sha256=9wmfLcYMilcfMS5NfOnaxUn7qxT4YZJ0MFwzOxeh-cQ,5625
+fmtr/tools/__init__.py,sha256=02EgGggVmiHs81W5gXGX49F53DZO956jGwrFUMHmUTo,5668
 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=5pZ8TOrOwM2vmag6Db4CDCGxs6kAbzjhTi28NBii5eI,1590
+fmtr/tools/context_tools.py,sha256=4UvIHYgLqAh7dXMX9EBrLEpYp81qfzhSVrkffOSAoGA,350
 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
 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=_oW3-HZXMst2pcU-I-U7KTMmzo0g9MIQKmX-c2_NEoE,858
+fmtr/tools/function_tools.py,sha256=fbOCk2_o9RB1Eps7lrduf7nm93a1H62w9Z49x2FvAWA,2375
 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
 fmtr/tools/html_tools.py,sha256=0nN8Nz5HtG9bXyApYfHSKEivLlxjsm3Gn6Mg2TK0brI,394
 fmtr/tools/http_tools.py,sha256=RVwGrBNMyjfbpgAPCSnxEkXfSzXXWARb3ayq981ONQE,464
 fmtr/tools/import_tools.py,sha256=XJmiWLukRncJAcaGReDn4jIz1_IpVBjfYCQHH1hIg7c,588
+fmtr/tools/inherit_tools.py,sha256=gTGL4mRm5RsbFW76s25AbuAJ2vlymbh1c8Q4Hl2uJGU,646
 fmtr/tools/inspection_tools.py,sha256=tLTRvzy9XVomQPi0dfnF_cgwc7KiDVZAr7gPTk4S_bQ,278
 fmtr/tools/iterator_tools.py,sha256=xj5f0c7LgLK53dddRRRJxBoLaBzlZoQS3_GfmpDPMoo,1311
 fmtr/tools/json_fix_tools.py,sha256=vNSlswVQnujPmKEqDjFJcO901mjMyv59q3awsT7mlhs,477
@@ -43,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=L22QqrPxBmPDhCXeqD5MlhBpAb3l7G-RhlHUumdO74k,6
+fmtr/tools/version,sha256=NUTl8Yr_rYvLMHb0tH-4fCfEhIlAfyA63OegFPMrwgc,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
@@ -78,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.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,,
+fmtr_tools-1.3.29.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.3.29.dist-info/METADATA,sha256=6HSn_2iCjQC37aDMtMZ_Ebm8c9Bw1WrEaDUODBRpfn0,15938
+fmtr_tools-1.3.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fmtr_tools-1.3.29.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
+fmtr_tools-1.3.29.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.3.29.dist-info/RECORD,,