Skip to content

Repository files navigation

db-explore

Un outil en Python pour gérer une base de données MySQL/MariaDB avec un menu interactif.


📌 À propos du projet

db-explore est un outil simple et efficace écrit en Python pour interagir avec une base de données MySQL/MariaDB. Il permet de :

  • Créer une base de données et une table utilisateurs.
  • Ajouter, mettre à jour et lister des utilisateurs.
  • Utiliser un menu interactif pour une gestion intuitive.

Ce projet est idéal pour apprendre à manipuler des bases de données relationnelles en Python ou pour servir de base à des projets plus complexes.


🛠 Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants installés sur votre système :

  • Python 3.8 ou supérieur
  • MySQL 8.0+ ou MariaDB 10.5+
  • Un serveur MySQL/MariaDB en cours d'exécution (local ou distant)
  • Accès à un utilisateur MySQL/MariaDB avec les permissions nécessaires pour créer des bases de données et des tables.

💻 Installation

1. Cloner le dépôt

git clone https://github.com/jack-sparrow-code/db-explore.git
cd db-explore

2. Installer les dépendances

Ce projet utilise la bibliothèque mysql-connector-python pour interagir avec MySQL/MariaDB. Installez-la avec pip :

pip install -r requirement.txt

Note : Si le fichier requirement.txt est vide, installez manuellement la dépendance :

pip install mysql-connector-python

⚙ Configuration

1. Configurer la connexion à la base de données

Éditez le fichier config.py pour spécifier les informations de connexion à votre serveur MySQL/MariaDB :

# config.py
DB_CONFIG = {
    "host": "localhost",          # Adresse du serveur MySQL/MariaDB
    "user": "VotreUtilisateur",   # Nom d'utilisateur MySQL/MariaDB
    "password": "VotreMotDePasse", # Mot de passe de l'utilisateur
    "database": "python_mysql_si" # Nom de la base de données (sera créée si elle n'existe pas)
}

⚠️ Attention : Ne partagez jamais vos identifiants de base de données dans un dépôt public. Utilisez des variables d'environnement ou un fichier .env pour plus de sécurité.


🚀 Utilisation

1. Lancer l'application

Exécutez le script principal pour démarrer le menu interactif :

python main.py

2. Menu interactif

Une fois lancé, le programme affichera un menu avec les options suivantes :

==================================================
Gestion de la base de données MySQL/MariaDB
==================================================
1. Créer la base de données et la table 'utilisateurs'
2. Ajouter un utilisateur
3. Mettre à jour un utilisateur
4. Lister tous les utilisateurs
5. Quitter
==================================================

Options du menu :

Option Description
1 Crée la base de données python_mysql_si et la table utilisateurs si elles n'existent pas.
2 Ajoute un nouvel utilisateur en spécifiant son nom et son âge.
3 Met à jour l'âge d'un utilisateur existant en fonction de son nom.
4 Affiche la liste de tous les utilisateurs enregistrés dans la base.
5 Quitte l'application.

📂 Structure du projet

db-explore/
├── main.py              # Menu interactif principal
├── create_database.py   # Crée la base de données et la table `utilisateurs`
├── insert_data.py       # Insère des utilisateurs dans la table
├── update_data.py       # Met à jour les données des utilisateurs
├── query_data.py        # Affiche les utilisateurs
├── config.py            # Configuration de la connexion à la base de données
├── requirement.txt      # Dépendances Python
└── README.md            # Documentation du projet

📜 Licence

Ce projet est distribué sous la licence GPLv3. Consultez le fichier LICENSE pour plus de détails.


🤝 Contribution

Les contributions sont les bienvenues ! Voici comment contribuer :

  1. Fork le projet sur GitHub.
  2. Créez une branche pour votre fonctionnalité (git checkout -b feature/ma-nouvelle-fonctionnalité).
  3. Commitez vos modifications (git commit -m "Ajout de ma nouvelle fonctionnalité").
  4. Poussez vers la branche (git push origin feature/ma-nouvelle-fonctionnalité).
  5. Ouvrez une Pull Request sur GitHub.

📬 Contact

Pour toute question ou suggestion, n'hésitez pas à me contacter :


🙏 Remerciements

  • Un grand merci à la communauté open-source pour ses outils et bibliothèques.
  • Inspiré par les besoins de gestion simple et efficace des bases de données en Python.

© 2026 - Jean-Christophe Énée (Jitsukai) | blues-softwares.net

About

an code in python for explore mysql database

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages