fmtr.tools 1.1.6__py3-none-any.whl → 1.1.8__py3-none-any.whl

fmtr/tools/constants.py

@@ -29,6 +29,9 @@ class Constants:
     FMTR_AI_HOST_DEFAULT = 'ai.gex.fmtr.dev'
 
     FILENAME_CONFIG = 'settings.yaml'
-    DIR_NAME_ARTIFACTS = 'artifacts'
+    DIR_NAME_REPO = 'repo'
+    DIR_NAME_DATA = 'data'
+    DIR_NAME_ARTIFACT = 'artifact'
+    DIR_NAME_SOURCE = 'source'
     FILENAME_VERSION = 'version'
     DIR_NAME_HF = 'hf'

fmtr/tools/debugging_tools.py

@@ -74,6 +74,7 @@ def debug_shell():
     and enabling tracing with debug mode turned on.
 
     """
+    import sys
     path_str = sys.argv[1]
     data = ShellDebug.from_path(path_str)
     trace(is_debug=True)

fmtr/tools/path_tools.py

@@ -145,6 +145,15 @@ class Path(type(Path())):
         """
         return self.mkdir(parents=True, exist_ok=True)
 
+    @property
+    def exist(self):
+        """
+
+        Exists as property
+
+        """
+        return super().exists()
+
 
 class PackagePaths:
     """
@@ -153,7 +162,10 @@ class PackagePaths:
 
     """
 
-    def __init__(self, path=None, org_singleton=None, dir_name_artifacts=Constants.DIR_NAME_ARTIFACTS, filename_config=Constants.FILENAME_CONFIG, file_version=Constants.FILENAME_VERSION):
+    dev = Path('/') / 'opt' / 'dev'
+    data_global = dev / Constants.DIR_NAME_DATA
+
+    def __init__(self, path=None, org_singleton=None, dir_name_data=Constants.DIR_NAME_DATA, filename_config=Constants.FILENAME_CONFIG, file_version=Constants.FILENAME_VERSION):
 
         """
 
@@ -166,10 +178,19 @@ class PackagePaths:
 
         self.path = Path(path)
         self.org_singleton = org_singleton
-        self.dir_name_artifacts = dir_name_artifacts
+        self.dir_name_data = dir_name_data
         self.filename_config = filename_config
         self.filename_version = file_version
 
+    @property
+    def is_dev(self) -> bool:
+        """
+
+        Is the package in the dev directory - as opposed to `site-packages` etc?
+
+        """
+        return self.path.is_relative_to(self.dev)
+
     @property
     def is_namespace(self) -> bool:
         """
@@ -188,6 +209,19 @@ class PackagePaths:
         """
         return self.path.stem
 
+    @property
+    def name_ns(self) -> str:
+        """
+
+        Name of namespace package.
+
+        """
+
+        if self.is_namespace:
+            return f'{self.org}.{self.name}'
+        else:
+            return self.name
+
     @property
     def org(self) -> str:
         """
@@ -222,20 +256,36 @@ class PackagePaths:
         return self.path / self.filename_version
 
     @property
-    def artifacts(self) -> Path:
+    def data(self) -> Path:
         """
 
-        Path of artifacts directory.
+        Path of project-specific data directory.
 
         """
 
-        from fmtr.tools import env
-        if env.IS_DEBUG:
-            path = self.repo / self.dir_name_artifacts
-        else:
-            path = Path('/') / self.dir_name_artifacts
+        return self.dev / Constants.DIR_NAME_REPO / self.name_ns / self.dir_name_data
+
+    @property
+    def artifact(self) -> Path:
+        """
+
+        Path of project-specific artifact directory
+
+        """
+
+        return self.data / Constants.DIR_NAME_ARTIFACT
+
+    @property
+    def source(self) -> Path:
+        """
+
+        Path of project-specific source directory
+
+        """
+
+        return self.data / Constants.DIR_NAME_SOURCE
+
 
-        return path
 
     @property
     def settings(self) -> Path:
@@ -244,7 +294,7 @@ class PackagePaths:
         Path of settings file.
 
         """
-        return self.artifacts / self.filename_config
+        return self.data / self.filename_config
 
     @property
     def hf(self) -> Path:
@@ -253,7 +303,7 @@ class PackagePaths:
         Path of HuggingFace directory
 
         """
-        return self.artifacts / Constants.DIR_NAME_HF
+        return self.artifact / Constants.DIR_NAME_HF
 
     def __repr__(self) -> str:
         """
@@ -262,3 +312,8 @@ class PackagePaths:
 
         """
         return f'{self.__class__.__name__}("{self.path}")'
+
+
+if __name__ == "__main__":
+    paths = PackagePaths()
+    paths

fmtr/tools/version

@@ -1 +1 @@
-1.1.6
+1.1.8

{fmtr_tools-1.1.6.dist-info → fmtr_tools-1.1.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.1.6
+Version: 1.1.8
 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
@@ -9,51 +9,51 @@ License: Copyright © 2025 Frontmatter. All rights reserved.
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: test
-Requires-Dist: google-api-python-client; extra == "test"
 Requires-Dist: pymupdf4llm; extra == "test"
-Requires-Dist: faker; extra == "test"
+Requires-Dist: pydantic-settings; extra == "test"
+Requires-Dist: tinynetrc; extra == "test"
+Requires-Dist: torchvision; extra == "test"
 Requires-Dist: pyyaml; extra == "test"
-Requires-Dist: html2text; extra == "test"
+Requires-Dist: openai; extra == "test"
+Requires-Dist: flet-webview; extra == "test"
 Requires-Dist: pymupdf; extra == "test"
+Requires-Dist: faker; extra == "test"
+Requires-Dist: pydevd-pycharm; extra == "test"
+Requires-Dist: distributed; extra == "test"
 Requires-Dist: contexttimer; extra == "test"
-Requires-Dist: dask[bag]; extra == "test"
-Requires-Dist: json_repair; extra == "test"
-Requires-Dist: torchvision; extra == "test"
-Requires-Dist: pydantic-settings; extra == "test"
-Requires-Dist: huggingface_hub; extra == "test"
-Requires-Dist: logfire[fastapi]; extra == "test"
-Requires-Dist: transformers[sentencepiece]; extra == "test"
-Requires-Dist: sre_yield; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: semver; extra == "test"
+Requires-Dist: bokeh; extra == "test"
 Requires-Dist: torchaudio; extra == "test"
-Requires-Dist: sentence_transformers; extra == "test"
-Requires-Dist: pydantic; extra == "test"
+Requires-Dist: huggingface_hub; extra == "test"
+Requires-Dist: google-auth-oauthlib; extra == "test"
+Requires-Dist: openpyxl; extra == "test"
 Requires-Dist: docker; extra == "test"
-Requires-Dist: tokenizers; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: uvicorn[standard]; extra == "test"
+Requires-Dist: html2text; extra == "test"
+Requires-Dist: google-api-python-client; extra == "test"
+Requires-Dist: sentence_transformers; extra == "test"
+Requires-Dist: logfire; extra == "test"
+Requires-Dist: Unidecode; extra == "test"
+Requires-Dist: diskcache; extra == "test"
+Requires-Dist: flet[all]; extra == "test"
 Requires-Dist: pandas; extra == "test"
-Requires-Dist: openpyxl; extra == "test"
+Requires-Dist: tokenizers; extra == "test"
+Requires-Dist: fastapi; extra == "test"
+Requires-Dist: peft; extra == "test"
+Requires-Dist: json_repair; extra == "test"
+Requires-Dist: google-auth; extra == "test"
+Requires-Dist: transformers[sentencepiece]; extra == "test"
+Requires-Dist: tabulate; extra == "test"
+Requires-Dist: logfire[fastapi]; extra == "test"
 Requires-Dist: ollama; extra == "test"
 Requires-Dist: flet-video; extra == "test"
-Requires-Dist: flet-webview; extra == "test"
-Requires-Dist: pydevd-pycharm; extra == "test"
-Requires-Dist: google-auth; extra == "test"
-Requires-Dist: tinynetrc; extra == "test"
-Requires-Dist: google-auth-oauthlib; extra == "test"
 Requires-Dist: deepmerge; extra == "test"
-Requires-Dist: openai; extra == "test"
-Requires-Dist: diskcache; extra == "test"
-Requires-Dist: bokeh; extra == "test"
-Requires-Dist: logfire; extra == "test"
-Requires-Dist: google-auth-httplib2; extra == "test"
-Requires-Dist: semver; extra == "test"
-Requires-Dist: tabulate; extra == "test"
+Requires-Dist: sre_yield; extra == "test"
+Requires-Dist: pydantic; extra == "test"
 Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
-Requires-Dist: fastapi; extra == "test"
-Requires-Dist: Unidecode; extra == "test"
-Requires-Dist: distributed; extra == "test"
-Requires-Dist: peft; extra == "test"
-Requires-Dist: flet[all]; extra == "test"
+Requires-Dist: dask[bag]; extra == "test"
+Requires-Dist: google-auth-httplib2; extra == "test"
 Provides-Extra: yaml
 Requires-Dist: pyyaml; extra == "yaml"
 Provides-Extra: logging

{fmtr_tools-1.1.6.dist-info → fmtr_tools-1.1.8.dist-info}/RECORD

@@ -4,11 +4,11 @@ fmtr/tools/async_tools.py,sha256=ewz757WcveQJd-G5SVr2JDOQVbdLGecCgl-tsBGVZz4,284
 fmtr/tools/augmentation_tools.py,sha256=-6ESbO4CDlKqVOV1J1V6qBeoBMzbFIinkDHRHnCBej0,55
 fmtr/tools/caching_tools.py,sha256=UOCYUNvLQ-NofR_dhqBmZF96-HRPf4At5MmxVk3gAIk,2943
 fmtr/tools/console_script_tools.py,sha256=7KVO0WI3Z7d7EZcmvTVS-O4OMxYYMZuA_7s0eubv76E,328
-fmtr/tools/constants.py,sha256=vc7sa1WdEsaxqSxrRAKTmNv8EmtOoY3b_V9CtAx4zzw,1125
+fmtr/tools/constants.py,sha256=6RvZLlj0jrej0X7yz-03uu-ELSYWFGknjmb-iOcozm0,1208
 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=t3DGzdjiEVIYV2H_R620eAhyxgsEFsqwmZygmBEUt58,2067
+fmtr/tools/debugging_tools.py,sha256=_xzqS0V5BpL8d06j-jVQjGgI7T020QsqVXKAKMz7Du8,2082
 fmtr/tools/docker_tools.py,sha256=rdaZje2xhlmnfQqZnR7IHgRdWncTLjrJcViUTt5oEwk,617
 fmtr/tools/environment_tools.py,sha256=ZO2e8pTzbQ8jNXnmKpaZF7_3qkVM6U5iqku5YSwOszE,1849
 fmtr/tools/function_tools.py,sha256=_oW3-HZXMst2pcU-I-U7KTMmzo0g9MIQKmX-c2_NEoE,858
@@ -29,7 +29,7 @@ fmtr/tools/name_tools.py,sha256=5CB_phqhHjl66iI8oLxOGPF2odC1apdul-M8Fv2xBhs,5514
 fmtr/tools/netrc_tools.py,sha256=PpNpz_mWlQi6VHGromKwFfTyLpHUXsd4LY6-OKLCbeI,376
 fmtr/tools/openai_tools.py,sha256=6SUgejgzUzmlKKct2_ePXntvMegu3FJgfk9x7aqtqYc,742
 fmtr/tools/parallel_tools.py,sha256=QEb_gN1StkxsqYaH4HSjiJX8Y3gpb2uKNsOzG4uFpaM,3071
-fmtr/tools/path_tools.py,sha256=UNi_qRBugDHxBNdEm26wHy3UUBOfY6fVK_G1P51RfCI,6175
+fmtr/tools/path_tools.py,sha256=f4FOFhWdC5U1yeMtHPQatvXhs6cCTCC4RuPoLZo0kRE,7094
 fmtr/tools/pdf_tools.py,sha256=xvv9B84uAF81rFJRnXhSsxYuP42vY9ZdPVFrSMVe8G8,4069
 fmtr/tools/platform_tools.py,sha256=7p69CmAHe_sF68Fx9uVhns1k5EewTHTWgUYzkl6ZQKA,308
 fmtr/tools/process_tools.py,sha256=Ysh5Dk2QFBhXQerArjKdt7xZd3JrN5Ho02AaOjH0Nnw,1425
@@ -43,7 +43,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=BNiWbHqtYm5lfiKfQRzKXTL2nBrnbwbpNUKsa17xLUc,5
+fmtr/tools/version,sha256=mTnviWxfu32TdnriwXIi9L7V08GJiIKe9xvXj3QQt_k,5
 fmtr/tools/version_tools.py,sha256=yNs_CGqWpqE4jbK9wsPIi14peJVXYbhIcMqHAFOw3yE,1480
 fmtr/tools/yaml_tools.py,sha256=Ol43ZwbnSXGnn1K98Uxx61KPGSqfC4axE-X2q1LKMwk,349
 fmtr/tools/ai_tools/__init__.py,sha256=JZrLuOFNV1A3wvJgonxOgz_4WS-7MfCuowGWA5uYCjs,372
@@ -57,9 +57,9 @@ fmtr/tools/tests/test_environment.py,sha256=iHaiMQfECYZPkPKwfuIZV9uHuWe3aE-p_dN_
 fmtr/tools/tests/test_json.py,sha256=IeSP4ziPvRcmS8kq7k9tHonC9rN5YYq9GSNT2ul6Msk,287
 fmtr/tools/tests/test_path.py,sha256=AkZQa6_8BQ-VaCyL_J-iKmdf2ZaM-xFYR37Kun3k4_g,2188
 fmtr/tools/tests/test_yaml.py,sha256=jc0TwwKu9eC0LvFGNMERdgBue591xwLxYXFbtsRwXVM,287
-fmtr_tools-1.1.6.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
-fmtr_tools-1.1.6.dist-info/METADATA,sha256=_tKE6fvUcfRKm2VIE4_JLrd5c8Tekz4LXzZJLWhsHOk,14646
-fmtr_tools-1.1.6.dist-info/WHEEL,sha256=DnLRTWE75wApRYVsjgc6wsVswC54sMSJhAEd4xhDpBk,91
-fmtr_tools-1.1.6.dist-info/entry_points.txt,sha256=e-eOW1Ml13tbxHC6Er1MnVOEDePeWw7DKwlE-l-gCY0,205
-fmtr_tools-1.1.6.dist-info/top_level.txt,sha256=t5341a8ii3n4RFizwTeXGmcq_pf4GqL1h9ylE5LIWRk,12
-fmtr_tools-1.1.6.dist-info/RECORD,,
+fmtr_tools-1.1.8.dist-info/licenses/LICENSE,sha256=FW9aa6vVN5IjRQWLT43hs4_koYSmpcbIovlKeAJ0_cI,10757
+fmtr_tools-1.1.8.dist-info/METADATA,sha256=lRqf1T5nQM155_hTay8XZjAK5A7YukM321G73D4BSWw,14646
+fmtr_tools-1.1.8.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+fmtr_tools-1.1.8.dist-info/entry_points.txt,sha256=e-eOW1Ml13tbxHC6Er1MnVOEDePeWw7DKwlE-l-gCY0,205
+fmtr_tools-1.1.8.dist-info/top_level.txt,sha256=t5341a8ii3n4RFizwTeXGmcq_pf4GqL1h9ylE5LIWRk,12
+fmtr_tools-1.1.8.dist-info/RECORD,,

{fmtr_tools-1.1.6.dist-info → fmtr_tools-1.1.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.4.0)
+Generator: setuptools (80.7.1)
 Root-Is-Purelib: true
 Tag: py3-none-any