fmtr.tools 1.3.34__py3-none-any.whl → 1.3.36__py3-none-any.whl

fmtr/tools/__init__.py

@@ -168,6 +168,11 @@ try:
 except ImportError as exception:
     http = Client = MissingExtraMockModule('http', exception)
 
+try:
+    from fmtr.tools import webhook_tools as webhook
+except ImportError as exception:
+    webhook = MissingExtraMockModule('webhook', exception)
+
 
 def get_version():
     """

fmtr/tools/constants.py

@@ -53,3 +53,4 @@ class Constants:
     INFRA = 'infra'
 
     PROMPT_NONE_SPECIFIED = '[None Specified]'
+    WEBHOOK_URL_NOTIFY_KEY = 'WEBHOOK_URL_NOTIFY'

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/version

@@ -1 +1 @@
-1.3.34
+1.3.36

fmtr/tools/webhook_tools.py

@@ -0,0 +1,17 @@
+from fmtr.tools import environment_tools, Constants
+from fmtr.tools.http_tools import client
+
+
+def notify(title, body, url=None):
+    """
+
+    Send simple debug notification
+
+    """
+    url = url or environment_tools.get(Constants.WEBHOOK_URL_NOTIFY_KEY)
+    client.post(url, json=dict(title=title, body=body))
+
+
+if __name__ == '__main__':
+    notify('Title', 'Body')
+    notify

{fmtr_tools-1.3.34.dist-info → fmtr_tools-1.3.36.dist-info}/METADATA

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

{fmtr_tools-1.3.34.dist-info → fmtr_tools-1.3.36.dist-info}/RECORD

@@ -1,9 +1,9 @@
-fmtr/tools/__init__.py,sha256=02EgGggVmiHs81W5gXGX49F53DZO956jGwrFUMHmUTo,5668
+fmtr/tools/__init__.py,sha256=S09QiP8hSJcJKWWFxgrFOunToA4yKCnnq9SaNGtfWYs,5818
 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=iyn8cKNJ4tnX4BKpR0tWjD_U3RUa2THzU4jDhoWn17A,1648
+fmtr/tools/constants.py,sha256=idsZZ_IBkWFZusrv0_0YM0_yHM92_jqiFhfTz-GYkBg,1698
 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
@@ -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,8 @@ 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=ZOiSAtzwnYgSAHIF83-noRMUKSEpP8MZprQqGOOJbAY,6
+fmtr/tools/version,sha256=xvILRagoG7hEEPWTSMHMAuoniWksi-1PA7Yi_3QgMoc,6
+fmtr/tools/webhook_tools.py,sha256=q3pVJ1NCem2SrMuFcLxiWd7DibFs7Q-uGtojfXd3Qcg,380
 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
@@ -80,9 +81,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.34.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.3.34.dist-info/METADATA,sha256=xyVaIjAH3yktuim6wh613DMUdyYhdJs2rgjjjfrxpKc,15938
-fmtr_tools-1.3.34.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fmtr_tools-1.3.34.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
-fmtr_tools-1.3.34.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
-fmtr_tools-1.3.34.dist-info/RECORD,,
+fmtr_tools-1.3.36.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.3.36.dist-info/METADATA,sha256=1JH4PkeU1OkqTNkJC8q-f4m5QO6LcFoBSSgPGenZMtI,16145
+fmtr_tools-1.3.36.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fmtr_tools-1.3.36.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
+fmtr_tools-1.3.36.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.3.36.dist-info/RECORD,,