lsum-enhanced 1.0.2

Directory summary tool with powerful grouping, and recursive searching

📂 lsum-enhanced

lsum-enhanced (List Summary Enhanced) is a high-performance, visually rich CLI directory analysis tool that transforms standard file listings into actionable intelligence.

---

⚡ TL;DR

lsum-enhanced is ls on steroids. It doesn't just list files; it categorizes, counts, and visualizes your directory's distribution by MIME types, extensions, and metadata—all while respecting your .gitignore rules.

---

🤔 Why lsum-enhanced?

Standard tools like ls or tree are great for finding files, but they fail to answer higher-level questions about your workspace. lsum-enhanced was built to fill that gap:

• Audit Your Assets: Instantly see how many gigabytes of images vs. text files you have.
• Visualize Structure: Group files into elegant, color-coded panels based on their actual content (MIME) rather than just extensions.
• Clean Analysis: Use the --gitignore flag to strip out node_modules, build artifacts, and logs, focusing only on the code that matters.
• Recursive Intelligence: Understand the composition of entire project trees in a single, formatted view.

[!NOTE] lsum-enhanced is under active development

---

🚀 Installation

Pre-Requisites

This package depends on python-magic, which requires libmagic.

If not installed already, install it using -

Linux

sudo apt install libmagic1

macOS

brew install libmagic

Install it

Globally (outwith a venv), install with pipx

pipx install lsum-enhanced

Existing venv

# existing venv
source path/to/existing/venv/bin/activate
pip install lsum-enhanced

# new venv
python -m path/to/new
source path/to/new/bin/activate
pip install lsum-enhanced

🛠️ Building From Source

Perfect for developers who want the latest features:

# Clone the repository
git clone https://github.com/DMcCallum83/lsum-enhanced.git
cd lsum-enhanced

# Install dependencies
sudo apt install libmagic1
# or for macOS
brew install libmagic
# then build
uv build

# test your dev build
uv run lse .

---

🛠️ Usage Examples

1. Basic Listing

A clean, tabular view of your current directory:

lse

2. Group by MIME Type (with Icons)

See your files grouped by their actual content type (e.g., Image, Video, Text):

lse --group
lse -g

3. Respect Gitignore

Exclude build artifacts and ignored files for a "clean" summary:

lse . --gitignore --count
lse . -gi -c

4. Recursive Extension Summary

Analyze every file in your project tree, grouped by extension:

lse . --recursive --group-extension
lse . -r -ge

5. Advanced Sorting & Filtering

Find all .txt files and sort them by size:

lse --filter-extension .txt --sort size
lse -fe .txt -s size

---

⌨️ CLI Options

Option	Shorthand	Description
--count	-c	Count files/directories in groups or total.
--group	-g	Group files by MIME type.
--group-extension	-ge	Group files by file extension.
--gitignore	-gi	Respect .gitignore rules (excludes ignored files).
--recursive	-r	Perform operations on all subdirectories.
--sort	-s	Sort by name, size, or date.
--filter	-f	Filter by a specific MIME type (e.g., image/jpeg).
--filter-text	-ft	Filter filename.

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ using Python and Rich.