evolver-tools 1.5.0__tar.gz → 3.0.0__tar.gz

evolver_tools-3.0.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: evolver-tools
+Version: 3.0.0
+Summary: 100 essential CLI tools - one pip install
+Author: EVOLVER
+License-Expression: MIT
+Project-URL: Homepage, https://evolver-dev.github.io/evolver-tools
+Project-URL: Repository, https://github.com/evolver-dev/evolver-tools
+Keywords: cli,devops,productivity,developer-tools,terminal
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# EVOLVER Tools
+
+**50 essential CLI tools — one `pip install`.**
+
+Zero-dependency (49/50), cross-platform, production-ready.
+Systems ops, data processing, dev tools, security, and creativity.
+~170KB total — one install, not 50.
+
+## Quick Start
+
+```bash
+pip install evolver-tools
+evtool list             # Show all 50 tools
+evtool ff < data.txt    # Fuzzy search through data
+evtool sysmon           # Launch system monitor
+evtool sort -n data.txt # Numeric sort
+```
+
+## Tools
+
+### Ops
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **sysmon** | Real-time system monitor (curses TUI — CPU/mem/disk/net/processes) | See your server breathe |
+| **dirsize** | Recursive directory space analyzer | Find what's eating your disk |
+| **envcheck** | Environment variable validator (missing keys, formats) | Stop .env typos from breaking prod |
+| **portcheck** | TCP port scanner & service detection | Port open? Service running? |
+| **siege-lite** | HTTP load tester (concurrency, latency percentile) | How many req/s can your app handle? |
+| **http-live** | SSE hot-reload HTTP server for development | Edit code, see changes. No refresh. |
+| **ipinfo** | Public IP & geolocation lookup | Where's this server? |
+| **hashsum** | File hash verification (MD5/SHA-1/256/512/BLAKE2, auto-detect) | Verify downloads in one command |
+| **find-dups** | Find duplicate files by SHA256 hash, size, or name | Reclaim gigabytes |
+
+### Developer
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **smellfinder** | Python code smell detector (AST-based, 10+ patterns) | Lint without pip install pylint |
+| **project-doctor** | Project health checker (meta, structure, quality) | Project checkup in one command |
+| **license-cli** | Open-source license generator/validator | License your repo instantly |
+| **markdown-check** | Markdown format validator & style checker | Docs that don't embarrass you |
+| **sqlite-cli** | SQLite query tool — CSV/JSON/table output | Query .db files without a GUI |
+| **b64** | Base64 encode/decode with auto-detection | Paste, pipe, done |
+| **jsonql** | Zero-dep JSON query tool (SQL-like syntax) | `jsonql "SELECT name FROM data WHERE age > 18"` |
+| **jq-lite** | jq-style JSON query — filter, extract, transform | jq without installing jq |
+| **urlparse** | URL parser & debugger | What's in that URL? |
+| **colors** | 256-color table & HEX↔RGB conversion | Design that terminal theme |
+| **fmt** | Code/text formatter — trailing whitespace, EOF newline, indent | Clean files, one command |
+
+### Data & Analysis
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **csv-stats** | CSV column analysis — histograms, frequencies, correlations | Understand your CSV in seconds |
+| **json2csv** | JSON to CSV converter with nested key flattening | API response → spreadsheet |
+| **chart-cli** | Terminal chart generator — bar, line, pie, histogram | Charts without leaving the terminal |
+| **cal** | Calendar & date calculator | What day is 45 days from now? |
+| **web-summary** | Web page content extractor (title, body, links) | Read the web from your terminal |
+| **yaml2json** | Convert YAML to JSON (zero dependencies, basic YAML subset) | Config files \u2192 pipeable JSON |
+| **sort** | Line sorting — alpha, numeric, reverse, unique, by column | Sort data without `sort(1)` |
+
+### Productivity
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **ff** | Interactive fuzzy finder (fzf, pure Python curses TUI) | Search files, history, anything |
+| **nb** | Command-line notebook (JSON storage, full-text search) | Notes in your terminal |
+| **ren** | Batch file renamer (prefix/suffix/regex/numbering) | Rename 100 files in one command |
+| **timer** | Countdown timer & stopwatch with desktop notifications | Pomodoro in your terminal |
+| **treedir** | Directory tree visualizer with depth control | `tree` on every OS |
+| **wordcount** | Enhanced word/char/line counter with language detection | wc on steroids |
+| **dt** | Date/time format converter (timestamps, timezones) | `dt 1735689600` → human date |
+
+### Security
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **passgen** | Password generator with entropy display & charset rules | Generate passwords that don't suck |
+| **uuid** | UUID generator (v1/v3/v4/v5/v7) | v4, v7, any UUID in one command |
+| **cron** | Cron expression parser & next-run calculator | "What does 0 2 * * 1 actually run?" |
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies (38 of 39 tools use stdlib only; ipinfo hits ip-api.com)
+
+## License
+
+MIT

evolver_tools-3.0.0/README.md

@@ -0,0 +1,90 @@
+# EVOLVER Tools
+
+**50 essential CLI tools — one `pip install`.**
+
+Zero-dependency (49/50), cross-platform, production-ready.
+Systems ops, data processing, dev tools, security, and creativity.
+~170KB total — one install, not 50.
+
+## Quick Start
+
+```bash
+pip install evolver-tools
+evtool list             # Show all 50 tools
+evtool ff < data.txt    # Fuzzy search through data
+evtool sysmon           # Launch system monitor
+evtool sort -n data.txt # Numeric sort
+```
+
+## Tools
+
+### Ops
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **sysmon** | Real-time system monitor (curses TUI — CPU/mem/disk/net/processes) | See your server breathe |
+| **dirsize** | Recursive directory space analyzer | Find what's eating your disk |
+| **envcheck** | Environment variable validator (missing keys, formats) | Stop .env typos from breaking prod |
+| **portcheck** | TCP port scanner & service detection | Port open? Service running? |
+| **siege-lite** | HTTP load tester (concurrency, latency percentile) | How many req/s can your app handle? |
+| **http-live** | SSE hot-reload HTTP server for development | Edit code, see changes. No refresh. |
+| **ipinfo** | Public IP & geolocation lookup | Where's this server? |
+| **hashsum** | File hash verification (MD5/SHA-1/256/512/BLAKE2, auto-detect) | Verify downloads in one command |
+| **find-dups** | Find duplicate files by SHA256 hash, size, or name | Reclaim gigabytes |
+
+### Developer
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **smellfinder** | Python code smell detector (AST-based, 10+ patterns) | Lint without pip install pylint |
+| **project-doctor** | Project health checker (meta, structure, quality) | Project checkup in one command |
+| **license-cli** | Open-source license generator/validator | License your repo instantly |
+| **markdown-check** | Markdown format validator & style checker | Docs that don't embarrass you |
+| **sqlite-cli** | SQLite query tool — CSV/JSON/table output | Query .db files without a GUI |
+| **b64** | Base64 encode/decode with auto-detection | Paste, pipe, done |
+| **jsonql** | Zero-dep JSON query tool (SQL-like syntax) | `jsonql "SELECT name FROM data WHERE age > 18"` |
+| **jq-lite** | jq-style JSON query — filter, extract, transform | jq without installing jq |
+| **urlparse** | URL parser & debugger | What's in that URL? |
+| **colors** | 256-color table & HEX↔RGB conversion | Design that terminal theme |
+| **fmt** | Code/text formatter — trailing whitespace, EOF newline, indent | Clean files, one command |
+
+### Data & Analysis
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **csv-stats** | CSV column analysis — histograms, frequencies, correlations | Understand your CSV in seconds |
+| **json2csv** | JSON to CSV converter with nested key flattening | API response → spreadsheet |
+| **chart-cli** | Terminal chart generator — bar, line, pie, histogram | Charts without leaving the terminal |
+| **cal** | Calendar & date calculator | What day is 45 days from now? |
+| **web-summary** | Web page content extractor (title, body, links) | Read the web from your terminal |
+| **yaml2json** | Convert YAML to JSON (zero dependencies, basic YAML subset) | Config files \u2192 pipeable JSON |
+| **sort** | Line sorting — alpha, numeric, reverse, unique, by column | Sort data without `sort(1)` |
+
+### Productivity
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **ff** | Interactive fuzzy finder (fzf, pure Python curses TUI) | Search files, history, anything |
+| **nb** | Command-line notebook (JSON storage, full-text search) | Notes in your terminal |
+| **ren** | Batch file renamer (prefix/suffix/regex/numbering) | Rename 100 files in one command |
+| **timer** | Countdown timer & stopwatch with desktop notifications | Pomodoro in your terminal |
+| **treedir** | Directory tree visualizer with depth control | `tree` on every OS |
+| **wordcount** | Enhanced word/char/line counter with language detection | wc on steroids |
+| **dt** | Date/time format converter (timestamps, timezones) | `dt 1735689600` → human date |
+
+### Security
+
+| Tool | Description | Selling point |
+|------|-------------|---------------|
+| **passgen** | Password generator with entropy display & charset rules | Generate passwords that don't suck |
+| **uuid** | UUID generator (v1/v3/v4/v5/v7) | v4, v7, any UUID in one command |
+| **cron** | Cron expression parser & next-run calculator | "What does 0 2 * * 1 actually run?" |
+
+## Requirements
+
+- Python 3.8+
+- No external dependencies (38 of 39 tools use stdlib only; ipinfo hits ip-api.com)
+
+## License
+
+MIT

evolver_tools-3.0.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.0.0"
+description = "100 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-1.5.0 → evolver_tools-3.0.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.0.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.0.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.0.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.0.0/src/evolver_tools/vendor/__init__.py

@@ -0,0 +1,3 @@
+"""EVOLVER Tools — vendor CLI tools."""
+
+__all__ = []

evolver_tools-3.0.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-3.0.0/src/evolver_tools/vendor/api_tester.py

@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+"""api-tester — HTTP API testing tool with method, headers, body, JSON, and timing support."""
+
+import sys
+import os
+import argparse
+import json
+import time
+import urllib.request
+import urllib.error
+import urllib.parse
+import ssl
+
+METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']
+
+
+def build_request(method, url, headers=None, data=None, json_data=None, timeout=30):
+    """Build and execute an HTTP request."""
+    if json_data is not None:
+        data = json.dumps(json_data).encode('utf-8')
+        if headers is None:
+            headers = {}
+        if 'Content-Type' not in {k.lower() for k in headers}:
+            headers['Content-Type'] = 'application/json'
+    elif data is not None and isinstance(data, str):
+        data = data.encode('utf-8')
+
+    req = urllib.request.Request(url, data=data, method=method.upper())
+    if headers:
+        for k, v in headers.items():
+            req.add_header(k, v)
+
+    ctx = ssl.create_default_context()
+    ctx.check_hostname = False
+    ctx.verify_mode = ssl.CERT_NONE
+    return req, ctx
+
+
+def do_request(method, url, headers=None, data=None, json_data=None, timeout=30):
+    """Execute a single request and return result dict."""
+    req, ctx = build_request(method, url, headers, data, json_data, timeout)
+    start = time.time()
+    try:
+        resp = urllib.request.urlopen(req, context=ctx, timeout=timeout)
+        elapsed = time.time() - start
+        body = resp.read()
+        content_type = resp.headers.get('Content-Type', '')
+        if 'application/json' in content_type:
+            try:
+                body_parsed = json.loads(body)
+                body_str = json.dumps(body_parsed, indent=2)
+            except (json.JSONDecodeError, ValueError):
+                body_str = body.decode('utf-8', errors='replace')
+        else:
+            body_str = body.decode('utf-8', errors='replace')
+        return {
+            'status': resp.status,
+            'reason': resp.reason,
+            'headers': dict(resp.headers),
+            'body': body_str,
+            'elapsed': elapsed,
+            'error': None,
+        }
+    except urllib.error.HTTPError as e:
+        elapsed = time.time() - start
+        body = e.read()
+        body_str = body.decode('utf-8', errors='replace')
+        return {
+            'status': e.code,
+            'reason': e.reason,
+            'headers': dict(e.headers),
+            'body': body_str,
+            'elapsed': elapsed,
+            'error': None,
+        }
+    except urllib.error.URLError as e:
+        return {
+            'status': 0,
+            'reason': str(e.reason),
+            'headers': {},
+            'body': '',
+            'elapsed': 0,
+            'error': str(e.reason),
+        }
+    except Exception as e:
+        return {
+            'status': 0,
+            'reason': str(e),
+            'headers': {},
+            'body': '',
+            'elapsed': 0,
+            'error': str(e),
+        }
+
+
+def print_result(result, show_headers=True, show_body=True, verbose=False):
+    """Print a formatted request result."""
+    elapsed = result['elapsed']
+    status = result['status']
+
+    if result['error']:
+        print(f"\033[91mERROR: {result['error']}\033[0m", file=sys.stderr)
+        return
+
+    if status >= 200 and status < 300:
+        color = '\033[92m'
+    elif status >= 300 and status < 400:
+        color = '\033[93m'
+    else:
+        color = '\033[91m'
+    print(f"{color}{status} {result['reason']}\033[0m  (\033[94m{elapsed:.3f}s\033[0m)")
+
+    if show_headers and result['headers']:
+        print(f"\n\033[1mHeaders:\033[0m")
+        for k, v in result['headers'].items():
+            if verbose or k.lower() not in ('set-cookie', 'x-powered-by'):
+                print(f"  \033[33m{k}\033[0m: {v}")
+
+    if show_body and result['body']:
+        print(f"\n\033[1mBody:\033[0m")
+        print(result['body'])
+
+
+def benchmark(method, url, count, headers=None, data=None, json_data=None, timeout=30):
+    """Run multiple requests and show stats."""
+    times = []
+    statuses = {}
+    errors = 0
+
+    print(f"\033[1mBenchmarking: {method} {url}\033[0m")
+    print(f"  Requests: {count}")
+    print()
+
+    for i in range(count):
+        result = do_request(method, url, headers, data, json_data, timeout)
+        times.append(result['elapsed'])
+        if result['error']:
+            errors += 1
+        else:
+            s = result['status']
+            statuses[s] = statuses.get(s, 0) + 1
+
+        elapsed_str = f"\033[94m{result['elapsed']:.3f}s\033[0m"
+        if result['error']:
+            print(f"  [{i+1}/{count}] \033[91mERROR\033[0m - {result['error']} ({elapsed_str})")
+        else:
+            print(f"  [{i+1}/{count}] {result['status']} ({elapsed_str})")
+
+    if times:
+        print(f"\n\033[1mSummary:\033[0m")
+        print(f"  Total time:  \033[94m{sum(times):.3f}s\033[0m")
+        print(f"  Avg time:    \033[94m{sum(times)/len(times):.3f}s\033[0m")
+        print(f"  Min time:    \033[94m{min(times):.3f}s\033[0m")
+        print(f"  Max time:    \033[94m{max(times):.3f}s\033[0m")
+        if len(times) > 1:
+            variance = sum((t - sum(times)/len(times))**2 for t in times) / len(times)
+            print(f"  Std dev:     \033[94m{variance**0.5:.3f}s\033[0m")
+        print(f"  Errors:      \033[91m{errors}\033[0m" if errors else f"  Errors:      0")
+        if statuses:
+            status_str = ', '.join(f"{k}={v}" for k, v in sorted(statuses.items()))
+            print(f"  Statuses:    {status_str}")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='HTTP API testing tool. Send requests and inspect responses.',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  api-tester GET https://api.example.com/users
+  api-tester POST https://api.example.com/users -H "Content-Type: application/json" -d '{"name":"test"}'
+  api-tester --benchmark 5 GET https://example.com
+  api-tester PUT https://api.example.com/users/1 -j '{"name":"updated"}'
+  api-tester DELETE https://api.example.com/users/1
+        """,
+    )
+    parser.add_argument('method', nargs='?', choices=METHODS, help='HTTP method')
+    parser.add_argument('url', nargs='?', help='Target URL')
+    parser.add_argument('-H', '--header', action='append', dest='headers', default=[],
+                        help='Request header (key:value, repeatable)')
+    parser.add_argument('-d', '--data', help='Request body data (string)')
+    parser.add_argument('-j', '--json', dest='json_data', help='JSON body (parsed)')
+    parser.add_argument('--benchmark', type=int, metavar='N', help='Run N requests for benchmarking')
+    parser.add_argument('--timeout', type=int, default=30, help='Request timeout in seconds')
+    parser.add_argument('--no-headers', action='store_true', help='Hide response headers')
+    parser.add_argument('--no-body', action='store_true', help='Hide response body')
+    parser.add_argument('--verbose', '-v', action='store_true', help='Show all headers including verbose ones')
+
+    args = parser.parse_args()
+
+    if not args.method or not args.url:
+        parser.print_help()
+        sys.exit(1)
+
+    headers = {}
+    for h in args.headers:
+        if ':' in h:
+            k, v = h.split(':', 1)
+            headers[k.strip()] = v.strip()
+        else:
+            print(f"Invalid header format: {h} (expected key:value)", file=sys.stderr)
+            sys.exit(1)
+
+    json_data = None
+    if args.json_data:
+        try:
+            json_data = json.loads(args.json_data)
+        except json.JSONDecodeError as e:
+            print(f"Invalid JSON data: {e}", file=sys.stderr)
+            sys.exit(1)
+
+    data = args.data
+
+    try:
+        if args.benchmark:
+            benchmark(args.method, args.url, args.benchmark, headers, data, json_data, args.timeout)
+        else:
+            result = do_request(args.method, args.url, headers, data, json_data, args.timeout)
+            print_result(result, show_headers=not args.no_headers, show_body=not args.no_body, verbose=args.verbose)
+    except KeyboardInterrupt:
+        print("\nAborted by user.", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "api-tester",
+    "func": "main",
+    "desc": 'HTTP API testing tool',
+}
+
+if __name__ == '__main__':
+    main()