fmtr.tools 1.1.4__tar.gz → 1.1.6__tar.gz

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.1.4
+Version: 1.1.6
 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: tokenizers; extra == "test"
+Requires-Dist: google-api-python-client; extra == "test"
+Requires-Dist: pymupdf4llm; extra == "test"
 Requires-Dist: faker; extra == "test"
-Requires-Dist: pydantic; extra == "test"
-Requires-Dist: logfire; extra == "test"
-Requires-Dist: tabulate; extra == "test"
-Requires-Dist: diskcache; extra == "test"
-Requires-Dist: sre_yield; extra == "test"
-Requires-Dist: distributed; extra == "test"
-Requires-Dist: bokeh; extra == "test"
-Requires-Dist: flet[all]; extra == "test"
-Requires-Dist: fastapi; extra == "test"
-Requires-Dist: uvicorn[standard]; extra == "test"
-Requires-Dist: google-auth; extra == "test"
-Requires-Dist: logfire[fastapi]; extra == "test"
-Requires-Dist: contexttimer; extra == "test"
 Requires-Dist: pyyaml; extra == "test"
-Requires-Dist: flet-webview; extra == "test"
+Requires-Dist: html2text; extra == "test"
+Requires-Dist: pymupdf; 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: torchaudio; extra == "test"
 Requires-Dist: sentence_transformers; extra == "test"
+Requires-Dist: pydantic; extra == "test"
+Requires-Dist: docker; extra == "test"
+Requires-Dist: tokenizers; extra == "test"
+Requires-Dist: uvicorn[standard]; extra == "test"
 Requires-Dist: pandas; extra == "test"
-Requires-Dist: dask[bag]; extra == "test"
+Requires-Dist: openpyxl; 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: openai; extra == "test"
-Requires-Dist: peft; extra == "test"
+Requires-Dist: google-auth; extra == "test"
 Requires-Dist: tinynetrc; extra == "test"
-Requires-Dist: semver; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: pymupdf4llm; extra == "test"
-Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
-Requires-Dist: google-api-python-client; extra == "test"
-Requires-Dist: html2text; extra == "test"
-Requires-Dist: huggingface_hub; extra == "test"
-Requires-Dist: torchaudio; extra == "test"
+Requires-Dist: google-auth-oauthlib; extra == "test"
 Requires-Dist: deepmerge; extra == "test"
-Requires-Dist: torchvision; 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: pydantic-settings; extra == "test"
-Requires-Dist: google-auth-oauthlib; extra == "test"
-Requires-Dist: openpyxl; extra == "test"
-Requires-Dist: pymupdf; extra == "test"
+Requires-Dist: semver; extra == "test"
+Requires-Dist: tabulate; extra == "test"
+Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
+Requires-Dist: fastapi; extra == "test"
 Requires-Dist: Unidecode; extra == "test"
-Requires-Dist: flet-video; extra == "test"
-Requires-Dist: ollama; extra == "test"
-Requires-Dist: docker; extra == "test"
-Requires-Dist: json_repair; extra == "test"
+Requires-Dist: distributed; extra == "test"
+Requires-Dist: peft; extra == "test"
+Requires-Dist: flet[all]; extra == "test"
 Provides-Extra: yaml
 Requires-Dist: pyyaml; extra == "yaml"
 Provides-Extra: logging

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr/tools/console_script_tools.py

@@ -11,3 +11,13 @@ def remote_debug_test():
     """
     from fmtr.tools import debug
     debug.trace(is_debug=True)
+
+
+def shell_debug():
+    """
+
+    Test debugger connection
+
+    """
+    from fmtr.tools import debug
+    debug.debug_shell()

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr/tools/constants.py

@@ -31,3 +31,4 @@ class Constants:
     FILENAME_CONFIG = 'settings.yaml'
     DIR_NAME_ARTIFACTS = 'artifacts'
     FILENAME_VERSION = 'version'
+    DIR_NAME_HF = 'hf'

fmtr_tools-1.1.6/fmtr/tools/debugging_tools.py

@@ -0,0 +1,90 @@
+import dataclasses
+
+import pydevd_pycharm
+
+from fmtr.tools import environment_tools as env
+from fmtr.tools.constants import Constants
+
+MASK = 'Starting debugger at tcp://{host}:{port}...'
+
+
+@dataclasses.dataclass
+class ShellDebug:
+    """
+
+    Debugging information for shell commands
+
+    """
+    command: str
+    out: str
+    err: str
+    status: int
+
+    # timestamp: datetime=dataclasses.field(default_factory=datetime.now)
+
+    @classmethod
+    def from_path(cls, path_str):
+        """
+
+        Get debug info from path
+
+        """
+        from fmtr.tools import Path
+        path = Path(path_str).absolute()
+        data = {field.name: (path / f'{field.name}.log').read_text().strip() for field in dataclasses.fields(cls)}
+        self = cls(**data)
+        return self
+
+    @property
+    def env(self):
+        return env.get_dict()
+
+
+
+def trace(is_debug=None, host=None, port=None, stdoutToServer=True, stderrToServer=True, **kwargs):
+    """
+
+    Connect to PyCharm debugger if enabled
+
+    """
+    if not is_debug:
+        is_debug = env.get_bool(Constants.FMTR_REMOTE_DEBUG_ENABLED_KEY, False)
+
+    if not is_debug:
+        return
+
+    if is_debug is True and not host:
+        host = Constants.FMTR_REMOTE_DEBUG_HOST_DEFAULT
+
+    host = host or env.get(Constants.FMTR_REMOTE_DEBUG_HOST_KEY, Constants.FMTR_REMOTE_DEBUG_HOST_DEFAULT)
+    port = port or Constants.FMTR_REMOTE_DEBUG_PORT_DEFAULT
+
+    from fmtr.tools import logger
+
+    msg = MASK.format(host=host, port=port)
+    logger.info(msg)
+
+    pydevd_pycharm.settrace(host, port=port, stdoutToServer=stdoutToServer, stderrToServer=stderrToServer, **kwargs)
+
+
+def debug_shell():
+    """
+
+    Starts a debug shell by initializing a `ShellDebug` object from a given path
+    and enabling tracing with debug mode turned on.
+
+    """
+    path_str = sys.argv[1]
+    data = ShellDebug.from_path(path_str)
+    trace(is_debug=True)
+    data
+
+
+if __name__ == "__main__":
+    import sys
+
+    sys.argv = [
+        'test.py',
+        './fmtr-debug/34e8d492-2f15-419a-8fcb-fe4fa0fa02bb',
+    ]
+    debug_shell()

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr/tools/path_tools.py

@@ -228,7 +228,14 @@ class PackagePaths:
         Path of artifacts directory.
 
         """
-        return self.repo / self.dir_name_artifacts
+
+        from fmtr.tools import env
+        if env.IS_DEBUG:
+            path = self.repo / self.dir_name_artifacts
+        else:
+            path = Path('/') / self.dir_name_artifacts
+
+        return path
 
     @property
     def settings(self) -> Path:
@@ -239,6 +246,15 @@ class PackagePaths:
         """
         return self.artifacts / self.filename_config
 
+    @property
+    def hf(self) -> Path:
+        """
+
+        Path of HuggingFace directory
+
+        """
+        return self.artifacts / Constants.DIR_NAME_HF
+
     def __repr__(self) -> str:
         """
 

fmtr_tools-1.1.6/fmtr/tools/version

@@ -0,0 +1 @@
+1.1.6

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr.tools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fmtr.tools
-Version: 1.1.4
+Version: 1.1.6
 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: tokenizers; extra == "test"
+Requires-Dist: google-api-python-client; extra == "test"
+Requires-Dist: pymupdf4llm; extra == "test"
 Requires-Dist: faker; extra == "test"
-Requires-Dist: pydantic; extra == "test"
-Requires-Dist: logfire; extra == "test"
-Requires-Dist: tabulate; extra == "test"
-Requires-Dist: diskcache; extra == "test"
-Requires-Dist: sre_yield; extra == "test"
-Requires-Dist: distributed; extra == "test"
-Requires-Dist: bokeh; extra == "test"
-Requires-Dist: flet[all]; extra == "test"
-Requires-Dist: fastapi; extra == "test"
-Requires-Dist: uvicorn[standard]; extra == "test"
-Requires-Dist: google-auth; extra == "test"
-Requires-Dist: logfire[fastapi]; extra == "test"
-Requires-Dist: contexttimer; extra == "test"
 Requires-Dist: pyyaml; extra == "test"
-Requires-Dist: flet-webview; extra == "test"
+Requires-Dist: html2text; extra == "test"
+Requires-Dist: pymupdf; 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: torchaudio; extra == "test"
 Requires-Dist: sentence_transformers; extra == "test"
+Requires-Dist: pydantic; extra == "test"
+Requires-Dist: docker; extra == "test"
+Requires-Dist: tokenizers; extra == "test"
+Requires-Dist: uvicorn[standard]; extra == "test"
 Requires-Dist: pandas; extra == "test"
-Requires-Dist: dask[bag]; extra == "test"
+Requires-Dist: openpyxl; 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: openai; extra == "test"
-Requires-Dist: peft; extra == "test"
+Requires-Dist: google-auth; extra == "test"
 Requires-Dist: tinynetrc; extra == "test"
-Requires-Dist: semver; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Requires-Dist: pymupdf4llm; extra == "test"
-Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
-Requires-Dist: google-api-python-client; extra == "test"
-Requires-Dist: html2text; extra == "test"
-Requires-Dist: huggingface_hub; extra == "test"
-Requires-Dist: torchaudio; extra == "test"
+Requires-Dist: google-auth-oauthlib; extra == "test"
 Requires-Dist: deepmerge; extra == "test"
-Requires-Dist: torchvision; 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: pydantic-settings; extra == "test"
-Requires-Dist: google-auth-oauthlib; extra == "test"
-Requires-Dist: openpyxl; extra == "test"
-Requires-Dist: pymupdf; extra == "test"
+Requires-Dist: semver; extra == "test"
+Requires-Dist: tabulate; extra == "test"
+Requires-Dist: pydantic-ai[logfire,openai]; extra == "test"
+Requires-Dist: fastapi; extra == "test"
 Requires-Dist: Unidecode; extra == "test"
-Requires-Dist: flet-video; extra == "test"
-Requires-Dist: ollama; extra == "test"
-Requires-Dist: docker; extra == "test"
-Requires-Dist: json_repair; extra == "test"
+Requires-Dist: distributed; extra == "test"
+Requires-Dist: peft; extra == "test"
+Requires-Dist: flet[all]; extra == "test"
 Provides-Extra: yaml
 Requires-Dist: pyyaml; extra == "yaml"
 Provides-Extra: logging

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr.tools.egg-info/entry_points.txt

@@ -1,3 +1,4 @@
 [console_scripts]
 cache-hfh = fmtr.tools.console_script_tools:cache_hfh
+fmtr-shell-debug = fmtr.tools.console_script_tools:shell_debug
 remote-debug-test = fmtr.tools.console_script_tools:remote_debug_test

fmtr_tools-1.1.4/fmtr/tools/debugging_tools.py

@@ -1,31 +0,0 @@
-import pydevd_pycharm
-
-from fmtr.tools import environment_tools as env
-from fmtr.tools.constants import Constants
-
-MASK = 'Starting debugger at tcp://{host}:{port}...'
-
-def trace(is_debug=None, host=None, port=None, stdoutToServer=True, stderrToServer=True, **kwargs):
-    """
-
-    Connect to PyCharm debugger if enabled
-
-    """
-    if not is_debug:
-        is_debug = env.get_bool(Constants.FMTR_REMOTE_DEBUG_ENABLED_KEY, False)
-
-    if not is_debug:
-        return
-
-    if is_debug is True and not host:
-        host = Constants.FMTR_REMOTE_DEBUG_HOST_DEFAULT
-
-    host = host or env.get(Constants.FMTR_REMOTE_DEBUG_HOST_KEY, Constants.FMTR_REMOTE_DEBUG_HOST_DEFAULT)
-    port = port or Constants.FMTR_REMOTE_DEBUG_PORT_DEFAULT
-
-    from fmtr.tools import logger
-
-    msg = MASK.format(host=host, port=port)
-    logger.info(msg)
-
-    pydevd_pycharm.settrace(host, port=port, stdoutToServer=stdoutToServer, stderrToServer=stderrToServer, **kwargs)

fmtr_tools-1.1.4/fmtr/tools/version

@@ -1 +0,0 @@
-1.1.4

{fmtr_tools-1.1.4 → fmtr_tools-1.1.6}/fmtr.tools.egg-info/requires.txt

@@ -113,51 +113,51 @@ tabulate
 openpyxl
 
 [test]
-tokenizers
+google-api-python-client
+pymupdf4llm
 faker
-pydantic
-logfire
-tabulate
-diskcache
-sre_yield
-distributed
-bokeh
-flet[all]
-fastapi
-uvicorn[standard]
-google-auth
-logfire[fastapi]
-contexttimer
 pyyaml
-flet-webview
+html2text
+pymupdf
+contexttimer
+dask[bag]
+json_repair
+torchvision
+pydantic-settings
+huggingface_hub
+logfire[fastapi]
 transformers[sentencepiece]
+sre_yield
+pytest-cov
+torchaudio
 sentence_transformers
+pydantic
+docker
+tokenizers
+uvicorn[standard]
 pandas
-dask[bag]
+openpyxl
+ollama
+flet-video
+flet-webview
 pydevd-pycharm
-openai
-peft
+google-auth
 tinynetrc
-semver
-pytest-cov
-pymupdf4llm
-pydantic-ai[logfire,openai]
-google-api-python-client
-html2text
-huggingface_hub
-torchaudio
+google-auth-oauthlib
 deepmerge
-torchvision
+openai
+diskcache
+bokeh
+logfire
 google-auth-httplib2
-pydantic-settings
-google-auth-oauthlib
-openpyxl
-pymupdf
+semver
+tabulate
+pydantic-ai[logfire,openai]
+fastapi
 Unidecode
-flet-video
-ollama
-docker
-json_repair
+distributed
+peft
+flet[all]
 
 [tokenization]
 tokenizers