evolver-tools 2.5.0__tar.gz → 3.1.0__tar.gz

{evolver_tools-2.5.0/src/evolver_tools.egg-info → evolver_tools-3.1.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: evolver-tools
-Version: 2.5.0
-Summary: 99 essential CLI tools - one pip install
+Version: 3.1.0
+Summary: 105 essential CLI tools - one pip install
 Author: EVOLVER
 License-Expression: MIT
 Project-URL: Homepage, https://evolver-dev.github.io/evolver-tools

evolver_tools-3.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=64.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "evolver-tools"
+version = "3.1.0"
+description = "105 essential CLI tools - one pip install"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+keywords = ["cli", "devops", "productivity", "developer-tools", "terminal"]
+authors = [
+    {name = "EVOLVER"},
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://evolver-dev.github.io/evolver-tools"
+Repository = "https://github.com/evolver-dev/evolver-tools"
+
+[project.scripts]
+evtool = "evolver_tools.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["evolver_tools*"]

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/__init__.py

@@ -1,2 +1,4 @@
 """evolver-tools: 23 CLI tools in one package."""
 __version__ = "1.0.0"
+
+from .autoreg import auto_discover

evolver_tools-3.1.0/src/evolver_tools/autoreg.py

@@ -0,0 +1,88 @@
+#!/usr/bin/env python3
+"""Auto-discovery module for EVOLVER tools.
+
+Scans all vendor modules for TOOL_META exports and returns them
+as a unified registry. Enables parallel agent workflows: each vendor
+tool defines its own TOOL_META, eliminating merge conflicts on cli.py.
+
+Usage:
+    from evolver_tools.autoreg import auto_discover
+    tools = auto_discover()  # Returns dict[str, dict]
+"""
+
+import importlib
+import os
+import pkgutil
+
+# Cache after first discovery
+_TOOLS_CACHE = None
+
+
+def _vendor_dir():
+    """Return the absolute path to the vendor directory."""
+    # vendor is a namespace package (no __init__.py), so __file__ is None
+    # Walk up from autoreg.py location
+    here = os.path.dirname(os.path.abspath(__file__))
+    return os.path.join(here, "vendor")
+
+
+def auto_discover():
+    """Scan all vendor modules and return a unified TOOLS dict.
+
+    Each vendor module (file or package) that exports TOOL_META dict
+    is discovered automatically. No manual registration needed.
+
+    Returns:
+        dict[str, dict]: Tool name -> {module, func, desc}
+    """
+    global _TOOLS_CACHE
+    if _TOOLS_CACHE is not None:
+        return _TOOLS_CACHE
+
+    tools = {}
+    vendor_dir = _vendor_dir()
+
+    for importer, modname, ispkg in pkgutil.iter_modules([vendor_dir]):
+        try:
+            mod = importlib.import_module(f"evolver_tools.vendor.{modname}")
+        except Exception:
+            continue
+
+        meta = getattr(mod, "TOOL_META", None)
+        if meta is None:
+            continue
+
+        tool_name = meta.get("name")
+        if not tool_name:
+            continue
+
+        func_name = meta.get("func", "main")
+        desc = meta.get("desc", "")
+
+        # If the package has a submodule (e.g. cal_tool/cli.py), use that
+        submodule = meta.get("submodule", "")
+        if submodule:
+            module_path = f"evolver_tools.vendor.{modname}.{submodule}"
+        else:
+            module_path = f"evolver_tools.vendor.{modname}"
+
+        tools[tool_name] = {
+            "module": module_path,
+            "func": func_name,
+            "desc": desc,
+        }
+
+    _TOOLS_CACHE = tools
+    return tools
+
+
+def list_tools():
+    """Print all discovered tools to stdout."""
+    tools = auto_discover()
+    print(f"Discovered {len(tools)} tools:")
+    for name in sorted(tools.keys()):
+        print(f"  - {name}")
+
+
+if __name__ == "__main__":
+    list_tools()

evolver_tools-3.1.0/src/evolver_tools/cli.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""evolver CLI - Unified interface for all EVOLVER tools.
+
+Tools are auto-discovered via TOOL_META in each vendor module.
+No manual registration needed — just add TOOL_META to your vendor file.
+"""
+
+import sys
+import importlib
+
+from evolver_tools.autoreg import auto_discover
+
+
+def list_tools():
+    """Display all available tools."""
+    tools = auto_discover()
+    print(f'\x1b[1;36m===== EVOLVER Tools v3.1.0 =====\x1b[0m')
+    print()
+    for name, info in sorted(tools.items()):
+        print(f'  \033[1;33m{name:<18}\033[0m {info["desc"]}')
+    print()
+    print(f'  Total: {len(tools)} tools')
+    print()
+    print('Usage: evolver <toolname> [args...]')
+    print('       evolver list')
+
+
+def run_tool(tool_name, args):
+    tools = auto_discover()
+    if tool_name not in tools:
+        print(f'Unknown tool: {tool_name}')
+        sys.exit(1)
+    info = tools[tool_name]
+    mod_path = info["module"]
+    func_name = info["func"]
+    old_argv = sys.argv
+    sys.argv = [tool_name] + args
+    try:
+        mod = importlib.import_module(mod_path)
+        func = getattr(mod, func_name)
+        result = func()
+        if result is not None:
+            print(result)
+    except KeyboardInterrupt:
+        pass
+    except Exception as e:
+        print(f'Error running {tool_name}: {e}', file=sys.stderr)
+        sys.exit(1)
+    finally:
+        sys.argv = old_argv
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] in ("-h", "--help"):
+        list_tools()
+        return
+    tool_name = sys.argv[1]
+    args = sys.argv[2:]
+    if tool_name == "list":
+        list_tools()
+        return
+    run_tool(tool_name, args)
+
+
+if __name__ == "__main__":
+    main()

evolver_tools-3.1.0/src/evolver_tools/vendor/agent_b_tool.py

@@ -0,0 +1,9 @@
+def main():
+    print('agent b')
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "agent-b-tool",
+    "func": "main",
+    "desc": 'Agent B tool',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/api_tester.py

@@ -225,5 +225,13 @@ Examples:
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "api-tester",
+    "func": "main",
+    "desc": 'HTTP API testing tool',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/ascii_gen.py

@@ -138,5 +138,13 @@ def main():
              STYLES[style](text)
     print(result)
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "ascii-gen",
+    "func": "main",
+    "desc": 'ASCII art generator (8 styles)',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/audit_log.py

@@ -257,5 +257,13 @@ Examples:
             print(colorize_entry(entry))
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "audit-log",
+    "func": "main",
+    "desc": 'Parse and filter system audit logs',
+}
+
 if __name__ == '__main__':
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/b64/__init__.py

@@ -0,0 +1,9 @@
+# b64 package — re-export from single file
+from .b64 import *
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "b64",
+    "func": "main",
+    "desc": 'b64',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/backup.py

@@ -75,5 +75,13 @@ def main():
         except Exception as e:
             print(f"  Error backing up {src}: {e}", file=sys.stderr)
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "backup",
+    "func": "main",
+    "desc": 'File/dir backup with rotation',
+}
+
 if __name__ == '__main__':
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/banner/__init__.py

@@ -0,0 +1,9 @@
+# banner package
+from .banner import *
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "banner-gen",
+    "func": "main",
+    "desc": 'ASCII banner generator (4 styles, colors)',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/banner.py

@@ -71,5 +71,7 @@ def main():
     for l in lines:
         print(l)
 
+
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/bookmark.py

@@ -272,5 +272,13 @@ def main():
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "bookmark",
+    "func": "main",
+    "desc": 'CLI bookmark manager',
+}
+
 if __name__ == '__main__':
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/cal_tool/__init__.py

@@ -0,0 +1,9 @@
+__version__ = "1.0.0"
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "cal",
+    "func": "main",
+    "desc": 'Cal',
+    "submodule": "cli",
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/cal_tool/cli.py

@@ -230,5 +230,13 @@ def main():
                 print_calendar(today.year, today.month, highlight_today=not args.no_highlight)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "cal",
+    "func": "main",
+    "desc": 'Cal',
+}
+
 if __name__ == "__main__":
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/cert_check.py

@@ -253,5 +253,13 @@ def main():
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "cert-check",
+    "func": "main",
+    "desc": 'Check SSL certificate expiry',
+}
+
 if __name__ == "__main__":
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/changelog_gen/__init__.py

@@ -0,0 +1,9 @@
+# changelog_gen package
+from .changelog_gen import *
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "changelog-gen",
+    "func": "main",
+    "desc": 'Generate changelog from git log',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/changelog_gen.py

@@ -73,5 +73,7 @@ def main():
             print(l)
         print()
 
+
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/chart_cli/__init__.py

@@ -440,5 +440,13 @@ def main():
         print(draw_histogram_chart(data, 10, args.width))
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "chart-cli",
+    "func": "main",
+    "desc": 'Chart CLI',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/checksum_dir.py

@@ -297,5 +297,13 @@ def main():
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "checksum-dir",
+    "func": "main",
+    "desc": 'Generate/verify directory checksums',
+}
+
 if __name__ == "__main__":
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/clipboard/__init__.py

@@ -0,0 +1,9 @@
+# clipboard package — re-export
+from .clipboard import *
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "clipboard",
+    "func": "main",
+    "desc": 'Terminal clipboard copy/paste/clear',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/colorize.py

@@ -188,5 +188,13 @@ def main():
         print(result)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "colorize",
+    "func": "main",
+    "desc": 'Terminal text colorizer',
+}
+
 if __name__ == "__main__":
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/colors/__init__.py

@@ -3,3 +3,10 @@ from evolver_tools.vendor.colors.__main__ import (
 )
 
 __all__ = ['hex_to_rgb', 'rgb_to_hex', 'hsl_to_rgb', 'show_256', 'show_basic', 'main']
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "colors",
+    "func": "main",
+    "desc": 'Colors',
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/config_validator.py

@@ -308,5 +308,13 @@ Examples:
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "config-validator",
+    "func": "main",
+    "desc": 'Validate config files (JSON, YAML, TOML)',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/cron/__init__.py

@@ -409,5 +409,13 @@ def main():
         print()
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "cron",
+    "func": "main",
+    "desc": 'Cron expression parser',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/crontab_helper.py

@@ -421,5 +421,13 @@ def main():
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "crontab-helper",
+    "func": "main",
+    "desc": 'Simplify crontab management',
+}
+
 if __name__ == "__main__":
     main()

evolver_tools-3.1.0/src/evolver_tools/vendor/crypto_price.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""
+Cryptocurrency price ticker using CoinGecko free API.
+
+Fetches real-time cryptocurrency prices in a specified fiat currency.
+Uses only Python stdlib (urllib, json, sys) — zero external dependencies.
+
+Usage:
+    python -m evolver_tools.vendor.crypto_price --coin bitcoin
+    python -m evolver_tools.vendor.crypto_price --coin ethereum --currency eur
+    python -m evolver_tools.vendor.crypto_price --list
+"""
+
+import argparse
+import json
+import sys
+import urllib.request
+import urllib.error
+
+TOOL_META = {
+    'name': 'crypto-price',
+    'func': 'main',
+    'desc': 'Cryptocurrency price ticker (CoinGecko)',
+}
+
+COINGECKO_SIMPLE_URL = 'https://api.coingecko.com/api/v3/simple/price'
+COINGECKO_LIST_URL = 'https://api.coingecko.com/api/v3/coins/list'
+
+
+def _api_get(url: str) -> dict:
+    """Make a GET request to the CoinGecko API and return parsed JSON."""
+    req = urllib.request.Request(url, headers={'User-Agent': 'crypto-price/1.0'})
+    try:
+        with urllib.request.urlopen(req, timeout=15) as resp:
+            return json.loads(resp.read().decode('utf-8'))
+    except urllib.error.HTTPError as e:
+        msg = e.read().decode('utf-8', errors='replace') if e.fp else ''
+        print(f'HTTP error {e.code}: {msg}', file=sys.stderr)
+        sys.exit(1)
+    except urllib.error.URLError as e:
+        print(f'Network error: {e.reason}', file=sys.stderr)
+        sys.exit(1)
+    except (json.JSONDecodeError, OSError, ValueError) as e:
+        print(f'Error parsing response: {e}', file=sys.stderr)
+        sys.exit(1)
+
+
+def list_coins() -> None:
+    """Fetch and display all available coins from CoinGecko."""
+    data = _api_get(COINGECKO_LIST_URL)
+    print(f'Total coins listed: {len(data)}\n')
+    # Show first 50 as a sample; user can filter with grep
+    for coin in data[:50]:
+        print(f'{coin["id"]:40s}  {coin["symbol"]:10s}  {coin["name"]}')
+    if len(data) > 50:
+        print(f'\n... and {len(data) - 50} more. Pipe through grep or use --coin <id>.')
+
+
+def get_price(coin: str, currency: str) -> None:
+    """Fetch and display the price for a single coin."""
+    url = f'{COINGECKO_SIMPLE_URL}?ids={coin}&vs_currencies={currency}'
+    data = _api_get(url)
+    if coin not in data:
+        print(
+            f'Coin "{coin}" not found. Use --list to see available coins.',
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if currency not in data[coin]:
+        print(
+            f'Currency "{currency}" not available for {coin}.',
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    price = data[coin][currency]
+    print(f'{coin}: {price:.8f} {currency.upper()}')
+
+
+def main() -> None:
+    """Parse arguments and run the appropriate action."""
+    parser = argparse.ArgumentParser(
+        description='Cryptocurrency price ticker (CoinGecko)',
+    )
+    parser.add_argument(
+        '--coin',
+        default='bitcoin',
+        help='Coin ID to look up (default: bitcoin)',
+    )
+    parser.add_argument(
+        '--currency',
+        default='usd',
+        help='Fiat currency symbol (default: usd)',
+    )
+    parser.add_argument(
+        '--list',
+        action='store_true',
+        help='List all available coins and exit',
+    )
+    args = parser.parse_args()
+
+    if args.list:
+        list_coins()
+    else:
+        get_price(args.coin, args.currency)
+
+
+if __name__ == '__main__':
+    main()

evolver_tools-3.1.0/src/evolver_tools/vendor/csv_stats/__init__.py

@@ -0,0 +1,13 @@
+"""csv-stats — Zero-dependency CSV data analysis tool."""
+
+__version__ = "1.0.0"
+__author__ = "Evolver"
+__license__ = "MIT"
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "csv-stats",
+    "func": "main",
+    "desc": 'csv-stats',
+    "submodule": "cli",
+}

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/csv_stats/cli.py

@@ -41,5 +41,13 @@ def main():
         print_report(result)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "csv-stats",
+    "func": "main",
+    "desc": 'csv-stats',
+}
+
 if __name__ == "__main__":
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/db_schema.py

@@ -205,5 +205,13 @@ Examples:
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "db-schema",
+    "func": "main",
+    "desc": 'Display database schema as ASCII',
+}
+
 if __name__ == '__main__':
     main()

{evolver_tools-2.5.0 → evolver_tools-3.1.0}/src/evolver_tools/vendor/dep_graph.py

@@ -246,5 +246,13 @@ Examples:
         sys.exit(1)
 
 
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "dep-graph",
+    "func": "main",
+    "desc": 'Dependency graph from Python files',
+}
+
 if __name__ == '__main__':
     main()