Project Analyzer & Directory Comparison Utility 📊🔍

---

English Version

Description

A powerful Python toolkit for static repository analysis, codebase version comparison, and directory structure matching.

Key Features

• 📈 Code Metrics Gathering: Counting total lines, clean code, comments, file sizes, and language breakdown.
• 🗂️ File-by-File Diff Analysis: Automatic detection of added, deleted, and modified files between two directory versions.
• 📄 Report Generation: Exporting summary reports to console or text files.

Tech Stack

• Language: Python 3.10+
• Standard Library: os, filecmp, difflib, pathlib, hashlib

Repository Structure

├── project_analyzer.py    # Deep codebase analysis module
├── obzor.py               # Differential directory comparison module
├── .gitignore             # Git ignore rules
├── LICENSE                # MIT License
└── README.md              # Documentation

Quick Start

git clone https://github.com/Bargaisl/project-inspector.git
cd project-inspector
python project_analyzer.py

⚠️ Disclaimer & Precautions

This utility is provided "as-is". The developers make no warranties regarding the completeness or accuracy of the static analysis results. Users should verify critical file comparisons independently. The authors bear no liability for data loss or decisions made based on analysis reports.

License

Licensed under the MIT License.

---

Русская версия (Russian Version)

Описание

Мощный прикладной инструментарий на Python для проведения статистического анализа репозиториев, сравнения версий кодовой базы и сопоставления файловых структур.

Основные возможности

• 📈 Сбор метрик кода: Подсчет количества строк, чистого кода, комментариев, объема файлов и распределения по языкам.
• 🗂️ Пофайловый Diff-анализ: Автоматическое определение добавленных, удаленных и модифицированных файлов между двумя версиями папок.
• 📄 Генерация отчетов: Вывод итоговой сводки в формате консольного отчета или текстового файла.

Стек технологий

• Язык программирования: Python 3.10+
• Стандартная библиотека: os, filecmp, difflib, pathlib, hashlib

Структура репозитория

├── project_analyzer.py    # Модуль глубокого анализа кодовой базы
├── obzor.py               # Скрипт дифференциального сравнения папок
├── .gitignore             # Исключения Git
├── LICENSE                # Лицензия MIT
└── README.md              # Документация

Инструкция по запуску

git clone https://github.com/Bargaisl/project-inspector.git
cd project-inspector
python project_analyzer.py

⚠️ Предупреждение и отказ от ответственности

Утилита предоставляется по принципу «как есть». Разработчики не дают никаких гарантий относительно полноты и точности результатов статического анализа. Пользователям следует самостоятельно проверять результаты критического сравнения файлов. Авторы не несут ответственности за возможные потери данных или решения, принятые на основе аналитических отчетов.

Лицензия

Распространяется под лицензией MIT License.