evolver-tools 21.0.0__tar.gz → 23.0.0__tar.gz

{evolver_tools-21.0.0/src/evolver_tools.egg-info → evolver_tools-23.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: evolver-tools
-Version: 21.0.0
-Summary: 191 CLI tools + 9 flagship projects — one pip install
+Version: 23.0.0
+Summary: 201 CLI tools + 9 flagship projects — one pip install
 Author: EVOLVER
 License-Expression: MIT
 Project-URL: Homepage, https://evolver-dev.github.io/evolver-tools

{evolver_tools-21.0.0 → evolver_tools-23.0.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "evolver-tools"
-version = "21.0.0"
-description = "191 CLI tools + 9 flagship projects — one pip install"
+version = "23.0.0"
+description = "201 CLI tools + 9 flagship projects — one pip install"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.8"

{evolver_tools-21.0.0 → evolver_tools-23.0.0}/src/evolver_tools/cli.py

@@ -14,7 +14,7 @@ from evolver_tools.autoreg import auto_discover
 def list_tools():
     """Display all available tools."""
     tools = auto_discover()
-    print(f'\x1b[1;36m===== EVOLVER Tools v21.0.0 =====\x1b[0m')
+    print(f'\x1b[1;36m===== EVOLVER Tools v23.0.0 =====\x1b[0m')
     print()
     for name, info in sorted(tools.items()):
         print(f'  \033[1;33m{name:<18}\033[0m {info["desc"]}')

evolver_tools-23.0.0/src/evolver_tools/vendor/base58.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+"""base58 — Base58 encode/decode (Bitcoin-style alphabet).
+
+Usage: base58 encode hello
+       base58 decode 3yZe7d
+       echo hello | base58 encode
+
+Base58 uses Bitcoin alphabet (123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz).
+No '0', 'O', 'I', 'l' — safe for human transcription.
+"""
+
+import sys
+
+TOOL_META = {
+    "name": "base58",
+    "func": "main",
+    "desc": "Base58 encode/decode (Bitcoin-style alphabet)",
+}
+
+ALPHABET = b'123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz'
+BASE = 58
+
+def b58encode(data):
+    if isinstance(data, str):
+        data = data.encode()
+    n = int.from_bytes(data, 'big')
+    if n == 0:
+        return '1'
+    res = []
+    while n > 0:
+        n, r = divmod(n, BASE)
+        res.append(chr(ALPHABET[r]))
+    # Leading zeros
+    leading = 0
+    for b in data:
+        if b == 0:
+            leading += 1
+        else:
+            break
+    return '1' * leading + ''.join(reversed(res))
+
+
+def b58decode(s):
+    n = 0
+    for c in s:
+        idx = ALPHABET.find(c.encode() if isinstance(c, str) else c)
+        if idx == -1:
+            raise ValueError(f"Invalid Base58 character: {c}")
+        n = n * BASE + idx
+    # Count leading '1's
+    leading = 0
+    for c in s:
+        if c == '1':
+            leading += 1
+        else:
+            break
+    result = n.to_bytes((n.bit_length() + 7) // 8, 'big') if n > 0 else b''
+    return b'\x00' * leading + result
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ('-h', '--help'):
+        print(__doc__)
+        return
+
+    mode = args[0]
+    if mode not in ('encode', 'decode'):
+        print("Usage: base58 encode|decode [text]", file=sys.stderr)
+        sys.exit(1)
+
+    if len(args) > 1:
+        data = ' '.join(args[1:])
+    else:
+        data = sys.stdin.read().strip()
+
+    if not data:
+        print("Error: no input", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        if mode == 'encode':
+            result = b58encode(data.encode() if isinstance(data, str) else data)
+        else:
+            result = b58decode(data)
+            try:
+                result = result.decode('utf-8')
+            except UnicodeDecodeError:
+                result = result.hex()
+        print(result)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)

evolver_tools-23.0.0/src/evolver_tools/vendor/crc_check.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python3
+"""crc_check — CRC32/CRC64 checksum calculator for files.
+
+Usage: crc_check file.bin
+       crc_check --crc64 file.bin
+       crc_check --all file.bin
+       cat file.bin | crc_check
+
+Verify file integrity with CRC checksums.
+Zero external dependencies (zlib.crc32 + pure Python CRC64).
+"""
+
+import sys
+import os
+import zlib
+
+TOOL_META = {
+    "name": "crc_check",
+    "func": "main",
+    "desc": "CRC32/CRC64 checksum calculator for files",
+}
+
+def crc64(data):
+    """Compute CRC64-ECMA-182."""
+    poly = 0xC96C5795D7870F42
+    crc = 0xFFFFFFFFFFFFFFFF
+    for byte in data:
+        crc ^= byte
+        for _ in range(8):
+            if crc & 1:
+                crc = (crc >> 1) ^ poly
+            else:
+                crc >>= 1
+    return crc ^ 0xFFFFFFFFFFFFFFFF
+
+
+def main():
+    args = sys.argv[1:]
+    mode = 'crc32'
+    files = []
+
+    i = 0
+    while i < len(args):
+        if args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        elif args[i] == '--crc64':
+            mode = 'crc64'
+            i += 1
+        elif args[i] == '--all':
+            mode = 'all'
+            i += 1
+        elif args[i].startswith('--'):
+            print(f"Unknown flag: {args[i]}", file=sys.stderr)
+            sys.exit(1)
+        else:
+            files.append(args[i])
+            i += 1
+
+    if files:
+        for path in files:
+            if not os.path.exists(path):
+                print(f"Error: file not found: {path}", file=sys.stderr)
+                sys.exit(1)
+            with open(path, 'rb') as f:
+                data = f.read()
+            name = os.path.basename(path)
+            if mode in ('crc32', 'all'):
+                print(f"CRC32({name}) = {zlib.crc32(data) & 0xFFFFFFFF:08x}")
+            if mode in ('crc64', 'all'):
+                print(f"CRC64({name}) = {crc64(data):016x}")
+    else:
+        data = sys.stdin.buffer.read()
+        if mode in ('crc32', 'all'):
+            print(f"CRC32 = {zlib.crc32(data) & 0xFFFFFFFF:08x}")
+        if mode in ('crc64', 'all'):
+            print(f"CRC64 = {crc64(data):016x}")

evolver_tools-23.0.0/src/evolver_tools/vendor/date_diff.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python3
+"""date_diff — Calculate date/time differences.
+
+Usage: date_diff 2026-01-01 2026-06-01
+       date_diff 2026-01-01 2026-06-01 --unit hours
+       date_diff now "2026-12-25"
+       date_diff "2026-01-01 09:00" "2026-01-01 17:30" --unit minutes
+
+Show difference in days, hours, minutes, or seconds between two dates.
+Accepts ISO 8601 dates, 'now', and datetime strings.
+"""
+
+import sys
+from datetime import datetime
+
+TOOL_META = {
+    "name": "date_diff",
+    "func": "main",
+    "desc": "Calculate date/time differences",
+}
+
+def parse_date(s):
+    if s.lower() == 'now':
+        return datetime.now()
+    for fmt in ('%Y-%m-%d %H:%M:%S', '%Y-%m-%d %H:%M', '%Y-%m-%d',
+                '%Y/%m/%d %H:%M:%S', '%Y/%m/%d %H:%M', '%Y/%m/%d',
+                '%m/%d/%Y', '%d/%m/%Y'):
+        try:
+            return datetime.strptime(s, fmt)
+        except ValueError:
+            continue
+    raise ValueError(f"Cannot parse date: {s}")
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ('-h', '--help'):
+        print(__doc__)
+        return
+
+    unit = 'days'
+    date_strs = []
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--unit' and i + 1 < len(args):
+            unit = args[i + 1].lower()
+            i += 2
+        elif args[i].startswith('--'):
+            print(f"Unknown flag: {args[i]}", file=sys.stderr)
+            sys.exit(1)
+        else:
+            date_strs.append(args[i])
+            i += 1
+
+    if len(date_strs) < 2:
+        print("Error: need two dates", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        d1 = parse_date(date_strs[0])
+        d2 = parse_date(date_strs[1])
+    except ValueError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    delta = abs(d2 - d1)
+    total_seconds = delta.total_seconds()
+
+    if unit in ('days', 'day', 'd'):
+        result = total_seconds / 86400
+        label = 'days'
+    elif unit in ('hours', 'hour', 'h'):
+        result = total_seconds / 3600
+        label = 'hours'
+    elif unit in ('minutes', 'minute', 'min', 'm'):
+        result = total_seconds / 60
+        label = 'minutes'
+    elif unit in ('seconds', 'second', 'sec', 's'):
+        result = total_seconds
+        label = 'seconds'
+    elif unit in ('weeks', 'week', 'w'):
+        result = total_seconds / 604800
+        label = 'weeks'
+    elif unit in ('months', 'month'):
+        # Approximate
+        result = total_seconds / (86400 * 30.44)
+        label = 'months'
+    elif unit in ('years', 'year', 'y'):
+        result = total_seconds / (86400 * 365.25)
+        label = 'years'
+    else:
+        print(f"Error: unknown unit: {unit}", file=sys.stderr)
+        sys.exit(1)
+
+    if result == int(result):
+        print(f"{int(result)} {label}")
+    else:
+        print(f"{result:.2f} {label}")

evolver_tools-23.0.0/src/evolver_tools/vendor/env_template.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""env_template — Generate .env.example from .env (strip values, keep keys).
+
+Usage: env_template              # Reads .env, writes .env.example
+       env_template .env.prod    # Reads specific file
+       env_template --stdout     # Print to stdout instead
+
+Strip all values from .env files, keeping only the keys and comments.
+Useful for committing a safe .env.example to version control.
+"""
+
+import sys
+import os
+import re
+
+TOOL_META = {
+    "name": "env_template",
+    "func": "main",
+    "desc": "Generate .env.example from .env (strip values, keep keys)",
+}
+
+
+def main():
+    args = sys.argv[1:]
+    input_file = '.env'
+    stdout_mode = False
+    output_file = '.env.example'
+
+    for arg in args:
+        if arg == '--stdout':
+            stdout_mode = True
+        elif arg in ('-h', '--help'):
+            print(__doc__)
+            return
+        elif not arg.startswith('--'):
+            input_file = arg
+        else:
+            print(f"Unknown flag: {arg}", file=sys.stderr)
+            sys.exit(1)
+
+    if not os.path.exists(input_file):
+        print(f"Error: {input_file} not found", file=sys.stderr)
+        sys.exit(1)
+
+    with open(input_file) as f:
+        lines = f.readlines()
+
+    result = []
+    for line in lines:
+        stripped = line.rstrip('\n')
+        # Comment line — keep as-is
+        if stripped.strip().startswith('#'):
+            result.append(stripped)
+        # Empty line — keep
+        elif not stripped.strip():
+            result.append('')
+        # Key=value line — strip value
+        elif '=' in stripped:
+            key = stripped.split('=', 1)[0].strip()
+            # Detect inline comments after key
+            comment = ''
+            cm = re.search(r'\s+#.*$', stripped)
+            if cm:
+                comment = cm.group()
+            result.append(f"{key}={comment.strip() if comment else ''}")
+        else:
+            # Keep lines that don't match known patterns
+            result.append(stripped)
+
+    output = '\n'.join(result)
+
+    if stdout_mode:
+        print(output)
+    else:
+        if not output_file:
+            base, _ = os.path.splitext(input_file)
+            output_file = f"{base}.example"
+        with open(output_file, 'w') as f:
+            f.write(output)
+            f.write('\n')
+        print(f"Written {output_file} ({len([l for l in result if '=' in l])} keys)")

evolver_tools-23.0.0/src/evolver_tools/vendor/file_find.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""file_find — Find files by name pattern with recursive search.
+
+Usage: file_find *.txt              # Find all .txt files
+       file_find config* --dir .    # In current dir
+       file_find test_*.py --max 10 # Limit results
+       file_find Dockerfile         # Exact name match
+
+Lightweight alternative to 'find' with simpler syntax.
+Uses fnmatch pattern matching. Zero dependencies.
+"""
+
+import os
+import sys
+import fnmatch
+
+TOOL_META = {
+    "name": "file_find",
+    "func": "main",
+    "desc": "Find files by name pattern with recursive search",
+}
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ('-h', '--help'):
+        print(__doc__)
+        return
+
+    pattern = None
+    search_dir = os.getcwd()
+    max_results = 0
+    case_insensitive = False
+    type_filter = None  # 'f' or 'd'
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--dir' and i + 1 < len(args):
+            search_dir = os.path.abspath(args[i + 1])
+            i += 2
+        elif args[i] == '--max' and i + 1 < len(args):
+            max_results = int(args[i + 1])
+            i += 2
+        elif args[i] == '--type' and i + 1 < len(args):
+            type_filter = args[i + 1]
+            i += 2
+        elif args[i] == '--ignore-case' or args[i] == '-i':
+            case_insensitive = True
+            i += 1
+        elif not args[i].startswith('--'):
+            pattern = args[i]
+            i += 1
+        else:
+            i += 1
+
+    if not pattern:
+        print("Error: no pattern specified", file=sys.stderr)
+        sys.exit(1)
+
+    if not os.path.isdir(search_dir):
+        print(f"Error: directory not found: {search_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    count = 0
+    for root, dirs, files in os.walk(search_dir):
+        # Skip hidden dirs by default
+        dirs[:] = [d for d in dirs if not d.startswith('.')]
+
+        targets = []
+        if type_filter in (None, 'f'):
+            targets.extend(files)
+        if type_filter in (None, 'd'):
+            targets.extend(dirs)
+
+        for name in targets:
+            matched = False
+            if case_insensitive:
+                matched = fnmatch.fnmatch(name.lower(), pattern.lower())
+            else:
+                matched = fnmatch.fnmatch(name, pattern)
+
+            if matched:
+                path = os.path.join(root, name)
+                print(path)
+                count += 1
+                if max_results and count >= max_results:
+                    print(f"--- {count} results (max: {max_results}) ---")
+                    return
+
+    if count == 0:
+        print(f"No files matching '{pattern}' in {search_dir}")

evolver_tools-23.0.0/src/evolver_tools/vendor/ip_info.py

@@ -0,0 +1,70 @@
+#!/usr/bin/env python3
+"""ip_info — Show public IP address and geolocation info.
+
+Usage: ip_info                 # Your public IP
+       ip_info 8.8.8.8        # Lookup specific IP
+       ip_info --json          # JSON output
+
+Uses ip-api.com for geolocation data.
+"""
+
+import sys
+import json
+import urllib.request
+import urllib.error
+
+TOOL_META = {
+    "name": "ip_info",
+    "func": "main",
+    "desc": "Show public IP address and geolocation info",
+}
+
+
+def main():
+    args = sys.argv[1:]
+    ip = None
+    json_mode = False
+
+    for arg in args:
+        if arg in ('-h', '--help'):
+            print(__doc__)
+            return
+        elif arg == '--json' or arg == '-j':
+            json_mode = True
+        elif not arg.startswith('--'):
+            ip = arg
+        else:
+            print(f"Unknown flag: {arg}", file=sys.stderr)
+            sys.exit(1)
+
+    target = ip or ''
+    url = f"http://ip-api.com/json/{target}?fields=status,message,query,country,regionName,city,zip,lat,lon,isp,org,as,timezone"
+
+    try:
+        resp = urllib.request.urlopen(url, timeout=10)
+        data = json.loads(resp.read().decode())
+    except urllib.error.URLError as e:
+        print(f"Error: {e.reason}", file=sys.stderr)
+        sys.exit(1)
+    except json.JSONDecodeError:
+        print("Error: invalid response from API", file=sys.stderr)
+        sys.exit(1)
+
+    if data.get('status') == 'fail':
+        print(f"Error: {data.get('message', 'unknown')}", file=sys.stderr)
+        sys.exit(1)
+
+    if json_mode:
+        print(json.dumps(data, indent=2))
+        return
+
+    print(f"  IP:        {data['query']}")
+    print(f"  Country:   {data.get('country', 'N/A')}")
+    print(f"  Region:    {data.get('regionName', 'N/A')}")
+    print(f"  City:      {data.get('city', 'N/A')}")
+    print(f"  ZIP:       {data.get('zip', 'N/A')}")
+    print(f"  Lat/Lon:   {data.get('lat', '')}, {data.get('lon', '')}")
+    print(f"  ISP:       {data.get('isp', 'N/A')}")
+    print(f"  Org:       {data.get('org', 'N/A')}")
+    print(f"  AS:        {data.get('as', 'N/A')}")
+    print(f"  Timezone:  {data.get('timezone', 'N/A')}")

evolver_tools-23.0.0/src/evolver_tools/vendor/json_merge.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""json_merge — Merge multiple JSON files into one.
+
+Usage: json_merge file1.json file2.json
+       json_merge *.json --output merged.json
+       json_merge base.json override.json --strategy deep
+
+Merge strategies:
+  - shallow (default): top-level keys only. Later files override earlier.
+  - deep: recursive merge of nested dicts.
+  - array: concatenate arrays.
+"""
+
+import json
+import sys
+import os
+from copy import deepcopy
+
+TOOL_META = {
+    "name": "json_merge",
+    "func": "main",
+    "desc": "Merge multiple JSON files into one",
+}
+
+
+def deep_merge(a, b):
+    """Recursively merge b into a."""
+    result = deepcopy(a)
+    for key in b:
+        if key in result and isinstance(result[key], dict) and isinstance(b[key], dict):
+            result[key] = deep_merge(result[key], b[key])
+        else:
+            result[key] = deepcopy(b[key])
+    return result
+
+
+def array_merge(a, b):
+    """Merge arrays by concatenation."""
+    if isinstance(a, dict) and isinstance(b, dict):
+        result = deepcopy(a)
+        for key in b:
+            if key in result and isinstance(result[key], list) and isinstance(b[key], list):
+                result[key] = result[key] + b[key]
+            elif key in result and isinstance(result[key], dict) and isinstance(b[key], dict):
+                result[key] = deep_merge(result[key], b[key])
+            else:
+                result[key] = deepcopy(b[key])
+        return result
+    elif isinstance(a, list) and isinstance(b, list):
+        return a + b
+    return b
+
+
+def main():
+    args = sys.argv[1:]
+    files = []
+    strategy = 'shallow'
+    output = None
+
+    i = 0
+    while i < len(args):
+        if args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        elif args[i] == '--strategy' and i + 1 < len(args):
+            strategy = args[i + 1].lower()
+            i += 2
+        elif args[i] == '--output' and i + 1 < len(args):
+            output = args[i + 1]
+            i += 2
+        elif not args[i].startswith('--'):
+            files.append(args[i])
+            i += 1
+        else:
+            i += 1
+
+    if len(files) < 2:
+        print("Error: need at least 2 JSON files", file=sys.stderr)
+        sys.exit(1)
+
+    data = []
+    for path in files:
+        if not os.path.exists(path):
+            print(f"Error: file not found: {path}", file=sys.stderr)
+            sys.exit(1)
+        with open(path) as f:
+            data.append(json.load(f))
+
+    result = data[0]
+    for d in data[1:]:
+        if strategy == 'deep':
+            result = deep_merge(result, d)
+        elif strategy == 'array':
+            result = array_merge(result, d)
+        else:
+            # shallow
+            result.update(d)
+
+    if output:
+        with open(output, 'w') as f:
+            json.dump(result, f, indent=2)
+        print(f"Merged {len(files)} files -> {output}")
+    else:
+        print(json.dumps(result, indent=2))