Metadata-Version: 2.4
Name: unclaimed-libraries
Version: 0.1.0
Summary: CLI tool for detecting unused dependencies in Python projects
Author-email: Andre <andrejmedvedev2713@gmail.com>
License: MIT
Project-URL: Repository, https://github.com/AndrewMedvedev/unclaimed-libraries
Project-URL: Issues, https://github.com/AndrewMedvedev/unclaimed-libraries/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Utilities
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.33.1
Requires-Dist: rich>=15.0.0
Provides-Extra: dev
Requires-Dist: setuptools>=82.0.1; extra == "dev"
Requires-Dist: wheel>=0.47.0; extra == "dev"
Requires-Dist: twine>=6.2.0; extra == "dev"
Requires-Dist: types-requests>=2.33.0.20260408; extra == "dev"
Dynamic: license-file

# Unclaimed Libraries

[![Python Version](https://img.shields.io/badge/python-≥3.13-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![CLI](https://img.shields.io/badge/CLI-unclib-orange)]()

**Unclaimed Libraries** – это CLI‑инструмент для поиска неиспользуемых зависимостей в Python‑проектах.
Он анализирует pyproject.toml, просматривает все импорты в коде, отфильтровывает стандартную библиотеку и локальные модули, а также обращается к PyPI, чтобы пропустить пакеты, предназначенные только для разработки (линтеры, тестовые фреймворки, CLI‑утилиты и т.д.).

## ✨ Возможности

- ✅ **Точное обнаружение** – обрабатывает `import`, `from ... import`, динамические импорты (`importlib.import_module`, `__import__`).

- 🧠 **Умная фильтрация** – автоматически игнорирует:
    - модули стандартной библиотеки Python
    - локальные модули/пакеты (включая namespace packages)
    - пакеты для разработки (линтеры, тесты, статические анализаторы, CLI‑помощники) – используя классификаторы PyPI.

## 📦 Установка

```bash
pip install unclaimed-libraries
```

Or using uv:

```bash
uv add unclaimed-libraries
```

## 🚀 Использование


```bash
# Анализ текущей папки
unclib

# Анализ конкретного проекта
unclib /path/to/myproject

# Исключить дополнительные каталоги
unclib . --exclude legacy scripts
```


## 🙋 Как внести вклад

Приветствуются issues и pull request’ы!
Пожалуйста, сначала создайте issue для обсуждения значительных изменений.


**Распространяется под лицензией MIT. Подробности в файле LICENSE.**
