evolver-tools 20.0.0__tar.gz → 22.0.0__tar.gz

{evolver_tools-20.0.0/src/evolver_tools.egg-info → evolver_tools-22.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: evolver-tools
-Version: 20.0.0
-Summary: 186 CLI tools + 9 flagship projects — one pip install
+Version: 22.0.0
+Summary: 196 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-20.0.0 → evolver_tools-22.0.0}/pyproject.toml

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

{evolver_tools-20.0.0 → evolver_tools-22.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 v20.0.0 =====\x1b[0m')
+    print(f'\x1b[1;36m===== EVOLVER Tools v22.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-22.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-22.0.0/src/evolver_tools/vendor/csv_merge.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""csv_merge — Merge multiple CSV files by a common column.
+
+Usage: csv_merge file1.csv file2.csv --on id
+       csv_merge file1.csv file2.csv --on id --how outer
+       csv_merge *.csv --on user_id --output merged.csv
+
+Joins CSV files on a common key column, like SQL JOIN.
+Supports inner, left, and outer joins.
+Zero external dependencies.
+"""
+
+import csv
+import sys
+import os
+from collections import OrderedDict
+
+TOOL_META = {
+    "name": "csv_merge",
+    "func": "main",
+    "desc": "Merge CSV files by common column (inner/left/outer join)",
+}
+
+def load_csv(path):
+    with open(path, newline='', encoding='utf-8-sig') as f:
+        reader = csv.DictReader(f)
+        rows = list(reader)
+    if not rows:
+        return [], []
+    return rows, list(rows[0].keys())
+
+
+def main():
+    args = sys.argv[1:]
+    if not args or args[0] in ('-h', '--help'):
+        print(__doc__)
+        return
+
+    # Parse --on, --how, --output
+    on_col = None
+    how = 'inner'
+    output = None
+    files = []
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--on' and i + 1 < len(args):
+            on_col = args[i + 1]
+            i += 2
+        elif args[i] == '--how' and i + 1 < len(args):
+            how = args[i + 1].lower()
+            i += 2
+        elif args[i] == '--output' and i + 1 < len(args):
+            output = args[i + 1]
+            i += 2
+        else:
+            files.append(args[i])
+            i += 1
+
+    if len(files) < 2:
+        print("Error: need at least 2 CSV files", file=sys.stderr)
+        sys.exit(1)
+
+    if not on_col:
+        print("Error: --on <column> required", file=sys.stderr)
+        sys.exit(1)
+
+    # Load all CSVs
+    tables = []
+    for f in files:
+        if not os.path.exists(f):
+            print(f"Error: file not found: {f}", file=sys.stderr)
+            sys.exit(1)
+        rows, cols = load_csv(f)
+        tables.append((os.path.basename(f), rows, cols))
+
+    # Build lookup from first file
+    lookup = {}
+    for row in tables[0][1]:
+        key = row.get(on_col, '')
+        lookup[key] = row
+
+    # Merge subsequent files
+    merged = []
+    all_cols_set = OrderedDict()
+    for t in tables:
+        for c in t[2]:
+            all_cols_set[c] = True
+
+    all_cols = list(all_cols_set.keys())
+
+    if how == 'inner':
+        for t in tables[1:]:
+            for row in t[1]:
+                key = row.get(on_col, '')
+                if key in lookup:
+                    merged_row = OrderedDict()
+                    for c in all_cols:
+                        merged_row[c] = lookup[key].get(c, '') or row.get(c, '')
+                    merged.append(merged_row)
+        # For inner, merge first two then subsequent
+        if len(tables) > 2:
+            # Re-merge with remaining tables
+            temp = merged
+            for t in tables[2:]:
+                merged2 = []
+                t_lookup = {r.get(on_col, ''): r for r in t[1]}
+                for row in temp:
+                    key = row.get(on_col, '')
+                    if key in t_lookup:
+                        merged_row = OrderedDict(row)
+                        for c in t_lookup[key]:
+                            if c != on_col and c not in merged_row:
+                                merged_row[c] = t_lookup[key][c]
+                        merged2.append(merged_row)
+                temp = merged2
+            merged = temp
+    elif how == 'left':
+        merged = list(lookup.values())
+        for t in tables[1:]:
+            t_lookup = {r.get(on_col, ''): r for r in t[1]}
+            for row in merged:
+                key = row.get(on_col, '')
+                if key in t_lookup:
+                    for c, v in t_lookup[key].items():
+                        if c != on_col and c not in row:
+                            row[c] = v
+    elif how == 'outer':
+        all_keys = set()
+        for t in tables:
+            for r in t[1]:
+                all_keys.add(r.get(on_col, ''))
+        key_rows = {}
+        for t in tables:
+            for r in t[1]:
+                k = r.get(on_col, '')
+                if k not in key_rows:
+                    key_rows[k] = OrderedDict()
+                    key_rows[k][on_col] = k
+                for c, v in r.items():
+                    if c != on_col and v:
+                        key_rows[k][c] = v
+        merged = list(key_rows.values())
+    else:
+        print(f"Error: unknown join type: {how} (use inner/left/outer)", file=sys.stderr)
+        sys.exit(1)
+
+    # Write output
+    if output:
+        with open(output, 'w', newline='', encoding='utf-8') as f:
+            writer = csv.DictWriter(f, fieldnames=list(all_cols_set.keys()))
+            writer.writeheader()
+            writer.writerows(merged)
+        print(f"Merged {len(merged)} rows -> {output}")
+    else:
+        writer = csv.DictWriter(sys.stdout, fieldnames=list(all_cols_set.keys()))
+        writer.writeheader()
+        writer.writerows(merged)

evolver_tools-22.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-22.0.0/src/evolver_tools/vendor/diff_files.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+"""diff_files — Line-by-line file comparison.
+
+Usage: diff_files file1.txt file2.txt
+       diff_files file1.txt file2.txt --context 3
+       diff_files file1.txt file2.txt --brief
+
+Simple diff tool. Shows added/removed lines with +/- markers.
+Zero external dependencies (pure Python difflib).
+"""
+
+import difflib
+import sys
+import os
+
+TOOL_META = {
+    "name": "diff_files",
+    "func": "main",
+    "desc": "Line-by-line file comparison",
+}
+
+
+def main():
+    args = sys.argv[1:]
+    context = 3
+    brief = False
+    files = []
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--context' and i + 1 < len(args):
+            context = int(args[i + 1])
+            i += 2
+        elif args[i] == '--brief' or args[i] == '-q':
+            brief = True
+            i += 1
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            files.append(args[i])
+            i += 1
+
+    if len(files) != 2:
+        print("Error: need exactly 2 files", file=sys.stderr)
+        print(__doc__)
+        sys.exit(1)
+
+    file1, file2 = files
+    for f in (file1, file2):
+        if not os.path.exists(f):
+            print(f"Error: file not found: {f}", file=sys.stderr)
+            sys.exit(1)
+
+    with open(file1) as f:
+        lines1 = f.readlines()
+    with open(file2) as f:
+        lines2 = f.readlines()
+
+    if brief:
+        if lines1 != lines2:
+            print(f"Files {file1} and {file2} differ")
+        else:
+            print(f"Files {file1} and {file2} are identical")
+        return
+
+    diff = difflib.unified_diff(
+        lines1, lines2,
+        fromfile=file1, tofile=file2,
+        n=context
+    )
+
+    output = list(diff)
+    if not output:
+        print("Files are identical.")
+        return
+
+    for line in output:
+        if line.startswith('+') and not line.startswith('+++'):
+            sys.stdout.write(f'\033[32m{line}\033[0m')
+        elif line.startswith('-') and not line.startswith('---'):
+            sys.stdout.write(f'\033[31m{line}\033[0m')
+        elif line.startswith('@@'):
+            sys.stdout.write(f'\033[36m{line}\033[0m')
+        else:
+            sys.stdout.write(line)

evolver_tools-22.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-22.0.0/src/evolver_tools/vendor/http_server.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""http_server — Simple static file HTTP server.
+
+Usage: http_server              # Port 8080, current dir
+       http_server 3000         # Port 3000
+       http_server 8080 ./docs  # Port 8080, serve ./docs
+       http_server --bind 0.0.0.0 9090
+
+Lightweight alternative to 'python -m http.server' with
+better defaults and cleaner output.
+"""
+
+import os
+import sys
+import http.server
+import socketserver
+
+TOOL_META = {
+    "name": "http_server",
+    "func": "main",
+    "desc": "Simple static file HTTP server",
+}
+
+
+def main():
+    args = sys.argv[1:]
+    port = 8080
+    directory = os.getcwd()
+    bind = '127.0.0.1'
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--bind' and i + 1 < len(args):
+            bind = args[i + 1]
+            i += 2
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            try:
+                port = int(args[i])
+            except ValueError:
+                directory = os.path.abspath(args[i])
+            i += 1
+
+    if not os.path.isdir(directory):
+        print(f"Error: directory not found: {directory}", file=sys.stderr)
+        sys.exit(1)
+
+    os.chdir(directory)
+    handler = http.server.SimpleHTTPRequestHandler
+
+    class SilentHandler(handler):
+        def log_message(self, fmt, *args):
+            sys.stderr.write(f"[HTTP] {args[0]} {args[1]} {args[2]}\n")
+
+    try:
+        with socketserver.TCPServer((bind, port), SilentHandler) as httpd:
+            print(f"Serving {directory} at http://{bind}:{port}")
+            print("Press Ctrl+C to stop")
+            httpd.serve_forever()
+    except OSError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\nStopped.")

evolver_tools-22.0.0/src/evolver_tools/vendor/json_flatten.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""json_flatten — Flatten nested JSON to dot-notation key=value pairs.
+
+Usage: json_flatten data.json
+       json_flatten data.json --sep /
+       cat data.json | json_flatten
+
+Useful for converting nested JSON to flat key-value format
+for CSV export, env files, or debugging.
+"""
+
+import json
+import sys
+import os
+
+TOOL_META = {
+    "name": "json_flatten",
+    "func": "main",
+    "desc": "Flatten nested JSON to dot-notation key=value pairs",
+}
+
+def flatten(obj, parent_key='', sep='.'):
+    items = []
+    if isinstance(obj, dict):
+        for k, v in obj.items():
+            new_key = f"{parent_key}{sep}{k}" if parent_key else k
+            if isinstance(v, (dict, list)):
+                items.extend(flatten(v, new_key, sep=sep))
+            else:
+                items.append((new_key, v))
+    elif isinstance(obj, list):
+        for i, v in enumerate(obj):
+            new_key = f"{parent_key}{sep}{i}" if parent_key else str(i)
+            if isinstance(v, (dict, list)):
+                items.extend(flatten(v, new_key, sep=sep))
+            else:
+                items.append((new_key, v))
+    else:
+        items.append((parent_key, obj))
+    return items
+
+
+def main():
+    args = sys.argv[1:]
+    sep = '.'
+    files = []
+
+    i = 0
+    while i < len(args):
+        if args[i] == '--sep' and i + 1 < len(args):
+            sep = args[i + 1]
+            i += 2
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            files.append(args[i])
+            i += 1
+
+    if files:
+        data = []
+        for f in files:
+            if not os.path.exists(f):
+                print(f"Error: file not found: {f}", file=sys.stderr)
+                sys.exit(1)
+            with open(f) as fp:
+                data.append(json.load(fp))
+        if len(data) == 1:
+            data = data[0]
+    else:
+        data = json.load(sys.stdin)
+
+    items = flatten(data, sep=sep)
+    for key, val in items:
+        if val is None:
+            val = 'null'
+        elif isinstance(val, bool):
+            val = str(val).lower()
+        elif isinstance(val, (int, float)):
+            val = str(val)
+        print(f"{key}={val}")