Metadata-Version: 2.4
Name: artifact-scythe
Version: 0.5.1
Summary: CLI tools for cleaning artifacts and builds
Author-email: Eliel MENGUE <mengueeliel712@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/elielMengue/scythe
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: license-file

#  Artifact-Scythe

> Un outil CLI intelligent pour nettoyer automatiquement les artefacts de build

[![CI](https://github.com/elielMengue/scythe/actions/workflows/ci.yml/badge.svg)](https://github.com/elielMengue/scythe/actions/workflows/ci.yml)
[![PyPI version](https://img.shields.io/pypi/v/artifact-scythe.svg)](https://pypi.org/project/artifact-scythe/)
[![Python versions](https://img.shields.io/pypi/pyversions/artifact-scythe.svg)](https://pypi.org/project/artifact-scythe/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

![Image externe](https://eliel-mengue.vercel.app/images/scythe.png)

##  Qu'est-ce que c'est ?

Artifact-Scythe scanne vos répertoires de projets et détecte automatiquement les artefacts de build inutiles (node_modules, .venv, __pycache__, target/, etc.) pour libérer des dizaines de Go d'espace disque.

##  Fonctionnalités

-  Scan récursif de répertoires
-  Détection automatique de types de projets (Node, Python, Rust, Java, etc.)
-  Calcul d'espace occupé par les artefacts
-  Nettoyage sélectif ou global
-  Mode interactif avec confirmation
-  Rapport détaillé de nettoyage

##  Installation

### Depuis les sources

```bash
git clone https://github.com/elielMengue/scythe.git
cd scythe
pip install -e .
```

### Depuis PyPI

```bash
pip install artifact-scythe
```

> Le package s'appelle `artifact-scythe` sur PyPI (le nom `scythe` était déjà pris), mais la commande installée et le module Python restent `scythe`.

##  Usage

### Scan d'un répertoire

```bash
scythe scan ~/projects
```

### Nettoyage interactif

```bash
scythe clean ~/projects --interactive
```

### Mode dry-run (simulation)

```bash
scythe clean ~/projects --dry-run
```

### Filtrer par type de projet

```bash
scythe scan ~/projects --only node,python
scythe clean ~/projects --only rust --dry-run
```

### Afficher l'aide

```bash
scythe --help
```

##  Développement

### Prérequis

- Python 3.10+
- pip

### Configuration de l'environnement

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### Lancer les tests

```bash
pytest -v
```

##  Roadmap

- [x] Phase 1: Configuration & Fondations
- [x] Phase 2: Scanner de Répertoires
- [x] Phase 3: Détection d'Artefacts
- [x] Phase 4: Interface Utilisateur
- [x] Phase 5: Moteur de Nettoyage
- [x] Phase 6: Fonctionnalités Avancées -- **Ongoing**
- [ ] Phase 7: Tests & Validation
- [ ] Phase 8: Documentation & Déploiement

##  Contribution

Les contributions sont les bienvenues ! N'hésitez pas à ouvrir une issue ou une pull request.


## ⚠️ Status du Projet
**Version 0.5.0**
Cette version ajoute le filtre `--only` sur scan/clean et corrige un bug critique du scanner.

## Hint 
**Read** the [changelog](https://github.com/elielMengue/scythe/blob/main/CHANGELOG.md) to see changes as I continue developping from time to time

---
[@elielMengue](https://github.com/elielMengue)




