AnsCom NFIE — Native Filesystem Intelligence Engine (Python C Extension)

pip install anscom

A globally published, native C-based Python extension for filesystem intelligence and large-scale directory analysis.

---

AnsCom NFIE is a high-performance, native C extension for Python designed for systems engineers, data analysts, and developers. It recursively scans directories, categorizes files by type, and generates detailed statistical reports with Constant-memory streaming traversal. Unlike standard Python scanners (like os.walk), AnsCom is built in pure C89, allowing it to process massive filesystems instantly without flooding your terminal or exhausting system memory.

---

Key Features

• ** Native C Speed:** Written in pure C for maximum I/O throughput.
• ** Smart Exclusion System:** Automatically hard-ignores junk directories (node_modules, .venv, .git, __pycache__, build, etc.).
• ** Zero-Memory Streaming:** Processes files one by one in streaming fashion. Will never crash with MemoryError.
• ** Visual Tree Map:** Optional diagrammatic tree view.
• ** Detailed Analytics:**
  • Category Summary: Groups files by Code, Images, Video, Audio, Archives, Executables, etc.
  • Extension Breakdown: Exact counts for every file extension (.py, .c, .png, etc.).
• ** Live Progress:** In-place progress counter.
• ** Safety Circuit Breaker:** Configurable recursion depth limit (Default: 6).

---

Installation

pip install anscom

---

Usage Guide

Standard Scan

import anscom
anscom.scan(".")

Visual Tree Mode

import anscom
anscom.scan(".", show_tree=True)

Deep Scan

anscom.scan("C:/Users/Admin/Projects", max_depth=20, show_tree=True)

Full Drive Scan

anscom.scan("A:/", max_depth=5, show_tree=False)

---

API Reference

anscom.scan(path, max_depth=6, show_tree=False)

Parameter	Type	Default	Description
path	str	Required	Target directory
max_depth	int	6	Recursion depth
show_tree	bool	False	Enable tree view

Returns: int - total files scanned.

---

Smart Filter (Auto-Ignored)

.git, node_modules, .venv, venv, build, dist, __pycache__, temp, tmp, .cache, .pytest_cache, .mypy_cache, site-packages, etc.

---

Report Output

After scanning, AnsCom prints:

• Summary Report
• Detailed Extension Breakdown

---

Performance Architecture

• Direct OS syscalls (FindFirstFileW / readdir)
• Binary search categorization
• Buffered terminal output.

---

Demo

License

MIT License