Skip to content

Dev Audit Tool (dat) v1.0.0 – One-Day Launch 🚀

Choose a tag to compare

View all tags
@Justadudeinspace Justadudeinspace released this 17 Oct 07:42
· 57 commits to main since this release
Immutable release. Only release title and notes can be modified.
v1.0.0
174b177

dat is a fast, cross-platform developer audit tool that prints and summarizes all files in a directory and its subdirectories. Filter by code, documentation, media, or custom extensions, limit lines per file, skip large files, include hidden files, output to a file, and instantly see top files by size or line count. Configurable, bootstrap-ready, and perfect for quickly inspecting any project.

(dat) v1.0.0 Highlights

🔹 Prints all files in a directory + subdirectories

🔹 Filter by type: code, docs, media, or custom extensions

🔹 Limit lines per file; skip large files

🔹 Include hidden files (dotfiles)

🔹 Current folder only option (no recursion)

🔹 Output results to a file

🔹 Top files summary by size or line count

🔹 Cross-platform: Linux, macOS, Windows, Android/Termux

🔹 Bootstrap installer for first-run convenience

🔹 Configurable via ~/.datconfig

Installation & Setup

  1. Clone the repository
git clone https://github.com/Justadudeinspace/dat.git
cd dat
  1. Install Python dependencies
pip install -r requirements.txt
  1. Install system libraries
Linux: sudo apt install -y libmagic1 libmagic-dev

macOS: brew install libmagic

Windows: pip install python-magic-bin

Termux/Android: pkg install libmagic
  1. Optional enhancements
pip install colorama Pillow PyPDF2
  1. Bootstrap installer (first run)
chmod +x dat
python dat

Use --no-bootstrap to skip first-run installation.

Usage Examples

# Audit current directory (all files)
dat

# Only code files
dat -c

# Only docs
dat -d

# Only media
dat -m

# Custom extensions
dat -e py,js,html

# Include hidden files
dat -a

# Only current folder, no recursion
dat -f

# Output to a file
dat -o audit.txt

# Limit lines per file
dat --max-lines 200

# Show top 10 files
dat --top-n 10

Configuration

dat optionally reads from ~/.datconfig for:

File type extensions

Maximum lines and file size

Top files to summarize

Custom extensions

Full configuration example is provided in the repository.

Example Output

DEV AUDIT SUMMARY
===============================
Total files processed: 120
Total lines: 12,345
Total size: 24.8 MB
Code files: 45, Docs: 35, Media: 30, Other: 10

Top 5 files by lines:
   2456 lines | ./src/main.py
   1789 lines | ./lib/utils.py
   ...

Top 5 files by size:
   3.5 MB | ./assets/video.mp4
   1.2 MB | ./docs/manual.pdf
   ...

Requirements

  • Python 3.9+

  • python-magic (or python-magic-bin on Windows)

  • Optional: colorama, Pillow, PyPDF2

License

MIT License – See LICENSE file.

Full Changelog: https://github.com/Justadudeinspace/dat/commits/v1.0.0

Assets 3
Loading