Alexandre Dos Reis

chezmoi

Gérez vos fichiers dotfiles sur plusieurs machines diverses, en toute sécurité.

Quelques definitions

Demarrage rapide

Initialise chezmoi. Cela créera un nouveau dépôt local git dans ~/.local/share/chezmoi où chezmoi stockera son état.. Par défaut, chezmoi ne modifie que les fichiers de la copie de travail.

$ chezmoi init

Ajoute un fichier dans le repo surveillé par chezmoi.

$ chezmoi add ~/.bashrc

Affiche les changements que chezmoi va effectuer.

$ chezmoi diff

Applique les changements

$ chezmoi -v apply

Puis, on enregistre nos changements:

chezmoi cd
git add .
git commit -m 'Initial commit'

Il faut créer une repo sur github appele dotfiles et pousser nos changements:

git remote add origin https://github.com/$GITHUB_USERNAME/dotfiles.git
git branch -M main
git push -u origin main
exit

Editer un fichier

Il y a plusieurs méthodes pour mettre à jour les dotfiles.

  1. Utiliser chezmoi edit $FILE. Cela ouvrira le fichier dans votre editeur. Pour plus de facilite, utilisez chezmoi edit --apply $FILE pour appliquer les changements quand vous quittez l'editeur, ou chezmoi edit --watch $FILE pour appliquer les changements lorsque le fichier est sauvegarder.

  2. Use chezmoi cd and edit the files in the source directory directly. Run chezmoi diff to see what changes would be made, and chezmoi apply to make the changes.

  3. If your editor supports opening directories, run chezmoi edit with no arguments to open the source directory.

  4. Edit the file in your home directory, and then either re-add it by running chezmoi add $FILE or chezmoi re-add.

  5. Edit the file in your home directory, and then merge your changes with source state by running chezmoi merge $FILE.