fmtr.tools 1.3.64__py3-none-any.whl → 1.3.66__py3-none-any.whl

fmtr/tools/data_modelling_tools.py

@@ -8,6 +8,7 @@ from pydantic_core import PydanticUndefined, PydanticUndefinedType
 
 from fmtr.tools.datatype_tools import is_optional
 from fmtr.tools.iterator_tools import get_class_lookup
+from fmtr.tools.string_tools import camel_to_snake
 from fmtr.tools.tools import Auto, Required
 
 
@@ -17,12 +18,13 @@ class Field(FieldInfo):
     Allow DRYer field definitions, set annotation and defaults at the same time, easier field inheritance, etc.
 
     """
+    NAME = Auto
     ANNOTATION = None
     DEFAULT = Auto
     FILLS = None
     DESCRIPTION = None
     TITLE = Auto
-    KWARGS = None
+    CONFIG = None
 
     def __init__(self):
         """
@@ -33,13 +35,27 @@ class Field(FieldInfo):
         title = self.get_title_auto()
         description = self.get_desc()
         default = self.get_default_auto()
-        kwargs = self.KWARGS or {}
+        kwargs = self.CONFIG or {}
 
         if default is Required:
             default = PydanticUndefined
 
         super().__init__(default=default, title=title, description=description, **kwargs)
 
+    @classmethod
+    def get_name_auto(cls) -> str:
+        """
+
+        Infer field name, if set to auto.
+
+        """
+        if cls.NAME is Auto:
+            return camel_to_snake(cls.__name__)
+        elif cls.NAME is None:
+            return cls.__name__
+
+        return cls.NAME
+
     @cached_property
     def fills(self) -> Dict[str, str]:
         """
@@ -169,7 +185,7 @@ class Base(BaseModel, MixinFromJson):
             if isinstance(raw, dict):
                 fields |= raw
             else:
-                fields |= get_class_lookup(*raw, name_function=str.lower)
+                fields |= get_class_lookup(*raw, name_function=lambda cls_field: cls_field.get_name_auto())
 
         cls.FIELDS = fields
 

fmtr/tools/database_tools/document.py

@@ -2,13 +2,23 @@ from functools import cached_property
 from typing import List
 
 import beanie
+from beanie.odm import actions
 from motor.motor_asyncio import AsyncIOMotorClient
 
+from fmtr.tools import data_modelling_tools
 from fmtr.tools.constants import Constants
 from fmtr.tools.logging_tools import logger
 
+ModifyEvents = [
+    actions.Insert,
+    actions.Replace,
+    actions.Save,
+    actions.SaveChanges,
+    actions.Update
+]
 
-class Document(beanie.Document):
+
+class Document(beanie.Document, data_modelling_tools.Base):
     """
 
     Document stub.

fmtr/tools/iterator_tools.py

@@ -2,7 +2,6 @@ from itertools import chain, batched
 from typing import List, Dict, Any
 
 from fmtr.tools.datatype_tools import is_none
-from fmtr.tools.tools import identity
 
 
 def enlist(value) -> List[Any]:
@@ -75,10 +74,10 @@ def dedupe(items):
     return list(dict.fromkeys(items))
 
 
-def get_class_lookup(*classes, name_function=identity):
+def get_class_lookup(*classes, name_function=lambda cls: cls.__name__):
     """
 
     Dictionary of class names to classes
 
     """
-    return {name_function(cls.__name__): cls for cls in classes}
+    return {name_function(cls): cls for cls in classes}

fmtr/tools/string_tools.py

@@ -241,3 +241,18 @@ def trim(text: str) -> str:
 
     """
     return dedent(text).strip()
+
+
+ACRONYM_BOUNDARY = re.compile(r'([A-Z]+)([A-Z][a-z])')
+CAMEL_BOUNDARY = re.compile(r'([a-z0-9])([A-Z])')
+
+
+def camel_to_snake(name: str) -> str:
+    """
+
+    Camel case to snake case
+
+    """
+    name = ACRONYM_BOUNDARY.sub(r'\1_\2', name)
+    name = CAMEL_BOUNDARY.sub(r'\1_\2', name)
+    return name.lower()

fmtr/tools/version

@@ -1 +1 @@
-1.3.64
+1.3.66

{fmtr_tools-1.3.64.dist-info → fmtr_tools-1.3.66.dist-info}/METADATA

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

{fmtr_tools-1.3.64.dist-info → fmtr_tools-1.3.66.dist-info}/RECORD

@@ -5,7 +5,7 @@ fmtr/tools/augmentation_tools.py,sha256=-6ESbO4CDlKqVOV1J1V6qBeoBMzbFIinkDHRHnCB
 fmtr/tools/caching_tools.py,sha256=74p7m2GLFfeP41LX69wxgfkilxEAoWkMIfFMjKsYpyg,4976
 fmtr/tools/constants.py,sha256=90wCirUpw4bWMAbjhip0LL6k57eS5VmxRUP9pLCChBg,1812
 fmtr/tools/context_tools.py,sha256=4UvIHYgLqAh7dXMX9EBrLEpYp81qfzhSVrkffOSAoGA,350
-fmtr/tools/data_modelling_tools.py,sha256=pSAnf-pt-c4RGqDMCkDb_XGxsmEEQqLmBMlMTVU76yg,4916
+fmtr/tools/data_modelling_tools.py,sha256=vD7nbqeQh_azoNZUiVWvK8GuyNE-Qagcqg_RE7wYNBk,5303
 fmtr/tools/dataclass_tools.py,sha256=0Gt6KeLhtPgubo_2tYkIVqB8oQ91Qzag8OAGZDdjvMU,1209
 fmtr/tools/datatype_tools.py,sha256=1XznVwlY4-DkYa6FwhHMstD8qz27vCcV64IvCrcJgMA,1830
 fmtr/tools/datetime_tools.py,sha256=L7wmBoQbD9h_pJIL92WQOX32r_vrXgRvE-_0PVPRAGY,232
@@ -20,7 +20,7 @@ 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=IwHdRj72oP3e191h7gs15g0HEW6haP28t8CmB0R8qbo,1847
+fmtr/tools/iterator_tools.py,sha256=ucsDj-T4YgwRCieFvjBXLfTe4RipL1CJ1_1GOxvEIW8,1816
 fmtr/tools/json_fix_tools.py,sha256=vNSlswVQnujPmKEqDjFJcO901mjMyv59q3awsT7mlhs,477
 fmtr/tools/json_tools.py,sha256=WkFc5q7oqMtcFejhN1K5zQFULa9TdLOup83Fr0saDRY,348
 fmtr/tools/logging_tools.py,sha256=jZFKnL-7HHOaPkn7F3fT9DyffIgwY-g7SEQ0p1RhzBo,2673
@@ -40,19 +40,19 @@ fmtr/tools/random_tools.py,sha256=4VlQdk5THbR8ka4pZaLbk_ZO_4yy6PF_lHZes_rgenY,22
 fmtr/tools/semantic_tools.py,sha256=cxY9NSAHWj4nEc6Oj4qA1omR3dWbl2OuH7_PkINc6_E,1386
 fmtr/tools/settings_tools.py,sha256=o11W3T60UZSvCTkh_eEQq1Mx74GycQ6JxUr0plBDbsk,2356
 fmtr/tools/spaces_tools.py,sha256=D_he3mve6DruB3OPS6QyzqD05ChHnRTb4buViKPe7To,1099
-fmtr/tools/string_tools.py,sha256=fVJADFWHtGStakgPNOPn_lmnRC94v1VYE1ETCmsvJVA,5298
+fmtr/tools/string_tools.py,sha256=ZKHBrl2tui9VjWt7qit4UWbvpuzY6zp5ytiQvhlJVG4,5610
 fmtr/tools/tabular_tools.py,sha256=mw6vOij1Ch-pVAyHMPtm5zj__ULZN_TKeBYOfj33wFM,1634
 fmtr/tools/tokenization_tools.py,sha256=me-IBzSLyNYejLybwjO9CNB6Mj2NYfKPaOVThXyaGNg,4268
 fmtr/tools/tools.py,sha256=sLMXk8juOL8_n_D776cJ-kzjyMHqFI_fctDEjy6PIKs,1115
 fmtr/tools/unicode_tools.py,sha256=yS_9wpu8ogNoiIL7s1G_8bETFFO_YQlo4LNPv1NLDeY,52
-fmtr/tools/version,sha256=PN6bG6VIuodXixpV8uCQygcpWuLKFNtVOv7BZZS_XrQ,6
+fmtr/tools/version,sha256=n4zX1YVX0dMhq7mFDh_xh19zo5isz-FQXXDc31JZieI,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=O8VRlPnnQCncg2ZZ2l_VdWLJf4jkKH6dkZFVbv6o7IM,388
 fmtr/tools/ai_tools/agentic_tools.py,sha256=Zj6WcbDc1yLFi3raTSD0BeOkWR3l5RmmccFYGx8-0XE,5534
 fmtr/tools/ai_tools/inference_tools.py,sha256=2UP2gXEyOJUjyyV6zmFIYmIxUsh1rXkRH0IbFvr2bRs,11908
 fmtr/tools/database_tools/__init__.py,sha256=-YXEs3P4nwg7hdvALpaW4K2Pg9FIc49rD53smqnBgT4,221
-fmtr/tools/database_tools/document.py,sha256=YciaSNYyLSPRFZbHQEVwN-G_7RXgXFaq27IN62--fDA,989
+fmtr/tools/database_tools/document.py,sha256=uGmyznAKqshv8yjFoVRlkPmnSVao3oPJ7iaxvZSpi3g,1214
 fmtr/tools/dns_tools/__init__.py,sha256=HP0Qcwyi1C6vBH_ejuWrGJOWdp-GZ_cmH-QofjD6Mmg,266
 fmtr/tools/dns_tools/client.py,sha256=IBbd7Xgx9ExTn_EPoL7ts9JfXokHHuOiD9m4K6tl1Q0,2817
 fmtr/tools/dns_tools/dm.py,sha256=Lp1HaF7rpVtL_Ji4Bd32B29105H9ZKQ8AcVj_AB7nsA,6678
@@ -85,9 +85,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=cjE6nO6AoVOUp3RwgTbqL9wiw8J1l2pHJOz6Gn6bxjA,326
 fmtr/tools/version_tools/version_tools.py,sha256=Hcc6yferZS1hHbugRTdiHhSNmXEEG0hjCiTTXKna-YY,1127
-fmtr_tools-1.3.64.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.3.64.dist-info/METADATA,sha256=8h7PBKhUZ_hxyfZ1P8NA4z4J2qspewCV8Q4GnePKL2M,18035
-fmtr_tools-1.3.64.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fmtr_tools-1.3.64.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
-fmtr_tools-1.3.64.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
-fmtr_tools-1.3.64.dist-info/RECORD,,
+fmtr_tools-1.3.66.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.3.66.dist-info/METADATA,sha256=FDYRqOEAr_MdQkPYIjC9UYvo2_XIUvpAWDsXPj3Jmc8,18035
+fmtr_tools-1.3.66.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fmtr_tools-1.3.66.dist-info/entry_points.txt,sha256=h-r__Xh5njtFqreMLg6cGuTFS4Qh-QqJPU1HB-_BS-Q,357
+fmtr_tools-1.3.66.dist-info/top_level.txt,sha256=LXem9xCgNOD72tE2gRKESdiQTL902mfFkwWb6-dlwEE,5
+fmtr_tools-1.3.66.dist-info/RECORD,,