Metadata-Version: 2.4
Name: valk-filemanager
Version: 0.1.0
Summary: Une bibliothèque Python pour gérer simplement les fichiers JSONs, les créer, les charger et écrire dedans facilement, en vérifiant que leur structure est correcte.
Project-URL: Homepage, https://valk-solutions.fr/project/filemanager
Author-email: "Valk.py" <valk.py.dev@example.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 📂 filemanager

Une bibliothèque Python ultra-légère et robuste pour gérer simplement vos fichiers JSON sans vous soucier des fichiers manquants ou corrompus.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/)

## ✨ Fonctionnalités

- **Auto-Réparation :** Si un fichier JSON est corrompu ou mal formé, la bibliothèque le détecte et le réinitialise proprement pour éviter le crash de votre application.
- **Sécurité :** Création automatique des fichiers s'ils n'existent pas lors d'une tentative de lecture ou d'écriture.
- **Simplicité :** Enregistrez une clé et une valeur en une seule ligne de code sans charger tout le fichier manuellement.

## 🚀 Installation

Installez directement depuis PyPI:

```bash
pip install filemanager
```

## 🛠️ Utilisation

```py
from filemanager import load_data, save_data, save_key, exist
filename = "config.json"

# 1. Vérifier si le fichier existe
print(exist(filename)) # Retourne False ou True

# 2. Sauvegarder des données complètes (Crée le fichier automatiquement s'il n'existe pas)
data_utilisateurs = {
    "pseudo": "Valk",
    "premium": True
}
save_data(filename, data_utilisateurs)

# 3. Ajouter ou modifier une clé spécifique facilement
save_key(filename, "version", "1.0.2")

# 4. Charger les données du fichier
config = load_data(filename)
print(config)
# Résultat : {'pseudo': 'Valk', 'premium': True, 'version': '1.0.2'}
```