fmtr.tools 1.3.27__tar.gz → 1.3.29__tar.gz

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

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

{fmtr_tools-1.3.27 → fmtr_tools-1.3.29}/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-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/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-1.3.29/fmtr/tools/version

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

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

{fmtr_tools-1.3.27 → 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
@@ -21,6 +22,7 @@ setup.py
 ./fmtr/tools/html_tools.py
 ./fmtr/tools/http_tools.py
 ./fmtr/tools/import_tools.py
+./fmtr/tools/inherit_tools.py
 ./fmtr/tools/inspection_tools.py
 ./fmtr/tools/iterator_tools.py
 ./fmtr/tools/json_fix_tools.py
@@ -94,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
@@ -107,6 +110,7 @@ fmtr/tools/hfh_tools.py
 fmtr/tools/html_tools.py
 fmtr/tools/http_tools.py
 fmtr/tools/import_tools.py
+fmtr/tools/inherit_tools.py
 fmtr/tools/inspection_tools.py
 fmtr/tools/iterator_tools.py
 fmtr/tools/json_fix_tools.py

fmtr_tools-1.3.27/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.27/fmtr/tools/version

@@ -1 +0,0 @@
-1.3.27

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

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