Skip to content

Dymbor/mkproj

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

mkproj

Bash Platform GitHub

mkproj est un petit utilitaire Bash pour créer rapidement un projet avec un dossier, initialiser un dépôt Git, et préparer l’environnement de travail sur Linux.

Warning

Pour que ce script fonctionne il vous faudra avoir installé et configuré GitHub CLI (gh)

📦 Installation

  1. Clonez le repo :
git clone https://github.com/Dymbor/mkproj.git
  1. Configuration minimale

Ouvrez le fichier ~/.bashrc avec un éditeur de texte :

nano ~/.bashrc

Ajoutez mkproj à votre fichier ~/.bashrc (ou ~/.zshrc) :

source "/chemin/vers/mkproj/mkproj.sh"
  1. Rechargez votre configuration :
source ~/.bashrc

⚙️ Configuration

Le répertoire dans lequel les projets sont créés est contrôlé par la variable d'environnement MKPROJ_DIR (par défaut, si elle n'est pas définie, les projets seront créés dans ~/Documents/Github/).

Pour le modifier :

# Dans ~/.zshrc ou ~/.bashrc avant de sourcer mkproj.sh
export MKPROJ_DIR="$HOME/mes-projets"

🚀 Utilisation

mkproj nom_du_projet [options]

Exemples :

mkproj demo
mkproj demo --gitignore=Python
mkproj demo --gitignore=C -c

📁 Comportement

Si aucune option n'est donnée, la commande :

  • Crée le répertoire $MKPROJ_DIR/nom_du_projet
  • Initialise un dépôt Git
  • Crée un README.md
  • Effectue le commit initial
  • Crée un dépôt privé sur GitHub et push le projet

⚙️ Options

Option Description
--gitignore=<lang> Récupère un .gitignore depuis GitHub pour le langage donné (ex: Python, C,...)
-c Crée une arborescence pour un projet C (src/, header/, main.c)
-h, --help Affiche la documentation

Templates gitignore disponibles : gh api /gitignore/templates

💡 Améliorations possibles

  • Ajouter d'autres templates (Node.js, React…)
  • Rendre le projet installable automatiquement
  • Ajouter des options pour configurer le repo (public/privé)

🤝 Contribution

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

📄 Licence

Ce projet est distribué sous licence MIT.
Vous êtes libre de l'utiliser, le modifier et le distribuer.
Voir le fichier LICENSE pour plus d'informations.

About

A short script to create a local Git and push your project to github in one line

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages