system-utilities

Suite d'outils Bash pour creer, gerer et deployer des projets Python web.

Installation

git clone https://github.com/drbea/system-utilities.git
cd system-utilities
./install.sh

Redemarrez votre terminal apres l'installation.

Commandes disponibles

Commande	Description
create_project	Creer un projet Python/Django/FastAPI/Flask
django_collab	Serveur Django pour la collaboration LAN
deploy_project	Deploier un projet (archive ou serveur distant)
backup_db	Sauvegarder une base de donnees
check_project	Verifier un projet (lint, tests, securite)
migrate_project	Gerer les migrations Django
run_tests	Lancer les tests d'un projet

---

Options globales

Toutes les commandes supportent :

Option	Description
--version	Afficher la version
--verbose	Mode debug (plus d'infos)
--help	Afficher l'aide

---

create_project

Creer rapidement un projet Python avec environnement virtuel, Git et dependances.

Exemples

# Projet Django
create_project --django mon_projet

# Projet FastAPI
create_project --fastapi mon_api

# Projet Flask
create_project --flask mon_site

# Avec base PostgreSQL
create_project --django --db postgres --db-name blog_db blog

# Mode non interactif
create_project --django --yes mon_projet

Options

Option	Description
--django	Creer un projet Django
--fastapi	Creer un projet FastAPI
--flask	Creer un projet Flask
--no-venv	Ne pas creer d'environnement virtuel
--venv-name <nom>	Nom du dossier venv (defaut: .venv)
--no-git	Ne pas initialiser Git
--db <type>	Base de donnees : sqlite, postgres, mysql
--db-name <nom>	Nom de la base de donnees
--db-user <user>	Utilisateur de la BDD
--db-pass <pass>	Mot de passe de la BDD
--author <nom>	Auteur (pour le README et la licence)
--license <type>	Licence : mit, gpl, apache, none
--python-version <v>	Version de Python (ex: 3.12)
--yes	Mode non interactif
--config	Ouvrir le fichier de configuration
--show-config	Afficher la configuration actuelle

Configuration

Definir des valeurs par defaut :

create_project --config

Fichier ~/.system-utilities/config :

AUTHOR=Mon Nom
DB=sqlite
VENV_NAME=.venv
LICENSE=mit

Structure generee

mon_projet/
├── .venv/
├── src/
│   └── core/          # ou mon_package/
├── tests/
├── docs/
├── .env
├── .env.example
├── requirements.txt
├── Makefile
├── .gitignore
└── README.md

---

django_collab

Lancer un serveur de developpement Django pour la collaboration sur le reseau local.

Exemples

# Lancer dans le dossier courant
cd mon_projet
django_collab

# Port personnalise
django_collab --port 8080

# Avec collectstatic
django_collab --collectstatic

# Avec logs dans un fichier
django_collab --log-file serveur.log

Options

Option	Description
--port <port>	Port du serveur (defaut: 8000, 0=auto)
--collectstatic	Lancer collectstatic avant le serveur
--log-file <chemin>	Rediriger les logs vers un fichier

Le serveur demarre sur 0.0.0.0 pour etre accessible depuis les autres machines du reseau.

---

deploy_project

Preparer ou effectuer le deploiement d'un projet.

Exemples

# Creer une archive de deploiement
deploy_project

# Creer un Dockerfile
deploy_project --docker

# Deploier sur un serveur distant
deploy_project --remote user@mon-serveur --remote-path /opt/mon_app

Options

Option	Description
--output <dir>	Repertoire de sortie (defaut: deploy/)
--remote <user@host>	Deploier sur un serveur distant (SSH)
--remote-path <path>	Chemin distant sur le serveur
--docker	Creer un Dockerfile
--include-venv	Inclure l'environnement virtuel

---

backup_db

Sauvegarder la base de donnees d'un projet.

Exemples

# Sauvegarde SQLite (detecte automatiquement)
backup_db

# Sauvegarde PostgreSQL
backup_db --db-type postgres --db-name mon_blog

# Sans compression
backup_db --no-compress

Options

Option	Description
--dir <chemin>	Repertoire de sauvegarde (defaut: backups/)
--no-compress	Ne pas compresser l'archive
--db-type <type>	Type de BDD : sqlite, postgres, mysql
--db-name <nom>	Nom de la base de donnees
--db-user <user>	Utilisateur de la BDD
--db-host <host>	Host de la BDD (defaut: localhost)
--db-port <port>	Port de la BDD

---

check_project

Verifier l'etat d'un projet (lint, tests, securite, dependances).

Exemples

# Verification complete
check_project

# Sans les tests
check_project --no-tests

# Avec correction automatique
check_project --fix

Options

Option	Description
--no-lint	Passer la verification du lint
--no-tests	Passer les tests
--no-security	Passer la verification de securite
--no-dependencies	Passer la verification des dependances
--fix	Tenter de corriger les problemes

---

migrate_project

Gerer les migrations Django.

Exemples

# Verifier les migrations en attente
migrate_project --check

# Generer et appliquer les migrations
migrate_project --make

# Appliquer les migrations
migrate_project

Options

Option	Description
--make	Generer les migrations manquantes
--check	Verifier les migrations en attente

---

run_tests

Lancer les tests d'un projet.

Exemples

# Lancer tous les tests
run_tests

# Avec couverture
run_tests --coverage

# Affichage detaille
run_tests --verbose-output

# Un seul fichier de test
run_tests --pattern "test_models.py"

Options

Option	Description
--verbose-output	Affichage detaille des tests
--coverage	Generer un rapport de couverture
--pattern <glob>	Pattern de fichiers de tests

---

Tests

Lancer les tests automatises :

./tests/test_commands.sh

---

Desinstallation

./uninstall.sh

Ou via la commande d'installation :

./install.sh --uninstall

---

Docker

Utiliser system-utilities dans un conteneur :

docker build -t system-utilities .
docker run -it system-utilities

---

Contribution

1. Fork le depot
2. Creer une branche (git checkout -b feature/ma-feature)
3. Commit les changements (git commit -m "Ajout de ...")
4. Push la branche (git push origin feature/ma-feature)
5. Ouvrir une Pull Request

Licence

GPL v3 - Voir le fichier LICENSE