| """
|
| Repository Tech-Stack Scanner
|
| ===============================
|
| Scans a repository and produces a Markdown table of file types with counts
|
| and total sizes in KB. Supports every file extension in existence.
|
|
|
| Usage:
|
| python scan_techstack.py [path] [--output FILE] [--ignore PATTERN ...]
|
| [--exclude-ext EXT ...] [--sort count|size|ext]
|
|
|
| Output:
|
| A Markdown file containing the tech-stack audit table.
|
| """
|
|
|
| import os
|
| import sys
|
| import argparse
|
| from pathlib import Path
|
| from collections import defaultdict
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| EXT_LABELS: dict[str, str] = {
|
|
|
| ".py": "Python",
|
| ".pyw": "Python (windowed)",
|
| ".pyx": "Cython",
|
| ".pxd": "Cython Definition",
|
| ".pyi": "Python Stub",
|
| ".pyc": "Python Compiled",
|
| ".pyo": "Python Optimized",
|
| ".js": "JavaScript",
|
| ".mjs": "ES Module JavaScript",
|
| ".cjs": "CommonJS JavaScript",
|
| ".jsx": "JSX (React)",
|
| ".ts": "TypeScript",
|
| ".tsx": "TSX (React)",
|
| ".java": "Java",
|
| ".class": "Java Class",
|
| ".jar": "Java Archive",
|
| ".kt": "Kotlin",
|
| ".kts": "Kotlin Script",
|
| ".scala": "Scala",
|
| ".groovy": "Groovy",
|
| ".c": "C",
|
| ".h": "C Header",
|
| ".cpp": "C++",
|
| ".cxx": "C++",
|
| ".cc": "C++",
|
| ".c++": "C++",
|
| ".hpp": "C++ Header",
|
| ".hxx": "C++ Header",
|
| ".hh": "C++ Header",
|
| ".h++": "C++ Header",
|
| ".cs": "C#",
|
| ".csx": "C# Script",
|
| ".fs": "F#",
|
| ".fsx": "F# Script",
|
| ".fsi": "F# Signature",
|
| ".vb": "Visual Basic",
|
| ".vbs": "VBScript",
|
| ".go": "Go",
|
| ".rs": "Rust",
|
| ".rb": "Ruby",
|
| ".erb": "Embedded Ruby",
|
| ".php": "PHP",
|
| ".pl": "Perl",
|
| ".pm": "Perl Module",
|
| ".lua": "Lua",
|
| ".r": "R",
|
| ".rmd": "R Markdown",
|
| ".swift": "Swift",
|
| ".m": "Objective-C / MATLAB",
|
| ".mm": "Objective-C++",
|
| ".d": "D",
|
| ".dart": "Dart",
|
| ".ex": "Elixir",
|
| ".exs": "Elixir Script",
|
| ".erl": "Erlang",
|
| ".hrl": "Erlang Header",
|
| ".hs": "Haskell",
|
| ".lhs": "Literate Haskell",
|
| ".ml": "OCaml",
|
| ".mli": "OCaml Interface",
|
| ".clj": "Clojure",
|
| ".cljs": "ClojureScript",
|
| ".cljc": "Clojure Common",
|
| ".edn": "EDN (Clojure)",
|
| ".lisp": "Common Lisp",
|
| ".cl": "Common Lisp",
|
| ".el": "Emacs Lisp",
|
| ".scm": "Scheme",
|
| ".rkt": "Racket",
|
| ".nim": "Nim",
|
| ".zig": "Zig",
|
| ".v": "V / Verilog",
|
| ".vhd": "VHDL",
|
| ".vhdl": "VHDL",
|
| ".sv": "SystemVerilog",
|
| ".asm": "Assembly",
|
| ".s": "Assembly",
|
| ".f": "Fortran",
|
| ".f90": "Fortran 90",
|
| ".f95": "Fortran 95",
|
| ".f03": "Fortran 2003",
|
| ".f08": "Fortran 2008",
|
| ".for": "Fortran",
|
| ".cob": "COBOL",
|
| ".cbl": "COBOL",
|
| ".pas": "Pascal",
|
| ".pp": "Pascal",
|
| ".ada": "Ada",
|
| ".adb": "Ada Body",
|
| ".ads": "Ada Spec",
|
| ".tcl": "Tcl",
|
| ".tk": "Tcl/Tk",
|
| ".awk": "AWK",
|
| ".sed": "sed",
|
| ".jl": "Julia",
|
| ".cr": "Crystal",
|
| ".hack": "Hack",
|
| ".hx": "Haxe",
|
| ".hxml": "Haxe XML",
|
| ".purs": "PureScript",
|
| ".idr": "Idris",
|
| ".agda": "Agda",
|
| ".lean": "Lean",
|
| ".coq": "Coq",
|
| ".thy": "Isabelle",
|
| ".pro": "Prolog",
|
| ".sml": "Standard ML",
|
| ".fig": "MATLAB Figure",
|
| ".mat": "MATLAB Data",
|
|
|
|
|
| ".sh": "Shell Script",
|
| ".bash": "Bash Script",
|
| ".zsh": "Zsh Script",
|
| ".fish": "Fish Script",
|
| ".bat": "Batch File",
|
| ".cmd": "Windows Command",
|
| ".ps1": "PowerShell",
|
| ".psm1": "PowerShell Module",
|
| ".psd1": "PowerShell Data",
|
|
|
|
|
| ".html": "HTML",
|
| ".htm": "HTML",
|
| ".xhtml": "XHTML",
|
| ".css": "CSS",
|
| ".scss": "SCSS",
|
| ".sass": "Sass",
|
| ".less": "Less",
|
| ".styl": "Stylus",
|
| ".vue": "Vue",
|
| ".svelte": "Svelte",
|
| ".astro": "Astro",
|
| ".ejs": "EJS Template",
|
| ".pug": "Pug Template",
|
| ".jade": "Jade Template",
|
| ".hbs": "Handlebars",
|
| ".mustache": "Mustache",
|
| ".twig": "Twig Template",
|
| ".jinja": "Jinja Template",
|
| ".jinja2": "Jinja2 Template",
|
| ".j2": "Jinja2 Template",
|
| ".njk": "Nunjucks Template",
|
| ".liquid": "Liquid Template",
|
| ".haml": "HAML",
|
| ".slim": "Slim Template",
|
| ".blade.php":"Blade Template",
|
| ".jsp": "JavaServer Pages",
|
| ".asp": "ASP",
|
| ".aspx": "ASP.NET",
|
| ".cshtml": "Razor (C#)",
|
| ".razor": "Razor",
|
| ".wasm": "WebAssembly",
|
|
|
|
|
| ".json": "JSON",
|
| ".jsonl": "JSON Lines",
|
| ".json5": "JSON5",
|
| ".geojson": "GeoJSON",
|
| ".xml": "XML",
|
| ".xsl": "XSLT",
|
| ".xslt": "XSLT",
|
| ".xsd": "XML Schema",
|
| ".dtd": "Document Type Definition",
|
| ".yaml": "YAML",
|
| ".yml": "YAML",
|
| ".toml": "TOML",
|
| ".ini": "INI Config",
|
| ".cfg": "Config",
|
| ".conf": "Config",
|
| ".env": "Environment File",
|
| ".properties": "Properties File",
|
| ".csv": "CSV",
|
| ".tsv": "TSV",
|
| ".parquet": "Apache Parquet",
|
| ".avro": "Apache Avro",
|
| ".orc": "Apache ORC",
|
| ".feather": "Feather (Arrow)",
|
| ".arrow": "Apache Arrow",
|
| ".msgpack": "MessagePack",
|
| ".bson": "BSON",
|
| ".cbor": "CBOR",
|
| ".protobuf": "Protocol Buffer",
|
| ".proto": "Protocol Buffer Schema",
|
| ".thrift": "Apache Thrift",
|
| ".hcl": "HCL (Terraform)",
|
| ".tf": "Terraform",
|
| ".tfvars": "Terraform Variables",
|
| ".pkl": "Pickle",
|
| ".pickle": "Pickle",
|
| ".npy": "NumPy Array",
|
| ".npz": "NumPy Archive",
|
| ".h5": "HDF5",
|
| ".hdf5": "HDF5",
|
| ".nc": "NetCDF",
|
| ".sqlite": "SQLite Database",
|
| ".sqlite3": "SQLite Database",
|
| ".db": "Database",
|
| ".dbf": "dBASE",
|
| ".mdb": "Access Database",
|
| ".accdb": "Access Database",
|
| ".lmdb": "LMDB",
|
| ".leveldb": "LevelDB",
|
|
|
|
|
| ".md": "Markdown",
|
| ".mdx": "MDX",
|
| ".txt": "Plain Text",
|
| ".text": "Plain Text",
|
| ".log": "Log File",
|
| ".rst": "reStructuredText",
|
| ".adoc": "AsciiDoc",
|
| ".org": "Org Mode",
|
| ".tex": "LaTeX",
|
| ".latex": "LaTeX",
|
| ".bib": "BibTeX",
|
| ".rtf": "Rich Text Format",
|
| ".doc": "Microsoft Word",
|
| ".docx": "Microsoft Word (OOXML)",
|
| ".odt": "OpenDocument Text",
|
| ".pdf": "PDF",
|
| ".xls": "Microsoft Excel",
|
| ".xlsx": "Microsoft Excel (OOXML)",
|
| ".xlsm": "Excel Macro-Enabled",
|
| ".xlsb": "Excel Binary",
|
| ".ods": "OpenDocument Spreadsheet",
|
| ".ppt": "Microsoft PowerPoint",
|
| ".pptx": "Microsoft PowerPoint (OOXML)",
|
| ".odp": "OpenDocument Presentation",
|
| ".pages": "Apple Pages",
|
| ".numbers": "Apple Numbers",
|
| ".key": "Apple Keynote",
|
| ".epub": "EPUB",
|
| ".mobi": "Mobipocket",
|
| ".djvu": "DjVu",
|
| ".chm": "Compiled HTML Help",
|
| ".man": "Man Page",
|
| ".info": "GNU Info",
|
|
|
|
|
| ".ipynb": "Jupyter Notebook",
|
| ".rmd": "R Markdown",
|
| ".qmd": "Quarto Document",
|
| ".dvc": "DVC File",
|
| ".onnx": "ONNX Model",
|
| ".pt": "PyTorch Model",
|
| ".pth": "PyTorch Checkpoint",
|
| ".safetensors": "SafeTensors Model",
|
| ".gguf": "GGUF Model",
|
| ".bin": "Binary File",
|
|
|
|
|
| ".png": "PNG Image",
|
| ".jpg": "JPEG Image",
|
| ".jpeg": "JPEG Image",
|
| ".gif": "GIF Image",
|
| ".bmp": "Bitmap Image",
|
| ".tiff": "TIFF Image",
|
| ".tif": "TIFF Image",
|
| ".webp": "WebP Image",
|
| ".avif": "AVIF Image",
|
| ".heic": "HEIC Image",
|
| ".heif": "HEIF Image",
|
| ".svg": "SVG Image",
|
| ".ico": "Icon",
|
| ".icns": "Apple Icon",
|
| ".cur": "Cursor",
|
| ".psd": "Photoshop",
|
| ".ai": "Adobe Illustrator",
|
| ".sketch": "Sketch",
|
| ".fig": "Figma",
|
| ".xd": "Adobe XD",
|
| ".eps": "EPS Vector",
|
| ".raw": "RAW Image",
|
| ".cr2": "Canon RAW",
|
| ".nef": "Nikon RAW",
|
| ".arw": "Sony RAW",
|
| ".dng": "DNG RAW",
|
| ".exr": "OpenEXR",
|
| ".hdr": "HDR Image",
|
| ".pbm": "PBM Image",
|
| ".pgm": "PGM Image",
|
| ".ppm": "PPM Image",
|
| ".pcx": "PCX Image",
|
| ".tga": "TGA Image",
|
|
|
|
|
| ".mp3": "MP3 Audio",
|
| ".wav": "WAV Audio",
|
| ".flac": "FLAC Audio",
|
| ".aac": "AAC Audio",
|
| ".ogg": "Ogg Audio",
|
| ".wma": "WMA Audio",
|
| ".m4a": "M4A Audio",
|
| ".opus": "Opus Audio",
|
| ".aiff": "AIFF Audio",
|
| ".mid": "MIDI",
|
| ".midi": "MIDI",
|
| ".amr": "AMR Audio",
|
| ".ape": "APE Audio",
|
| ".alac": "ALAC Audio",
|
|
|
|
|
| ".mp4": "MP4 Video",
|
| ".mkv": "MKV Video",
|
| ".avi": "AVI Video",
|
| ".mov": "QuickTime Video",
|
| ".wmv": "WMV Video",
|
| ".flv": "Flash Video",
|
| ".webm": "WebM Video",
|
| ".m4v": "M4V Video",
|
| ".mpg": "MPEG Video",
|
| ".mpeg": "MPEG Video",
|
| ".3gp": "3GP Video",
|
| ".ogv": "Ogg Video",
|
| ".ts": "MPEG-TS",
|
| ".vob": "DVD Video",
|
| ".rm": "RealMedia",
|
|
|
|
|
| ".ttf": "TrueType Font",
|
| ".otf": "OpenType Font",
|
| ".woff": "WOFF Font",
|
| ".woff2": "WOFF2 Font",
|
| ".eot": "EOT Font",
|
| ".fon": "Bitmap Font",
|
|
|
|
|
| ".zip": "ZIP Archive",
|
| ".gz": "Gzip Archive",
|
| ".gzip": "Gzip Archive",
|
| ".bz2": "Bzip2 Archive",
|
| ".xz": "XZ Archive",
|
| ".lz": "Lzip Archive",
|
| ".lzma": "LZMA Archive",
|
| ".zst": "Zstandard Archive",
|
| ".tar": "Tar Archive",
|
| ".tgz": "Tar+Gzip Archive",
|
| ".tbz2": "Tar+Bzip2 Archive",
|
| ".txz": "Tar+XZ Archive",
|
| ".rar": "RAR Archive",
|
| ".7z": "7-Zip Archive",
|
| ".cab": "Cabinet Archive",
|
| ".iso": "ISO Disk Image",
|
| ".dmg": "macOS Disk Image",
|
| ".img": "Disk Image",
|
| ".vhd": "Virtual Hard Disk",
|
| ".vhdx": "Virtual Hard Disk (VHDX)",
|
| ".vmdk": "VMware Disk",
|
| ".qcow2": "QEMU Disk",
|
| ".deb": "Debian Package",
|
| ".rpm": "RPM Package",
|
| ".apk": "Android Package",
|
| ".ipa": "iOS App",
|
| ".snap": "Snap Package",
|
| ".flatpak": "Flatpak Package",
|
| ".appimage": "AppImage",
|
| ".msi": "MSI Installer",
|
| ".exe": "Windows Executable",
|
| ".dll": "DLL Library",
|
| ".so": "Shared Object",
|
| ".dylib": "macOS Dynamic Library",
|
| ".a": "Static Library",
|
| ".lib": "Library",
|
| ".o": "Object File",
|
| ".obj": "Object File",
|
| ".sys": "System File",
|
| ".drv": "Driver",
|
|
|
|
|
| ".dockerfile":"Dockerfile",
|
| ".vagrantfile":"Vagrantfile",
|
| ".jenkinsfile":"Jenkinsfile",
|
|
|
|
|
| ".mq5": "MQL5 Source",
|
| ".mq4": "MQL4 Source",
|
| ".mqh": "MQL Header",
|
| ".ex5": "MQL5 Compiled",
|
| ".ex4": "MQL4 Compiled",
|
| ".set": "MT Parameter Set",
|
| ".pine": "Pine Script",
|
| ".tpl": "MT Template",
|
| ".chr": "MT Chart",
|
| ".mql": "MQL Source",
|
|
|
|
|
| ".makefile": "Makefile",
|
| ".cmake": "CMake",
|
| ".gradle": "Gradle",
|
| ".sbt": "SBT Build",
|
| ".gemspec": "Ruby Gem Spec",
|
| ".podspec": "CocoaPods Spec",
|
| ".cabal": "Cabal (Haskell)",
|
| ".csproj": "C# Project",
|
| ".fsproj": "F# Project",
|
| ".vbproj": "VB.NET Project",
|
| ".sln": "Visual Studio Solution",
|
| ".xcodeproj":"Xcode Project",
|
| ".pbxproj": "Xcode Project (PBX)",
|
| ".xcworkspace":"Xcode Workspace",
|
| ".plist": "Property List",
|
| ".lnk": "Windows Shortcut",
|
| ".url": "URL Shortcut",
|
| ".desktop": "Desktop Entry",
|
| ".reg": "Windows Registry",
|
| ".service": "Systemd Service",
|
| ".timer": "Systemd Timer",
|
| ".socket": "Systemd Socket",
|
| ".lock": "Lock File",
|
| ".patch": "Patch File",
|
| ".diff": "Diff File",
|
| ".map": "Source Map",
|
| ".whl": "Python Wheel",
|
| ".egg": "Python Egg",
|
| ".gem": "Ruby Gem",
|
| ".nupkg": "NuGet Package",
|
| ".crate": "Rust Crate",
|
|
|
|
|
| ".sql": "SQL",
|
| ".mysql": "MySQL",
|
| ".pgsql": "PostgreSQL",
|
| ".plsql": "PL/SQL",
|
|
|
|
|
| ".graphql": "GraphQL",
|
| ".gql": "GraphQL",
|
| ".swagger": "Swagger",
|
| ".openapi": "OpenAPI Spec",
|
|
|
|
|
| ".stl": "STL 3D Model",
|
| ".obj": "Wavefront OBJ",
|
| ".fbx": "FBX 3D Model",
|
| ".gltf": "glTF 3D Model",
|
| ".glb": "glTF Binary",
|
| ".blend": "Blender File",
|
| ".3ds": "3DS Model",
|
| ".dae": "Collada",
|
| ".usd": "USD Scene",
|
| ".usda": "USD ASCII",
|
| ".usdc": "USD Binary",
|
| ".step": "STEP CAD",
|
| ".stp": "STEP CAD",
|
| ".iges": "IGES CAD",
|
| ".igs": "IGES CAD",
|
| ".dwg": "AutoCAD Drawing",
|
| ".dxf": "AutoCAD Exchange",
|
| ".shp": "Shapefile",
|
| ".kml": "KML",
|
| ".kmz": "KMZ",
|
| ".gpx": "GPX Track",
|
|
|
|
|
| ".pem": "PEM Certificate",
|
| ".crt": "Certificate",
|
| ".cer": "Certificate",
|
| ".csr": "Certificate Request",
|
| ".p12": "PKCS#12",
|
| ".pfx": "PKCS#12",
|
| ".asc": "PGP/GPG",
|
| ".gpg": "GPG Encrypted",
|
| ".sig": "Signature",
|
| ".pub": "Public Key",
|
|
|
|
|
| ".gitignore": "Git Ignore",
|
| ".gitattributes": "Git Attributes",
|
| ".gitmodules": "Git Submodules",
|
|
|
|
|
| ".editorconfig": "EditorConfig",
|
| ".prettierrc": "Prettier Config",
|
| ".eslintrc": "ESLint Config",
|
| ".stylelintrc": "Stylelint Config",
|
| ".babelrc": "Babel Config",
|
| ".swcrc": "SWC Config",
|
| ".nvmrc": "NVM Config",
|
| ".npmrc": "NPM Config",
|
| ".yarnrc": "Yarn Config",
|
|
|
|
|
| ".mw5": "MQL5 Variant",
|
| ".webmanifest": "Web App Manifest",
|
| }
|
|
|
|
|
|
|
|
|
|
|
| DEFAULT_IGNORE = {
|
| ".git",
|
| "__pycache__",
|
| ".venv",
|
| "venv",
|
| "env",
|
| "node_modules",
|
| ".ipynb_checkpoints",
|
| ".mypy_cache",
|
| ".pytest_cache",
|
| ".tox",
|
| ".eggs",
|
| "*.egg-info",
|
| ".DS_Store",
|
| "Thumbs.db",
|
| "desktop.ini",
|
| }
|
|
|
|
|
| def should_ignore(name: str, ignore_set: set) -> bool:
|
| """Return True if *name* matches any pattern in the ignore set."""
|
| if name in ignore_set:
|
| return True
|
| for pattern in ignore_set:
|
| if pattern.startswith("*") and name.endswith(pattern[1:]):
|
| return True
|
| return False
|
|
|
|
|
| def get_label(ext: str) -> str:
|
| """Return the human-readable label for an extension."""
|
| if ext in EXT_LABELS:
|
| return EXT_LABELS[ext]
|
|
|
| return ext.upper().lstrip(".")
|
|
|
|
|
| def scan_files(root_path: str, ignore_set: set, exclude_exts: set) -> dict:
|
| """
|
| Walk *root_path* and collect per-extension statistics.
|
|
|
| Returns a dict keyed by normalised extension string, e.g. ".py",
|
| with values ``{"count": int, "size_bytes": int, "label": str}``.
|
|
|
| Files without an extension are grouped under "(no extension)".
|
| """
|
|
|
| stats: dict = defaultdict(lambda: {"count": 0, "size_bytes": 0, "label": ""})
|
|
|
| for dirpath, dirnames, filenames in os.walk(root_path):
|
|
|
| dirnames[:] = [
|
| d for d in dirnames if not should_ignore(d, ignore_set)
|
| ]
|
|
|
| for fname in filenames:
|
| if should_ignore(fname, ignore_set):
|
| continue
|
|
|
| filepath = os.path.join(dirpath, fname)
|
|
|
|
|
| _, ext = os.path.splitext(fname)
|
| ext = ext.lower()
|
|
|
| if ext and ext.lstrip(".") in exclude_exts:
|
| continue
|
|
|
|
|
| if ext:
|
| label = f"{get_label(ext)} ({ext})"
|
| else:
|
| ext = "(none)"
|
| label = "(no extension)"
|
|
|
| try:
|
| size = os.path.getsize(filepath)
|
| except (OSError, PermissionError):
|
| size = 0
|
|
|
| stats[ext]["count"] += 1
|
| stats[ext]["size_bytes"] += size
|
| stats[ext]["label"] = label
|
|
|
| return dict(stats)
|
|
|
|
|
| def format_size_kb(size_bytes: int) -> str:
|
| """Return exact size in KB, rounded to 1 decimal place."""
|
| kb = size_bytes / 1024
|
| if kb == 0:
|
| return "0"
|
|
|
| formatted = f"{kb:,.1f}"
|
| return formatted
|
|
|
|
|
| def build_table(stats: dict, sort_by: str) -> list[str]:
|
| """
|
| Build a Markdown table from *stats*.
|
|
|
| Returns a list of lines.
|
| """
|
|
|
|
|
| rows = []
|
| total_count = 0
|
| total_bytes = 0
|
|
|
| for ext, data in stats.items():
|
| rows.append(
|
| {
|
| "label": data["label"],
|
| "count": data["count"],
|
| "size_bytes": data["size_bytes"],
|
| "ext_key": ext,
|
| }
|
| )
|
| total_count += data["count"]
|
| total_bytes += data["size_bytes"]
|
|
|
|
|
| if sort_by == "count":
|
| rows.sort(key=lambda r: (-r["count"], r["label"].lower()))
|
| elif sort_by == "size":
|
| rows.sort(key=lambda r: (-r["size_bytes"], r["label"].lower()))
|
| else:
|
| rows.sort(key=lambda r: r["label"].lower())
|
|
|
|
|
| lines = [
|
| "| File Type | Count | Size (KB) |",
|
| "| :--- | :--- | :--- |",
|
| ]
|
| for row in rows:
|
| lines.append(
|
| f"| {row['label']} | {row['count']} | {format_size_kb(row['size_bytes'])} |"
|
| )
|
|
|
|
|
| lines.append(f"| **Total** | **{total_count}** | **{format_size_kb(total_bytes)}** |")
|
|
|
| return lines
|
|
|
|
|
| def main() -> None:
|
| parser = argparse.ArgumentParser(
|
| description="Audit repository tech-stack (file types, counts, sizes)."
|
| )
|
| parser.add_argument(
|
| "path",
|
| nargs="?",
|
| default=".",
|
| help="Root directory to scan (default: current directory).",
|
| )
|
| parser.add_argument(
|
| "--output",
|
| "-o",
|
| default=None,
|
| help="Output Markdown file path (default: TECHSTACK.md in scanned dir).",
|
| )
|
| parser.add_argument(
|
| "--ignore",
|
| nargs="*",
|
| default=None,
|
| help="Extra directory/file names to ignore.",
|
| )
|
| parser.add_argument(
|
| "--no-default-ignore",
|
| action="store_true",
|
| help="Disable the built-in ignore list.",
|
| )
|
| parser.add_argument(
|
| "--exclude-ext",
|
| nargs="*",
|
| default=None,
|
| help="File extensions to exclude from output (without dot, e.g. png mp4 git).",
|
| )
|
| parser.add_argument(
|
| "--sort",
|
| choices=["count", "size", "ext"],
|
| default="count",
|
| help="Sort order for the table (default: count descending).",
|
| )
|
| args = parser.parse_args()
|
|
|
| root = os.path.abspath(args.path)
|
| root_name = os.path.basename(root)
|
|
|
|
|
| ignore_set: set = set() if args.no_default_ignore else set(DEFAULT_IGNORE)
|
| if args.ignore:
|
| ignore_set.update(args.ignore)
|
|
|
|
|
| out_path = args.output or os.path.join(root, "TECHSTACK.md")
|
| out_name = os.path.basename(out_path)
|
| ignore_set.add(out_name)
|
|
|
|
|
| exclude_exts: set = set()
|
| if args.exclude_ext:
|
| exclude_exts = {e.lower().lstrip(".") for e in args.exclude_ext}
|
|
|
| print(f"Scanning: {root}")
|
| print(f"Ignoring: {', '.join(sorted(ignore_set))}")
|
| if exclude_exts:
|
| print(f"Excluding extensions: {', '.join(sorted(exclude_exts))}")
|
|
|
| stats = scan_files(root, ignore_set, exclude_exts)
|
| table_lines = build_table(stats, sort_by=args.sort)
|
|
|
|
|
| md_lines = [
|
| f"## Techstack\n",
|
| f"Audit of **{root_name}** project files (excluding environment and cache):\n",
|
| ]
|
| md_lines.extend(table_lines)
|
| md_lines.append("")
|
|
|
| content = "\n".join(md_lines)
|
|
|
| with open(out_path, "w", encoding="utf-8") as fh:
|
| fh.write(content)
|
|
|
| total = sum(d["count"] for d in stats.values())
|
| print(f"Done – {total} files across {len(stats)} types written to {out_path}")
|
|
|
|
|
| if __name__ == "__main__":
|
| main()
|
|
|
