spark: add text_stats.py utility for counting lines/words/chars in text files

wizard-work/spark/text_stats.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+"""
+text_stats.py - Quick utility to count lines, words, and characters in text files.
+Usage: python text_stats.py <file1> [file2] ...
+"""
+import sys
+
+def analyze_text(filepath):
+    """Return (lines, words, chars) for a text file."""
+    try:
+        with open(filepath, 'r', encoding='utf-8', errors='replace') as f:
+            content = f.read()
+        lines = len(content.splitlines())
+        words = len(content.split())
+        chars = len(content)
+        return lines, words, chars
+    except Exception as e:
+        return None, None, None
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: python text_stats.py <file1> [file2] ...")
+        sys.exit(1)
+
+    for filepath in sys.argv[1:]:
+        lines, words, chars = analyze_text(filepath)
+        if lines is None:
+            print(f"{filepath}: error reading file")
+            continue
+        print(f"{filepath}: {lines} lines, {words} words, {chars} chars")
+
+if __name__ == '__main__':
+    main()