evolver-tools 31.0.0__tar.gz → 32.0.0__tar.gz

{evolver_tools-31.0.0/src/evolver_tools.egg-info → evolver_tools-32.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: evolver-tools
-Version: 31.0.0
-Summary: 238 CLI tools + 9 flagship projects — one pip install
+Version: 32.0.0
+Summary: 234 CLI tools + 9 flagship projects — one pip install
 Author: EVOLVER
 License-Expression: MIT
 Project-URL: Homepage, https://evolver-dev.github.io/evolver-tools
@@ -22,11 +22,11 @@ Dynamic: license-file
 
 # EVOLVER Tools
 
-**233+ CLI tools + 9 flagship projects — one `pip install`.**
+**238 CLI tools + 9 flagship projects — one `pip install`.**
 
-Zero-dependency (230/233), cross-platform, production-ready. Version **30.0.0**.
+Zero-dependency (235/238), cross-platform, production-ready. Version **31.0.0**.
 Systems ops, data processing, text manipulation, security, dev tooling, and creative utilities.
-All in a single install — not 233 separate packages.
+All in a single install — not 238 separate packages.
 
 ## Quick Start
 

{evolver_tools-31.0.0 → evolver_tools-32.0.0}/README.md

@@ -1,10 +1,10 @@
 # EVOLVER Tools
 
-**233+ CLI tools + 9 flagship projects — one `pip install`.**
+**238 CLI tools + 9 flagship projects — one `pip install`.**
 
-Zero-dependency (230/233), cross-platform, production-ready. Version **30.0.0**.
+Zero-dependency (235/238), cross-platform, production-ready. Version **31.0.0**.
 Systems ops, data processing, text manipulation, security, dev tooling, and creative utilities.
-All in a single install — not 233 separate packages.
+All in a single install — not 238 separate packages.
 
 ## Quick Start
 

{evolver_tools-31.0.0 → evolver_tools-32.0.0}/pyproject.toml

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

evolver_tools-32.0.0/src/evolver_tools/vendor/csv_head.py

@@ -0,0 +1,234 @@
+#!/usr/bin/env python3
+"""csv-head — Display first N rows of a CSV file.
+
+Usage: csv-head data.csv
+       csv-head data.csv -n 20
+       csv-head data.csv --columns name,email
+       csv-head data.csv --format table
+       cat data.csv | csv-head -n 5
+
+Options:
+  -n, --lines N         Number of rows to show (default: 10)
+  -c, --columns NAMES   Comma-separated column names to show
+  -f, --format FMT      Output format: csv (default) or table
+  --no-header           Input has no header row
+  -h, --help            Show this help message
+"""
+
+import csv
+import io
+import os
+import sys
+
+TOOL_META = {
+    "name": "csv-head",
+    "func": "main",
+    "desc": "Display first N rows of a CSV file",
+}
+
+
+def read_input(filepath=None):
+    """Read CSV data from file or stdin. Returns (content, source_name)."""
+    if filepath:
+        if not os.path.isfile(filepath):
+            print(f"Error: file not found: {filepath}", file=sys.stderr)
+            sys.exit(1)
+        try:
+            with open(filepath, "r", encoding="utf-8", errors="replace") as f:
+                content = f.read()
+        except Exception as e:
+            print(f"Error reading file: {e}", file=sys.stderr)
+            sys.exit(1)
+        return content, filepath
+    else:
+        try:
+            content = sys.stdin.read()
+        except KeyboardInterrupt:
+            sys.exit(1)
+        if not content.strip():
+            print("(no input)", file=sys.stderr)
+            sys.exit(1)
+        return content, "<stdin>"
+
+
+def parse_csv(content):
+    """Parse CSV content into list of rows using csv.reader."""
+    reader = csv.reader(io.StringIO(content))
+    return [row for row in reader]
+
+
+def filter_columns(rows, column_names, has_header):
+    """Filter rows to only include specified columns.
+
+    column_names is a list of column names (if has_header) or column indices.
+    """
+    if not rows or not column_names:
+        return rows
+
+    if has_header:
+        header = rows[0]
+        indices = []
+        for name in column_names:
+            name = name.strip()
+            found = False
+            for i, h in enumerate(header):
+                if h.strip() == name:
+                    indices.append(i)
+                    found = True
+                    break
+            if not found:
+                print(f"Error: column '{name}' not found in header", file=sys.stderr)
+                sys.exit(1)
+    else:
+        # No header — column_names are 1-based indices
+        indices = []
+        for name in column_names:
+            name = name.strip()
+            try:
+                idx = int(name) - 1
+                if idx < 0:
+                    print(f"Error: column index must be >= 1, got {name}", file=sys.stderr)
+                    sys.exit(1)
+                indices.append(idx)
+            except ValueError:
+                print(f"Error: without --no-header, column names must be integers, got '{name}'", file=sys.stderr)
+                sys.exit(1)
+
+    filtered = []
+    for row in rows:
+        new_row = [row[i] if i < len(row) else "" for i in indices]
+        filtered.append(new_row)
+
+    return filtered
+
+
+def format_csv(rows):
+    """Output rows as CSV."""
+    writer = csv.writer(sys.stdout)
+    for row in rows:
+        writer.writerow(row)
+
+
+def format_table(rows):
+    """Output rows as an aligned table."""
+    if not rows:
+        return
+
+    num_cols = max(len(row) for row in rows) if rows else 0
+    if num_cols == 0:
+        return
+
+    col_widths = [0] * num_cols
+    for row in rows:
+        for i, cell in enumerate(row):
+            if i < num_cols:
+                col_widths[i] = max(col_widths[i], len(cell))
+
+    for row in rows:
+        parts = []
+        for i in range(num_cols):
+            val = row[i] if i < len(row) else ""
+            parts.append(val.ljust(col_widths[i]))
+        print("  ".join(parts))
+
+
+def print_usage():
+    """Print usage information."""
+    print(__doc__.strip())
+
+
+def main():
+    args = sys.argv[1:]
+
+    filepath = None
+    lines = 10
+    column_names = None
+    output_format = "csv"
+    has_header = True
+
+    i = 0
+    while i < len(args):
+        arg = args[i]
+        if arg in ("-h", "--help"):
+            print_usage()
+            return
+        elif arg in ("-n", "--lines") and i + 1 < len(args):
+            try:
+                lines = int(args[i + 1])
+                if lines < 0:
+                    print("Error: --lines/-n requires a non-negative integer", file=sys.stderr)
+                    sys.exit(1)
+            except ValueError:
+                print("Error: --lines/-n requires an integer", file=sys.stderr)
+                sys.exit(1)
+            i += 2
+        elif arg in ("-c", "--columns") and i + 1 < len(args):
+            column_names = [c.strip() for c in args[i + 1].split(",")]
+            i += 2
+        elif arg in ("-f", "--format") and i + 1 < len(args):
+            fmt = args[i + 1].lower()
+            if fmt not in ("csv", "table"):
+                print(f"Error: --format/-f must be 'csv' or 'table', got '{fmt}'", file=sys.stderr)
+                sys.exit(1)
+            output_format = fmt
+            i += 2
+        elif arg == "--no-header":
+            has_header = False
+            i += 1
+        elif arg.startswith("-"):
+            print(f"Error: unknown option '{arg}'. Use --help for usage.", file=sys.stderr)
+            sys.exit(1)
+        else:
+            if filepath is not None:
+                print(f"Error: unexpected argument '{arg}'. Only one file path allowed.", file=sys.stderr)
+                sys.exit(1)
+            filepath = arg
+            i += 1
+
+    # Read input
+    content, source_name = read_input(filepath)
+
+    if not content.strip():
+        print("(empty file)")
+        sys.exit(0)
+
+    # Parse CSV
+    rows = parse_csv(content)
+
+    if not rows:
+        print("(no data)")
+        sys.exit(0)
+
+    total_rows = len(rows)
+
+    # Determine data rows based on header
+    if has_header and total_rows > 0:
+        header = rows[0]
+        data_rows = rows[1:]
+    else:
+        header = None
+        data_rows = rows
+
+    # Slice first N data rows
+    if lines > 0 and lines < len(data_rows):
+        data_rows = data_rows[:lines]
+
+    # Reconstruct rows with optional header
+    if header is not None:
+        display_rows = [header] + data_rows
+    else:
+        display_rows = data_rows
+
+    # Filter columns if requested
+    if column_names:
+        display_rows = filter_columns(display_rows, column_names, has_header)
+
+    # Output
+    if output_format == "csv":
+        format_csv(display_rows)
+    else:
+        format_table(display_rows)
+
+
+if __name__ == "__main__":
+    main()

evolver_tools-32.0.0/src/evolver_tools/vendor/csv_sort.py

@@ -0,0 +1,125 @@
+#!/usr/bin/env python3
+"""
+csv-sort — Sort CSV files by column.
+
+Usage:
+    csv-sort [--column COL] [--reverse] [--numeric] [FILE]
+
+Arguments:
+    FILE                  Input CSV file (reads from stdin if omitted)
+
+Options:
+    -c, --column COL      Column name or 1-based index to sort by (default: first column)
+    -r, --reverse         Sort in descending order
+    -n, --numeric         Sort values as numbers instead of text
+    -h, --help            Show this help message and exit
+
+Examples:
+    csv-sort data.csv
+    csv-sort -c 2 -r data.csv
+    csv-sort -c "name" -n < data.csv
+    cat data.csv | csv-sort -c "age" -n -r
+"""
+
+import csv
+import sys
+
+
+def main():
+    args = sys.argv[1:]
+
+    # Parse help
+    if '-h' in args or '--help' in args:
+        print((__doc__ or '').strip())
+        return
+
+    # Parse --column / -c
+    column = None
+    if '--column' in args:
+        idx = args.index('--column')
+        if idx + 1 < len(args):
+            column = args[idx + 1]
+            args = args[:idx] + args[idx + 2:]
+    elif '-c' in args:
+        idx = args.index('-c')
+        if idx + 1 < len(args):
+            column = args[idx + 1]
+            args = args[:idx] + args[idx + 2:]
+
+    # Parse flags
+    reverse = '--reverse' in args or '-r' in args
+    numeric = '--numeric' in args or '-n' in args
+    args = [a for a in args if a not in ('--reverse', '-r', '--numeric', '-n')]
+
+    # Remaining positional arg is file path (optional)
+    filepath = args[0] if args else None
+
+    try:
+        if filepath:
+            with open(filepath, newline='') as f:
+                reader = csv.reader(f)
+                rows = list(reader)
+        else:
+            reader = csv.reader(sys.stdin)
+            rows = list(reader)
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if not rows:
+        sys.exit(0)
+
+    # Separate header from data
+    header = rows[0]
+    data = rows[1:]
+
+    # Determine column index
+    if column is None:
+        col_idx = 0
+    else:
+        try:
+            col_idx = int(column) - 1  # 1-based to 0-based
+        except ValueError:
+            # Column is a name — find it in the header
+            try:
+                col_idx = header.index(column)
+            except ValueError:
+                print(f"Error: column '{column}' not found in header: {header}", file=sys.stderr)
+                sys.exit(1)
+
+    if col_idx < 0:
+        print(f"Error: column index must be 1 or greater", file=sys.stderr)
+        sys.exit(1)
+
+    # Sort
+    try:
+        if numeric:
+            data.sort(key=lambda row: _safe_num(row[col_idx]), reverse=reverse)
+        else:
+            data.sort(key=lambda row: row[col_idx] if col_idx < len(row) else '', reverse=reverse)
+    except IndexError:
+        print(f"Error: column index {col_idx + 1} exceeds row width", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Error during sort: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # Write output
+    writer = csv.writer(sys.stdout)
+    writer.writerow(header)
+    writer.writerows(data)
+
+
+def _safe_num(val):
+    """Convert a string to float for numeric sorting, with fallback."""
+    try:
+        return float(val)
+    except (ValueError, TypeError):
+        return float('inf')
+
+
+TOOL_META = {"name": "csv-sort", "func": "main", "desc": "Sort CSV files by column"}
+
+
+if __name__ == '__main__':
+    main()