fmtr.tools 1.3.28__tar.gz → 1.3.29__tar.gz

{fmtr_tools-1.3.28 → fmtr_tools-1.3.29}/PKG-INFO

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

fmtr_tools-1.3.29/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-1.3.29/fmtr/tools/function_tools.py

@@ -0,0 +1,91 @@
+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:
+    """
+
+    Combines arguments and keyword arguments into a single dictionary.
+
+    """
+    args = args or []
+    kwargs = kwargs or {}
+    args = {i: arg for i, arg in enumerate(args)}
+    args.update(kwargs)
+    if all(isinstance(key, int) for key in args.keys()):
+        args = list(args.values())
+    return args
+
+
+def split_args_kwargs(args_kwargs: dict) -> Tuple[list, dict]:
+    """
+
+    Splits arguments and keyword arguments into a list and a dictionary.
+
+    """
+    if isinstance(args_kwargs, list):
+        args, kwargs = args_kwargs, {}
+    else:
+        args = [arg for key, arg in args_kwargs.items() if isinstance(key, int)]
+        kwargs = {key: arg for key, arg in args_kwargs.items() if not isinstance(key, int)}
+
+    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-1.3.29/fmtr/tools/version

@@ -0,0 +1 @@
+1.3.29

{fmtr_tools-1.3.28 → fmtr_tools-1.3.29}/fmtr.tools.egg-info/PKG-INFO

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

{fmtr_tools-1.3.28 → fmtr_tools-1.3.29}/fmtr.tools.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ setup.py
 ./fmtr/tools/augmentation_tools.py
 ./fmtr/tools/caching_tools.py
 ./fmtr/tools/constants.py
+./fmtr/tools/context_tools.py
 ./fmtr/tools/data_modelling_tools.py
 ./fmtr/tools/dataclass_tools.py
 ./fmtr/tools/datatype_tools.py
@@ -95,6 +96,7 @@ fmtr/tools/async_tools.py
 fmtr/tools/augmentation_tools.py
 fmtr/tools/caching_tools.py
 fmtr/tools/constants.py
+fmtr/tools/context_tools.py
 fmtr/tools/data_modelling_tools.py
 fmtr/tools/dataclass_tools.py
 fmtr/tools/datatype_tools.py

fmtr_tools-1.3.28/fmtr/tools/function_tools.py

@@ -1,33 +0,0 @@
-from typing import Tuple
-
-
-def combine_args_kwargs(args: dict=None, kwargs: dict=None) -> dict:
-    """
-
-    Combines arguments and keyword arguments into a single dictionary.
-
-    """
-    args = args or []
-    kwargs = kwargs or {}
-    args = {i: arg for i, arg in enumerate(args)}
-    args.update(kwargs)
-    if all(isinstance(key, int) for key in args.keys()):
-        args = list(args.values())
-    return args
-
-
-def split_args_kwargs(args_kwargs: dict) -> Tuple[list, dict]:
-    """
-
-    Splits arguments and keyword arguments into a list and a dictionary.
-
-    """
-    if isinstance(args_kwargs, list):
-        args, kwargs = args_kwargs, {}
-    else:
-        args = [arg for key, arg in args_kwargs.items() if isinstance(key, int)]
-        kwargs = {key: arg for key, arg in args_kwargs.items() if not isinstance(key, int)}
-
-    return args, kwargs
-
-

fmtr_tools-1.3.28/fmtr/tools/version

@@ -1 +0,0 @@
-1.3.28

{fmtr_tools-1.3.28 → fmtr_tools-1.3.29}/fmtr.tools.egg-info/requires.txt

@@ -14,61 +14,61 @@ pydantic-ai[logfire,openai]
 ollama
 
 [all]
-regex
-pandas
-httpx
-google-auth
-torchvision
-flet[all]
-openpyxl
-google-auth-oauthlib
-cachetools
+tinynetrc
 filetype
-setuptools
-sentence_transformers
+dnspython[doh]
+json_repair
+ollama
+google-auth
 pydantic-settings
-bokeh
-peft
-flet-webview
+semver
 openai
-torchaudio
-google-api-python-client
-deepmerge
-diskcache
-huggingface_hub
+distributed
+yamlscript
+dask[bag]
+pyyaml
+tabulate
+flet-webview
+flet-video
 logfire[fastapi]
+torchaudio
+pymupdf
+pandas
+regex
+pydantic-ai[logfire,openai]
+google-auth-oauthlib
 google-auth-httplib2
-Unidecode
-ollama
-pydevd-pycharm~=251.25410.159
-dnspython[doh]
-flet-video
+docker
+sentence_transformers
 httpx_retries
-json_repair
-pymupdf4llm
-pytest-cov
-sre_yield
+torchvision
+uvicorn[standard]
+faker
+transformers[sentencepiece]
+setuptools
+bokeh
 contexttimer
-semver
-pydantic-ai[logfire,openai]
 fastapi
 tokenizers
-logfire[httpx]
-pymupdf
+diskcache
+cachetools
+pydevd-pycharm~=251.25410.159
+openpyxl
+appdirs
+huggingface_hub
+pytest-cov
+sre_yield
+flet[all]
 html2text
+google-api-python-client
 pydantic
-yamlscript
-uvicorn[standard]
-distributed
-faker
-docker
+Unidecode
+peft
+pymupdf4llm
+httpx
+deepmerge
 logfire
-appdirs
-pyyaml
-dask[bag]
-transformers[sentencepiece]
-tabulate
-tinynetrc
+logfire[httpx]
 
 [api]
 fastapi