evolver-tools 17.0.0__tar.gz → 19.0.0__tar.gz

{evolver_tools-17.0.0/src/evolver_tools.egg-info → evolver_tools-19.0.0}/PKG-INFO

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

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

{evolver_tools-17.0.0 → evolver_tools-19.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 v17.0.0 =====\x1b[0m')
+    print(f'\x1b[1;36m===== EVOLVER Tools v19.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-19.0.0/src/evolver_tools/vendor/base32.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""base32 — Base32 encoding/decoding tool.
+
+Usage: base32 encode "hello"
+       base32 decode "NBSWY3DP"
+       echo "hello" | base32 encode
+
+Zero-dependency (stdlib only).
+"""
+
+import sys
+import base64
+
+
+def main():
+    args = sys.argv[1:]
+
+    mode = 'encode'
+    for a in args[:]:
+        if a in ('encode', '--encode', '-e'):
+            mode = 'encode'
+            args.remove(a)
+        elif a in ('decode', '--decode', '-d'):
+            mode = 'decode'
+            args.remove(a)
+        elif a in ('-h', '--help'):
+            print(__doc__)
+            return
+
+    text_args = [a for a in args if not a.startswith('-')]
+
+    if text_args:
+        text = ' '.join(text_args)
+    elif not sys.stdin.isatty():
+        text = sys.stdin.read().strip()
+    else:
+        print("Usage: base32 (encode|decode) [text]")
+        print("       echo <text> | base32 encode")
+        return
+
+    if mode == 'encode':
+        encoded = base64.b32encode(text.encode()).decode()
+        print(encoded)
+    else:
+        try:
+            decoded = base64.b32decode(text.upper().encode()).decode()
+            print(decoded)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "base32",
+    "func": "main",
+    "desc": 'Base32 encode/decode (stdin or arg)',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/cowsay.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3
+"""cowsay — ASCII cow saying text.
+
+Usage: cowsay "Hello World"
+       echo "Hello" | cowsay
+       cowsay -l                    # list all animals
+       cowsay -f tux "Hello"       # use tux (penguin)
+
+Supports multiple animals: cow, tux, dragon, bunny, cheese, daemon
+Zero-dependency (stdlib only).
+"""
+
+import sys
+
+ANIMALS = {}
+
+# Cow
+ANIMALS['cow'] = r"""
+        \   ^__^
+         \  (oo)\_______
+            (__)\       )\/\
+                ||----w |
+                ||     ||
+"""
+
+ANIMALS['tux'] = r"""
+        \   
+         \   
+            .--.
+           |o_o |
+           |:_/ |
+          //   \ \
+         (|     | )
+        /'\_   _/`\
+        \___)=(___/
+"""
+
+ANIMALS['dragon'] = r"""
+        \                    / \  //\
+         \    |\___/|      /   \//  \
+              /0  0  \__  /    //  | \ \    
+             /     /  \/_/    //   |  \  \  
+             @_^_@'/   \/_   //    |   \   \ 
+             //_^_/     \/_ //     |    \    \
+          ( //) |        \///      |     \     \
+        ( / /) _|_ /   )  //       |      \     _\
+      ( // /) '/,_ _ _/  ( ; -.    |    _ _\.-~        .-~~~^-.
+    (( / / )) ,-{        _      `-.|.-~-.           .~         `.
+   (( // / ))  '/\      /                 ~-. _ .-~      .-~^-.  \
+   (( /// ))      `.   {            }                   /      \  \
+      (( / ))     .----~-.\        \-'                 .~         \  `. \^-.
+                 ///.----..>        \             _ -~             `.  ^-`  ^-_
+                   ///-._ _ _ _ _ _ _}^ - - - -~                     `-~ _-~^
+"""
+
+ANIMALS['bunny'] = r"""
+        \   (
+         \   )
+            __(
+           /  |
+          /  /|
+         /  / |
+        (  (  |
+         \  \ |
+          \  \|
+           \  \
+            \  \
+             \  \_
+              \__,_)
+"""
+
+ANIMALS['cheese'] = r"""
+        \
+         \  ╔═══════════════╗
+           ║  (•_•)        ║
+           ║  <) )╯        ║
+           ║   / \          ║
+           ╚═══════════════╝
+"""
+
+ANIMALS['daemon'] = r"""
+        \   
+         \   
+            \/\/
+            |\/
+            /\
+           / _\
+          / /  \
+         /_/    \__
+         \_\    /_/
+          \_\  /_/
+           \/_\/_/
+            \/_/
+"""
+
+
+def make_speech(text, animal='cow'):
+    lines = text.split('\n')
+    max_len = max(len(l) for l in lines) if lines else 0
+    width = min(max_len + 2, 60)
+
+    if len(lines) == 1:
+        speech = f"< {text} >"
+    else:
+        speech = []
+        speech.append(f" {'_' * width}")
+        for i, line in enumerate(lines):
+            if i == 0:
+                speech.append(f"/ {' ' * (width - 2)} \\" if max_len < width else f"/ {line:<{width-2}} \\")
+            elif i == len(lines) - 1:
+                speech.append(f"\\ {line:<{width-2}} /")
+            else:
+                speech.append(f"| {line:<{width-2}} |")
+        speech.append(f" -{'-' * width}")
+        speech = '\n'.join(speech)
+
+    art = ANIMALS.get(animal, ANIMALS['cow'])
+    return f"{speech}\n{art}"
+
+
+def main():
+    args = sys.argv[1:]
+    animal = 'cow'
+
+    filtered = []
+    i = 0
+    while i < len(args):
+        if args[i] == '-f' and i + 1 < len(args):
+            animal = args[i + 1].lower()
+            i += 2
+        elif args[i] == '-l':
+            print("Available animals:", ', '.join(sorted(ANIMALS.keys())))
+            return
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            filtered.append(args[i])
+            i += 1
+
+    if filtered:
+        text = ' '.join(filtered)
+    elif not sys.stdin.isatty():
+        text = sys.stdin.read().strip()
+    else:
+        print("Usage: cowsay <text> or echo <text> | cowsay [-f animal]")
+        print("       cowsay -l    (list animals)")
+        return
+
+    if animal not in ANIMALS:
+        print(f"Unknown animal: {animal}. Use -l to list.", file=sys.stderr)
+        sys.exit(1)
+
+    print(make_speech(text, animal))
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "cowsay",
+    "func": "main",
+    "desc": 'ASCII cow saying text (cow/tux/dragon/bunny)',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/epoch.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+"""epoch — Unix timestamp / human date converter.
+
+Usage: epoch                     # -> current Unix time
+       epoch now                 # -> current date
+       epoch 1717171717          # -> human-readable
+       epoch "2026-06-01 12:00"  # -> Unix timestamp
+       epoch --utc               # UTC mode
+
+Supports various input formats including ISO 8601.
+Zero-dependency (stdlib only).
+"""
+
+import sys
+from datetime import datetime, timezone
+
+
+def parse_date(text):
+    """Try to parse a date string, return datetime or None."""
+    formats = [
+        '%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 %H:%M:%S',
+        '%m/%d/%Y %H:%M',
+        '%m/%d/%Y',
+    ]
+    for fmt in formats:
+        try:
+            return datetime.strptime(text, fmt)
+        except ValueError:
+            continue
+    return None
+
+
+def main():
+    args = sys.argv[1:]
+    utc_mode = '-u' in args or '--utc' in args
+    args = [a for a in args if a not in ('-u', '--utc')]
+
+    if '-h' in args or '--help' in args:
+        print(__doc__)
+        return
+
+    if not args or args[0] == 'now':
+        now = datetime.now(timezone.utc if utc_mode else None)
+        ts = int(now.timestamp())
+        if not args:
+            print(ts)
+        else:
+            print(f"Unix:    {ts}")
+            print(f"Local:   {now.strftime('%Y-%m-%d %H:%M:%S')}")
+            print(f"UTC:     {datetime.fromtimestamp(ts, tz=timezone.utc).strftime('%Y-%m-%d %H:%M:%S')}")
+        return
+
+    text = ' '.join(args)
+
+    # Try as Unix timestamp
+    try:
+        ts = int(text)
+        dt_local = datetime.fromtimestamp(ts)
+        dt_utc = datetime.fromtimestamp(ts, tz=timezone.utc)
+        print(f"Unix:    {ts}")
+        print(f"Local:   {dt_local.strftime('%Y-%m-%d %H:%M:%S')}")
+        print(f"UTC:     {dt_utc.strftime('%Y-%m-%d %H:%M:%S')}")
+        return
+    except ValueError:
+        pass
+
+    # Try as date string
+    dt = parse_date(text)
+    if dt:
+        ts = int(dt.replace(tzinfo=timezone.utc).timestamp())
+        print(f"Date:    {dt.strftime('%Y-%m-%d %H:%M:%S')}")
+        print(f"Unix:    {ts}")
+        return
+
+    print(f"Error: cannot parse '{text}'", file=sys.stderr)
+    sys.exit(1)
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "epoch",
+    "func": "main",
+    "desc": 'Unix timestamp / human date converter',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/factor.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""factor — Prime factorization of integers.
+
+Usage: factor 123
+       factor 12 15 21
+       echo "100" | factor
+
+Like standard Unix 'factor' command.
+Zero-dependency (stdlib only).
+"""
+
+import sys
+import math
+
+
+def factorize(n):
+    """Return list of prime factors for n."""
+    n = int(n)
+    if n < 2:
+        return []
+    factors = []
+    d = 2
+    while d * d <= n:
+        while n % d == 0:
+            factors.append(d)
+            n //= d
+        d += 1 if d == 2 else 2  # skip evens after 2
+    if n > 1:
+        factors.append(n)
+    return factors
+
+
+def main():
+    args = sys.argv[1:]
+
+    if '-h' in args or '--help' in args:
+        print(__doc__)
+        return
+
+    numbers = []
+
+    if args:
+        for a in args:
+            try:
+                numbers.append(int(a))
+            except ValueError:
+                pass
+    elif not sys.stdin.isatty():
+        data = sys.stdin.read().strip()
+        for token in data.split():
+            try:
+                numbers.append(int(token))
+            except ValueError:
+                pass
+
+    if not numbers:
+        print("Usage: factor <number> [number...]")
+        print("       echo <number> | factor")
+        return
+
+    for n in numbers:
+        if n < 2:
+            print(f"{n}: {n}")
+        else:
+            factors = factorize(n)
+            if len(factors) == 1:
+                print(f"{n}: {n}")
+            else:
+                print(f"{n}: {' '.join(str(f) for f in factors)}")
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "factor",
+    "func": "main",
+    "desc": 'Prime factorization of integers',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/hexdump.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+"""hexdump — Hex dump with ASCII view.
+
+Usage: hexdump <file>
+       echo "hello" | hexdump [--length N]
+
+Shows offset, hex bytes, and ASCII representation.
+Zero-dependency (stdlib only).
+"""
+
+import sys
+import os
+
+
+def hexdump(data, length=16):
+    result = []
+    for i in range(0, len(data), length):
+        chunk = data[i:i + length]
+        hex_part = ' '.join(f'{b:02x}' for b in chunk)
+        # Pad hex part if needed
+        hex_part = hex_part.ljust(length * 3 - 1)
+        ascii_part = ''.join(chr(b) if 32 <= b < 127 else '.' for b in chunk)
+        result.append(f'{i:08x}  {hex_part}  |{ascii_part}|')
+    return '\n'.join(result)
+
+
+def main():
+    args = sys.argv[1:]
+    show_len = 16
+
+    for a in args[:]:
+        if a == '--length' and len(args) > args.index(a) + 1:
+            idx = args.index(a)
+            show_len = int(args[idx + 1])
+            args.remove(a)
+            args.pop(idx)  # remove the value too... but index shifted
+        elif a.startswith('--length='):
+            show_len = int(a.split('=', 1)[1])
+            args.remove(a)
+        elif a in ('-h', '--help'):
+            print(__doc__)
+            return
+
+    # Re-parse length properly
+    args = sys.argv[1:]
+    filtered = []
+    i = 0
+    while i < len(args):
+        if args[i] == '--length' and i + 1 < len(args):
+            show_len = int(args[i + 1])
+            i += 2
+        elif args[i].startswith('--length='):
+            show_len = int(args[i].split('=', 1)[1])
+            i += 1
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            filtered.append(args[i])
+            i += 1
+
+    if filtered:
+        path = filtered[0]
+        if not os.path.isfile(path):
+            print(f"Error: file not found: {path}", file=sys.stderr)
+            sys.exit(1)
+        with open(path, 'rb') as f:
+            data = f.read()
+        print(hexdump(data, show_len))
+    elif not sys.stdin.isatty():
+        data = sys.stdin.buffer.read()
+        print(hexdump(data, show_len))
+    else:
+        print("Usage: hexdump <file>")
+        print("       cat <file> | hexdump")
+        return
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "hexdump",
+    "func": "main",
+    "desc": 'Hex dump with ASCII view (file or stdin)',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/nl.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+"""nl — Number lines of files or stdin.
+
+Usage: nl <file>
+       cat <file> | nl [-ba]  # -a=number all, -b=number non-empty
+       nl -s '. ' input.txt   # custom separator
+
+Like standard Unix 'nl' command.
+Zero-dependency (stdlib only).
+"""
+
+import sys
+
+
+def main():
+    args = sys.argv[1:]
+    style = 't'  # t = non-empty only, a = all, n = none
+    separator = '  '
+    start_num = 1
+
+    filtered = []
+    i = 0
+    while i < len(args):
+        if args[i] == '-ba':
+            style = 'a'
+            i += 1
+        elif args[i] == '-bt':
+            style = 't'
+            i += 1
+        elif args[i] == '-bn':
+            style = 'n'
+            i += 1
+        elif args[i] == '-s' and i + 1 < len(args):
+            separator = args[i + 1]
+            i += 2
+        elif args[i].startswith('-s'):
+            separator = args[i][2:]
+            i += 1
+        elif args[i] == '-v' and i + 1 < len(args):
+            start_num = int(args[i + 1])
+            i += 2
+        elif args[i] in ('-h', '--help'):
+            print(__doc__)
+            return
+        else:
+            filtered.append(args[i])
+            i += 1
+
+    if filtered:
+        for path in filtered:
+            try:
+                with open(path) as f:
+                    lines = f.readlines()
+            except FileNotFoundError:
+                print(f"Error: file not found: {path}", file=sys.stderr)
+                continue
+            lineno = start_num
+            for line in lines:
+                numbered = False
+                if style == 'a' or (style == 't' and line.strip()):
+                    print(f'{lineno:>6}{separator}{line}', end='')
+                    lineno += 1
+                    numbered = True
+                if not numbered:
+                    print(f'       {separator}{line}', end='')
+    elif not sys.stdin.isatty():
+        lines = sys.stdin.readlines()
+        lineno = start_num
+        for line in lines:
+            numbered = False
+            if style == 'a' or (style == 't' and line.strip()):
+                print(f'{lineno:>6}{separator}{line}', end='')
+                lineno += 1
+                numbered = True
+            if not numbered:
+                print(f'       {separator}{line}', end='')
+    else:
+        print("Usage: nl <file> or cat <file> | nl")
+        return
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "nl",
+    "func": "main",
+    "desc": 'Number lines of files or stdin',
+}
+
+if __name__ == '__main__':
+    main()

evolver_tools-19.0.0/src/evolver_tools/vendor/rot13.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+"""rot13 — ROT13/ROT47 text cipher.
+
+Usage: rot13 "Hello World"
+       echo "Hello" | rot13 [--rot47]
+       rot13 --rot47 "p6xx2F5H~"
+
+Applies ROT13 (default) or ROT47 cipher.
+Zero-dependency (stdlib only).
+"""
+
+import sys
+
+ROT13_TRANS = str.maketrans(
+    'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz',
+    'NOPQRSTUVWXYZABCDEFGHIJKLMnopqrstuvwxyzabcdefghijklm'
+)
+
+
+def rot13(text):
+    return text.translate(ROT13_TRANS)
+
+
+def rot47(text):
+    result = []
+    for c in text:
+        o = ord(c)
+        if 33 <= o <= 126:
+            result.append(chr(33 + ((o - 33 + 47) % 94)))
+        else:
+            result.append(c)
+    return ''.join(result)
+
+
+def main():
+    args = sys.argv[1:]
+    use_rot47 = False
+
+    for a in args[:]:
+        if a in ('--rot47', '-7'):
+            use_rot47 = True
+            args.remove(a)
+        elif a in ('-h', '--help'):
+            print(__doc__)
+            return
+
+    text_args = [a for a in args if not a.startswith('-')]
+
+    if text_args:
+        text = ' '.join(text_args)
+    elif not sys.stdin.isatty():
+        text = sys.stdin.read().strip()
+    else:
+        print("Usage: rot13 <text> or echo <text> | rot13 [--rot47]")
+        return
+
+    if use_rot47:
+        print(rot47(text))
+    else:
+        print(rot13(text))
+
+
+# === Auto-registration metadata ===
+TOOL_META = {
+    "name": "rot13",
+    "func": "main",
+    "desc": 'ROT13/ROT47 text cipher (stdin or arg)',
+}
+
+if __name__ == '__main__':
+    main()