Open-AutoTools 0.0.5__tar.gz → 0.0.7__tar.gz

{open_autotools-0.0.5 → open_autotools-0.0.7/Open_AutoTools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Open-AutoTools
-Version: 0.0.5
+Version: 0.0.7
 Summary: A suite of automated tools accessible via CLI with a simple `autotools` command
 Home-page: https://github.com/BabylooPro/Open-AutoTools
 Author: BabylooPro
@@ -26,6 +26,7 @@ Requires-Dist: speedtest-cli>=2.1.3
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: cryptography>=42.0.2
 Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pillow-heif>=0.16.0
 Requires-Dist: pydub>=0.25.1
 Requires-Dist: moviepy>=1.0.3
 Requires-Dist: pint>=0.23
@@ -63,14 +64,24 @@ Dynamic: summary
 
 [PYPI_BADGE]: https://badge.fury.io/py/Open-AutoTools.svg
 [PYPI_URL]: https://pypi.org/project/Open-AutoTools/
+
+[PYPI_DOWNLOADS_BADGE]: https://img.shields.io/pypi/dm/Open-AutoTools
+[PYPI_DOWNLOADS_URL]: https://pypi.org/project/Open-AutoTools/
+
 [PYTHON_BADGE]: https://img.shields.io/badge/Python-3.10+-blue.svg
 [PYTHON_URL]: https://www.python.org/downloads/
+
 [CHANGELOG_BADGE]: https://img.shields.io/badge/CHANGELOG-red.svg
 [CHANGELOG_URL]: CHANGELOG.md
+
 [TODO_BADGE]: https://img.shields.io/badge/TODO-purple.svg
 [TODO_URL]: TODO.md
 
-[![PyPI][PYPI_BADGE]][PYPI_URL] [![Python][PYTHON_BADGE]][PYTHON_URL] [![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL] [![TODO][TODO_BADGE]][TODO_URL]
+[![PyPI][PYPI_BADGE]][PYPI_URL]
+[![Python][PYTHON_BADGE]][PYTHON_URL]
+[![Downloads][PYPI_DOWNLOADS_BADGE]][PYPI_DOWNLOADS_URL]
+[![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL]
+[![TODO][TODO_BADGE]][TODO_URL]
 
 Python CLI toolkit for everyday developer tasks. Boost productivity directly from your terminal.
 

{open_autotools-0.0.5 → open_autotools-0.0.7}/Open_AutoTools.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ Open_AutoTools.egg-info/requires.txt
 Open_AutoTools.egg-info/top_level.txt
 autotools/__init__.py
 autotools/cli.py
+autotools/tool_registry.py
 autotools/autocaps/__init__.py
 autotools/autocaps/commands.py
 autotools/autocaps/core.py
@@ -60,6 +61,7 @@ autotools/utils/updates.py
 autotools/utils/version.py
 tests/__init__.py
 tests/test_cli.py
+tests/test_docker_benchmark_runner.py
 tests/autotools/autocaps/__init__.py
 tests/autotools/autocaps/test_autocaps_core.py
 tests/autotools/autocaps/test_autocaps_integration.py
@@ -107,9 +109,11 @@ tests/autotools/autozip/test_autozip_core.py
 tests/autotools/autozip/test_autozip_integration.py
 tests/autotools/utils/__init__.py
 tests/autotools/utils/test_commands_discovery.py
+tests/autotools/utils/test_loading.py
 tests/autotools/utils/test_performance.py
 tests/autotools/utils/test_requirements.py
 tests/autotools/utils/test_smoke.py
 tests/autotools/utils/test_text.py
 tests/autotools/utils/test_updates.py
+tests/autotools/utils/test_utils_init.py
 tests/autotools/utils/test_version.py

{open_autotools-0.0.5 → open_autotools-0.0.7}/Open_AutoTools.egg-info/requires.txt

@@ -8,6 +8,7 @@ speedtest-cli>=2.1.3
 psutil>=5.9.0
 cryptography>=42.0.2
 Pillow>=10.0.0
+pillow-heif>=0.16.0
 pydub>=0.25.1
 moviepy>=1.0.3
 pint>=0.23

{open_autotools-0.0.5/Open_AutoTools.egg-info → open_autotools-0.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Open-AutoTools
-Version: 0.0.5
+Version: 0.0.7
 Summary: A suite of automated tools accessible via CLI with a simple `autotools` command
 Home-page: https://github.com/BabylooPro/Open-AutoTools
 Author: BabylooPro
@@ -26,6 +26,7 @@ Requires-Dist: speedtest-cli>=2.1.3
 Requires-Dist: psutil>=5.9.0
 Requires-Dist: cryptography>=42.0.2
 Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pillow-heif>=0.16.0
 Requires-Dist: pydub>=0.25.1
 Requires-Dist: moviepy>=1.0.3
 Requires-Dist: pint>=0.23
@@ -63,14 +64,24 @@ Dynamic: summary
 
 [PYPI_BADGE]: https://badge.fury.io/py/Open-AutoTools.svg
 [PYPI_URL]: https://pypi.org/project/Open-AutoTools/
+
+[PYPI_DOWNLOADS_BADGE]: https://img.shields.io/pypi/dm/Open-AutoTools
+[PYPI_DOWNLOADS_URL]: https://pypi.org/project/Open-AutoTools/
+
 [PYTHON_BADGE]: https://img.shields.io/badge/Python-3.10+-blue.svg
 [PYTHON_URL]: https://www.python.org/downloads/
+
 [CHANGELOG_BADGE]: https://img.shields.io/badge/CHANGELOG-red.svg
 [CHANGELOG_URL]: CHANGELOG.md
+
 [TODO_BADGE]: https://img.shields.io/badge/TODO-purple.svg
 [TODO_URL]: TODO.md
 
-[![PyPI][PYPI_BADGE]][PYPI_URL] [![Python][PYTHON_BADGE]][PYTHON_URL] [![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL] [![TODO][TODO_BADGE]][TODO_URL]
+[![PyPI][PYPI_BADGE]][PYPI_URL]
+[![Python][PYTHON_BADGE]][PYTHON_URL]
+[![Downloads][PYPI_DOWNLOADS_BADGE]][PYPI_DOWNLOADS_URL]
+[![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL]
+[![TODO][TODO_BADGE]][TODO_URL]
 
 Python CLI toolkit for everyday developer tasks. Boost productivity directly from your terminal.
 

{open_autotools-0.0.5 → open_autotools-0.0.7}/README.md

@@ -2,14 +2,24 @@
 
 [PYPI_BADGE]: https://badge.fury.io/py/Open-AutoTools.svg
 [PYPI_URL]: https://pypi.org/project/Open-AutoTools/
+
+[PYPI_DOWNLOADS_BADGE]: https://img.shields.io/pypi/dm/Open-AutoTools
+[PYPI_DOWNLOADS_URL]: https://pypi.org/project/Open-AutoTools/
+
 [PYTHON_BADGE]: https://img.shields.io/badge/Python-3.10+-blue.svg
 [PYTHON_URL]: https://www.python.org/downloads/
+
 [CHANGELOG_BADGE]: https://img.shields.io/badge/CHANGELOG-red.svg
 [CHANGELOG_URL]: CHANGELOG.md
+
 [TODO_BADGE]: https://img.shields.io/badge/TODO-purple.svg
 [TODO_URL]: TODO.md
 
-[![PyPI][PYPI_BADGE]][PYPI_URL] [![Python][PYTHON_BADGE]][PYTHON_URL] [![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL] [![TODO][TODO_BADGE]][TODO_URL]
+[![PyPI][PYPI_BADGE]][PYPI_URL]
+[![Python][PYTHON_BADGE]][PYTHON_URL]
+[![Downloads][PYPI_DOWNLOADS_BADGE]][PYPI_DOWNLOADS_URL]
+[![CHANGELOG][CHANGELOG_BADGE]][CHANGELOG_URL]
+[![TODO][TODO_BADGE]][TODO_URL]
 
 Python CLI toolkit for everyday developer tasks. Boost productivity directly from your terminal.
 

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autocaps/core.py

@@ -4,5 +4,5 @@ import pyperclip
 def autocaps_transform(text):
     transformed_text = text.upper()
     try: pyperclip.copy(transformed_text)
-    except pyperclip.PyperclipException: pass 
+    except (pyperclip.PyperclipException, OSError): pass 
     return transformed_text

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autocolor/core.py

@@ -94,6 +94,6 @@ def autocolor_convert(color_input, output_format='hex'):
     result = _format_output(r, g, b, alpha, output_format)
 
     try: pyperclip.copy(result)
-    except pyperclip.PyperclipException: pass
+    except (pyperclip.PyperclipException, OSError): pass
     
     return result

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autoconvert/commands.py

@@ -10,7 +10,7 @@ TOOL_CATEGORY = 'Files'
 
 # SMOKE TEST CASES (USED BY 'autotools smoke')
 SMOKE_TESTS = [
-    {'name': 'md-json', 'args': ['README.md', '/tmp/autoconvert-smoke.json']},
+    {'name': 'md-json', 'args': ['README.md', '.autotools-smoke/autoconvert-smoke.json']},
 ]
 
 # CLI COMMAND TO CONVERT FILES BETWEEN DIFFERENT FORMATS

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autoconvert/conversion/convert_image.py

@@ -6,11 +6,21 @@ from typing import Optional
 def convert_image(input_path: str, output_path: str, output_format: Optional[str] = None) -> bool:
     try:
         from PIL import Image
+        input_ext = Path(input_path).suffix[1:].lower()
+        if input_ext in ('heic', 'heif'):
+            try:
+                from pillow_heif import register_heif_opener
+                register_heif_opener()
+            except ImportError:
+                pass
 
         if not os.path.exists(input_path):
             raise FileNotFoundError(f"INPUT FILE NOT FOUND: {input_path}")
         if output_format is None: output_format = Path(output_path).suffix[1:].upper()
 
+        format_aliases = {'JPG': 'JPEG', 'TIF': 'TIFF'}
+        output_format = format_aliases.get(output_format.upper(), output_format.upper())
+
         with Image.open(input_path) as img:
             if output_format in ['JPG', 'JPEG'] and img.mode in ('RGBA', 'LA', 'P'):
                 rgb_img = Image.new('RGB', img.size, (255, 255, 255))

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autoconvert/conversion/convert_video.py

@@ -1,17 +1,18 @@
 import os
+import importlib
 from pathlib import Path
 from typing import Optional
 
 # CONVERTS VIDEO BETWEEN FORMATS
 def convert_video(input_path: str, output_path: str, output_format: Optional[str] = None) -> bool:
     try:
-        from moviepy.editor import VideoFileClip
+        video_file_clip = importlib.import_module("moviepy.editor").VideoFileClip
         
         if not os.path.exists(input_path):
             raise FileNotFoundError(f"INPUT FILE NOT FOUND: {input_path}")
         if output_format is None: output_format = Path(output_path).suffix[1:].lower()
 
-        with VideoFileClip(input_path) as video: video.write_videofile(output_path, codec='libx264', audio_codec='aac')
+        with video_file_clip(input_path) as video: video.write_videofile(output_path, codec='libx264', audio_codec='aac')
 
         return True
 

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autoconvert/core.py

@@ -15,7 +15,7 @@ def detect_file_type(file_path: str) -> str:
     if ext in text_formats: return 'text'
 
     # IMAGE FORMATS
-    image_formats = ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'tiff', 'tif', 'ico', 'svg']
+    image_formats = ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'tiff', 'tif', 'ico', 'svg', 'heic', 'heif']
     if ext in image_formats: return 'image'
 
     # AUDIO FORMATS

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autoip/core.py

@@ -7,6 +7,9 @@ import speedtest
 import psutil
 from ..utils.text import is_ci_environment, mask_ipv4, mask_ipv6, mask_sensitive_info
 
+GOOGLE_DNS_IPV4 = str(ipaddress.IPv4Address(0x08080808))
+CLOUDFLARE_DNS_IPV4 = str(ipaddress.IPv4Address(0x01010101))
+
 # NORMALIZES psutil.net_if_addrs() OUTPUT TO A netifaces-LIKE STRUCTURE:
 def _psutil_addrs_to_family_map(addrs):
     family_map = {}
@@ -61,14 +64,14 @@ def get_public_ips():
         try:
             ips['ipv4'] = requests.get(service, timeout=2).text.strip()
             if ips['ipv4']: break
-        except (requests.RequestException, requests.Timeout, requests.ConnectionError):
+        except requests.RequestException:
             continue
     
     for service in ipv6_services:
         try:
             ips['ipv6'] = requests.get(service, timeout=2).text.strip()
             if ips['ipv6']: break
-        except (requests.RequestException, requests.Timeout, requests.ConnectionError):
+        except requests.RequestException:
             continue
 
     return ips
@@ -77,8 +80,8 @@ def get_public_ips():
 def test_connectivity():
     results = []
     test_hosts = {
-        'Google DNS': ('8.8.8.8', 53),
-        'CloudFlare DNS': ('1.1.1.1', 53),
+        'Google DNS': (GOOGLE_DNS_IPV4, 53),
+        'CloudFlare DNS': (CLOUDFLARE_DNS_IPV4, 53),
         'Google': ('google.com', 443),
         'Cloudflare': ('cloudflare.com', 443),
         'GitHub': ('github.com', 443),
@@ -150,7 +153,7 @@ def get_local_ip():
     # FALLBACK: UDP SOCKET TRICK
     try:
         s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-        s.connect(("8.8.8.8", 80))
+        s.connect((GOOGLE_DNS_IPV4, 80))
         ip = s.getsockname()[0]
         s.close()
         return ip

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autolower/core.py

@@ -4,5 +4,5 @@ import pyperclip
 def autolower_transform(text):
     transformed_text = text.lower()
     try: pyperclip.copy(transformed_text)
-    except pyperclip.PyperclipException: pass
+    except (pyperclip.PyperclipException, OSError): pass
     return transformed_text

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autounit/core.py

@@ -23,7 +23,7 @@ def autounit_convert(value, from_unit, to_unit):
         output = f"{result_str} {to_unit}"
         
         try: pyperclip.copy(output)
-        except pyperclip.PyperclipException: pass
+        except (pyperclip.PyperclipException, OSError): pass
         
         return output
     

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autozip/commands.py

@@ -9,7 +9,7 @@ TOOL_CATEGORY = 'Files'
 
 # SMOKE TEST CASES (USED BY 'autotools smoke')
 SMOKE_TESTS = [
-    {'name': 'zip-readme', 'args': ['README.md', '--output', '/tmp/autozip-smoke.zip']},
+    {'name': 'zip-readme', 'args': ['README.md', '--output', '.autotools-smoke/autozip-smoke.zip']},
 ]
 
 # CLI COMMAND TO COMPRESS FILES AND DIRECTORIES

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/autozip/core.py

@@ -69,9 +69,9 @@ def _compress_tar_xz(source_paths, output_path, compression_level=6):
 # DETERMINES OUTPUT FORMAT FROM FILE EXTENSION
 def _get_format_from_extension(output_path):
     path_str = str(output_path).lower()
-    if path_str.endswith('.tar.gz') or path_str.endswith('.tgz'): return 'tar.gz'
-    elif path_str.endswith('.tar.bz2') or path_str.endswith('.tbz2'): return 'tar.bz2'
-    elif path_str.endswith('.tar.xz') or path_str.endswith('.txz'): return 'tar.xz'
+    if path_str.endswith(('.tar.gz', '.tgz')): return 'tar.gz'
+    elif path_str.endswith(('.tar.bz2', '.tbz2')): return 'tar.bz2'
+    elif path_str.endswith(('.tar.xz', '.txz')): return 'tar.xz'
     elif path_str.endswith('.tar'): return 'tar'
     elif path_str.endswith('.zip'): return 'zip'
     else:

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/cli.py

@@ -1,26 +1,89 @@
 import click
-import requests
-import base64
-import argparse
 import json as json_module
-import sys
 import os
 
-from dotenv import load_dotenv
-from datetime import datetime
-from urllib.parse import urlparse
-from packaging.version import parse as parse_version
-from importlib.metadata import version as get_version, PackageNotFoundError
-
-from .utils.version import print_version
-from .utils.updates import check_for_updates
-from .utils.commands import get_wrapped_tool_commands
-from .utils.performance import init_metrics, finalize_metrics, get_metrics, should_enable_metrics
-
-load_dotenv()
+from .utils.commands import get_tool_names, get_wrapped_tool_command, get_wrapped_tool_commands
+from .tool_registry import LAZY_TOOL_NAMES
+
+def _public_tool_name(tool_name):
+    return 'test' if tool_name == 'autotest' else tool_name
+
+def _internal_tool_name(public_name):
+    return 'autotest' if public_name == 'test' else public_name
+
+def _load_dotenv_if_present():
+    if not os.path.exists('.env'): return
+    try:
+        from dotenv import load_dotenv
+        load_dotenv()
+    except ImportError:
+        pass
+
+def print_version(ctx, value):
+    if not value or ctx.resilient_parsing: return
+    _load_dotenv_if_present()
+    from .utils.version import print_version as _print_version
+    return _print_version(ctx, value)
+
+def check_for_updates():
+    from .utils.updates import check_for_updates as _check_for_updates
+    return _check_for_updates()
+
+def _ctx_has_perf_flag(ctx):
+    current = ctx
+    while current:
+        if current.params.get('perf', False): return True
+        current = getattr(current, 'parent', None)
+    return False
+
+def should_enable_metrics(ctx):
+    if not _ctx_has_perf_flag(ctx): return False
+    from .utils.performance import should_enable_metrics as _should_enable_metrics
+    return _should_enable_metrics(ctx)
+
+def init_metrics():
+    from .utils.performance import init_metrics as _init_metrics
+    return _init_metrics()
+
+def finalize_metrics(ctx):
+    from .utils.performance import finalize_metrics as _finalize_metrics
+    return _finalize_metrics(ctx)
+
+def get_metrics():
+    from .utils.performance import get_metrics as _get_metrics
+    return _get_metrics()
+
+# CLICK COMMAND PROXY USED BY console_scripts AND TESTS WITHOUT IMPORTING EVERY TOOL
+class LazyToolCommand(click.Command):
+    def __init__(self, tool_name):
+        self.tool_name = tool_name
+        super().__init__(name=_public_tool_name(tool_name))
+
+    def _load_command(self):
+        cmd = get_wrapped_tool_command(self.tool_name)
+        if cmd is None:
+            raise click.ClickException(f"Unknown tool: {self.tool_name}")
+        return cmd
+
+    def main(self, *args, **kwargs):
+        return self._load_command().main(*args, **kwargs)
+
+# LAZY GROUP: LISTS TOOLS WITHOUT IMPORTING THEM, IMPORTS ONLY THE SELECTED COMMAND
+class LazyAutoToolsGroup(click.Group):
+    def list_commands(self, ctx):
+        commands = set(super().list_commands(ctx))
+        commands.update(_public_tool_name(tool_name) for tool_name in get_tool_names())
+        return sorted(commands)
+
+    def get_command(self, ctx, cmd_name):
+        cmd = super().get_command(ctx, cmd_name)
+        if cmd is not None: return cmd
+
+        tool_name = _internal_tool_name(cmd_name)
+        return get_wrapped_tool_command(tool_name)
 
 # MAIN CLI ENTRY POINT - REGISTERS ALL COMMANDS AND HANDLES GLOBAL OPTIONS
-@click.group(invoke_without_command=True)
+@click.group(cls=LazyAutoToolsGroup, invoke_without_command=True)
 @click.option('--version', '--v', is_flag=True, callback=lambda ctx, param, value: print_version(ctx, value),
               expose_value=False, is_eager=True, help='Show version and check for updates')
 @click.option('--help', '-h', is_flag=True, callback=lambda ctx, param, value: 
@@ -50,6 +113,7 @@ def cli(ctx, perf):
     """
 
     # INITIALIZE METRICS IF NEEDED
+    _load_dotenv_if_present()
     if should_enable_metrics(ctx):
         init_metrics()
         get_metrics().step_start('startup')
@@ -63,17 +127,6 @@ def cli(ctx, perf):
             get_metrics().end_process()
             finalize_metrics(ctx)
 
-# DISCOVER AND REGISTER ALL TOOL COMMANDS
-_wrapped_tool_commands = get_wrapped_tool_commands()
-for _tool_name in sorted(_wrapped_tool_commands):
-    _cmd = _wrapped_tool_commands[_tool_name]
-
-    if _tool_name == 'autotest': cli.add_command(_cmd, name='test')
-    else: cli.add_command(_cmd)
-
-# EXPOSE TOOL COMMANDS FOR console_scripts ENTRYPOINTS (setup.py)
-for _tool_name, _cmd in _wrapped_tool_commands.items(): globals()[_tool_name] = _cmd
-
 # DISPLAYS COMMAND OPTIONS
 def _display_command_options(cmd_obj):
     if not hasattr(cmd_obj, 'params'): return
@@ -122,11 +175,7 @@ def autotools():
 @cli.command(name='list-tools')
 @click.option('--json', 'as_json', is_flag=True, help='OUTPUT JSON')
 def list_tools(as_json):
-    tools = []
-    for tool_name, cmd in get_wrapped_tool_commands().items():
-        public_name = 'test' if tool_name == 'autotest' else (cmd.name or tool_name)
-        tools.append(public_name)
-
+    tools = [_public_tool_name(tool_name) for tool_name in get_tool_names()]
     tools = sorted(set(tools))
     if as_json: click.echo(json_module.dumps(tools))
     else: click.echo("\n".join(tools))
@@ -157,4 +206,6 @@ def smoke(workdir, timeout, include_tools, exclude_tools, as_json, verbose):
     failed = [r for r in results if r.get('status') != 'OK']
     raise SystemExit(1 if failed else 0)
 
+globals().update({tool_name: LazyToolCommand(tool_name) for tool_name in LAZY_TOOL_NAMES})
+
 if __name__ == '__main__': cli()

open_autotools-0.0.7/autotools/tool_registry.py

@@ -0,0 +1,19 @@
+CONSOLE_TOOL_NAMES = (
+    'autocaps',
+    'autolower',
+    'autopassword',
+    'autoip',
+    'autoconvert',
+    'autocolor',
+    'autounit',
+    'autozip',
+    'autotodo',
+    'autonote',
+)
+
+LAZY_TOOL_NAMES = CONSOLE_TOOL_NAMES + ('autotest',)
+
+CONSOLE_SCRIPT_ENTRY_POINTS = (
+    'autotools=autotools.cli:cli',
+    *(f'{tool_name}=autotools.cli:{tool_name}' for tool_name in CONSOLE_TOOL_NAMES),
+)

open_autotools-0.0.7/autotools/utils/__init__.py

@@ -0,0 +1,14 @@
+__all__ = ['LoadingAnimation', 'check_for_updates', 'print_version']
+
+def __getattr__(name):
+    if name == 'LoadingAnimation':
+        from .loading import LoadingAnimation
+        return LoadingAnimation
+    if name == 'check_for_updates':
+        from .updates import check_for_updates
+        return check_for_updates
+    if name == 'print_version':
+        from .version import print_version
+        return print_version
+
+    raise AttributeError(f"module 'autotools.utils' has no attribute {name!r}")

{open_autotools-0.0.5 → open_autotools-0.0.7}/autotools/utils/commands.py

@@ -5,10 +5,11 @@ import pkgutil
 from types import ModuleType
 from typing import Dict, Iterable, List, Tuple
 
-from .performance import init_metrics, finalize_metrics, get_metrics, should_enable_metrics, track_step
-
 __all__ = [
     'discover_tool_command_entries',
+    'get_tool_names',
+    'get_tool_command_entry',
+    'get_wrapped_tool_command',
     'get_wrapped_tool_commands',
     'register_commands',
     'get_tool_category'
@@ -17,6 +18,34 @@ __all__ = [
 # PACKAGES THAT SHOULD NEVER BE TREATED AS TOOLS
 _EXCLUDED_TOOL_PACKAGES = {'utils', '__pycache__'}
 
+def _ctx_has_perf_flag(ctx) -> bool:
+    current = ctx
+    while current:
+        if current.params.get('perf', False): return True
+        current = getattr(current, 'parent', None)
+    return False
+
+def init_metrics():
+    from .performance import init_metrics as _init_metrics
+    return _init_metrics()
+
+def finalize_metrics(ctx):
+    from .performance import finalize_metrics as _finalize_metrics
+    return _finalize_metrics(ctx)
+
+def get_metrics():
+    from .performance import get_metrics as _get_metrics
+    return _get_metrics()
+
+def should_enable_metrics(ctx):
+    if not _ctx_has_perf_flag(ctx): return False
+    from .performance import should_enable_metrics as _should_enable_metrics
+    return _should_enable_metrics(ctx)
+
+def track_step(name: str):
+    from .performance import track_step as _track_step
+    return _track_step(name)
+
 # ITERATES ALL TOP-LEVEL TOOL PACKAGES (autotools/<tool>/)
 def _iter_tool_packages() -> Iterable[str]:
     import autotools as autotools_pkg
@@ -28,6 +57,10 @@ def _iter_tool_packages() -> Iterable[str]:
         if name == 'cli': continue
         yield name
 
+# RETURNS DISCOVERED TOP-LEVEL TOOL PACKAGE NAMES WITHOUT IMPORTING COMMAND MODULES
+def get_tool_names() -> List[str]:
+    return sorted(_iter_tool_packages())
+
 # IMPORTS autotools.<tool>.commands IF IT EXISTS
 def _import_tool_commands_module(tool_name: str) -> ModuleType | None:
     full_name = f'autotools.{tool_name}.commands'
@@ -64,17 +97,32 @@ def _select_command_for_tool(cmds: List[click.Command], tool_name: str, mod_name
 # DISCOVERS TOOL COMMANDS AS (MODULE, CLICK COMMAND) BY TOOL PACKAGE NAME
 def discover_tool_command_entries() -> Dict[str, Tuple[ModuleType, click.Command]]:
     entries: Dict[str, Tuple[ModuleType, click.Command]] = {}
-    for tool_name in _iter_tool_packages():
-        mod = _import_tool_commands_module(tool_name)
-        if mod is None: continue
-        cmds = _extract_click_commands(mod)
-        if not cmds: continue
-
-        selected = _select_command_for_tool(cmds, tool_name, mod.__name__)
-        entries[tool_name] = (mod, selected)
+    for tool_name in get_tool_names():
+        entry = get_tool_command_entry(tool_name)
+        if entry is not None: entries[tool_name] = entry
 
     return entries
 
+# RETURNS A SINGLE TOOL COMMAND ENTRY WITHOUT IMPORTING EVERY OTHER TOOL
+def get_tool_command_entry(tool_name: str) -> Tuple[ModuleType, click.Command] | None:
+    if tool_name not in set(get_tool_names()): return None
+
+    mod = _import_tool_commands_module(tool_name)
+    if mod is None: return None
+    cmds = _extract_click_commands(mod)
+    if not cmds: return None
+
+    selected = _select_command_for_tool(cmds, tool_name, mod.__name__)
+    return mod, selected
+
+# RETURNS ONE WRAPPED TOOL COMMAND BY PACKAGE NAME
+def get_wrapped_tool_command(tool_name: str) -> click.Command | None:
+    entry = get_tool_command_entry(tool_name)
+    if entry is None: return None
+
+    _mod, cmd = entry
+    return _wrap_command_with_metrics(cmd)
+
 # RETURNS WRAPPED TOOL COMMANDS (USED BY CLI GROUP AND CONSOLE_SCRIPTS EXPORTS)
 def get_wrapped_tool_commands() -> Dict[str, click.Command]:
     wrapped: Dict[str, click.Command] = {}
@@ -84,10 +132,10 @@ def get_wrapped_tool_commands() -> Dict[str, click.Command]:
 
 # EXECUTES COMMAND WITH PERFORMANCE TRACKING
 def _execute_with_metrics(ctx, original_callback, *args, **kwargs):
-    metrics = get_metrics()
     kwargs.pop('perf', None)
     
     if not should_enable_metrics(ctx): return original_callback(*args, **kwargs)
+    metrics = get_metrics()
     if metrics.process_start is None:
         init_metrics()
         get_metrics().end_startup()

open_autotools-0.0.7/autotools/utils/loading.py

@@ -0,0 +1,41 @@
+import os
+import sys
+import threading
+
+# PATCHES THREAD SET DAEMON METHOD TO PREVENT WARNINGS
+def _patched_set_daemon(self, daemon):
+    self.daemon = daemon
+
+_original_set_daemon = None
+
+def _should_show_spinner():
+    if os.getenv('CI') or os.getenv('PYTEST_CURRENT_TEST'): return False
+    if os.getenv('TERM', '').lower() == 'dumb': return False
+    return bool(getattr(sys.stderr, 'isatty', lambda: False)())
+
+def _create_spinner():
+    global _original_set_daemon
+    if _original_set_daemon is None:
+        _original_set_daemon = threading.Thread.daemon
+        threading.Thread.daemon = _patched_set_daemon
+
+    from halo import Halo
+    return Halo(spinner={'interval': 200, 'frames': ['   ', '.  ', '.. ', '...']})
+
+# CONTEXT MANAGER FOR DISPLAYING LOADING ANIMATION
+class LoadingAnimation:
+    # INITIALIZES SPINNER WITH CUSTOM ANIMATION FRAMES
+    def __init__(self):
+        self._spinner = None
+        self._enabled = _should_show_spinner()
+        
+    # STARTS THE LOADING ANIMATION
+    def __enter__(self):
+        if self._enabled:
+            self._spinner = _create_spinner()
+            self._spinner.start()
+        return self
+        
+    # STOPS THE LOADING ANIMATION
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if self._spinner is not None: self._spinner.stop()