dotter

Qu'est-ce que Dotter?

Dotter est un gestionnaire de dotfile et un templater.

DotFiles sont des fichiers de configuration qui vivent généralement dans le répertoire domestique et commencent par un point. Souvent, il est souhaitable d'avoir une sauvegarde de toutes les configurations de votre système, c'est pourquoi de nombreux utilisateurs ont leurs fichiers de points enregistrés dans un référentiel Git, puis les symbolisant à leurs emplacements cibles en utilisant ln -s .

Cependant, il y a plusieurs problèmes avec cette approche Barebones:

• Difficile de garder une trace de ce qui vient d'où vous avez plus qu'une poignée de fichiers de points
• Fondious pour configurer sur une nouvelle machine - vous devez créer manuellement chaque lien
• Aucune façon réelle de gérer les différences entre les machines - disons que vous voulez que le compteur de batterie de votre barre n'apparaisse pas sur votre machine de bureau

Dotter vise à résoudre tous ces problèmes en fournissant une configuration flexible et des modèles automatiques ou un sylinaison aux emplacements cibles.

Installation

Mac (homebrew)

Dotter est disponible sur Homebrew en utilisant brew install dotter

Arch Linux

Les forfaits AUR suivants sont disponibles:

• Dotter-Rs-Bin pour une version précompilée de la dernière version
• Dotter-RS pour la source de la dernière version qui est construite sur votre machine
• Dotter-RS-Git pour le dernier engagement sur Master qui est construit sur votre machine

Tous ceux-ci sont entretenus par Orhun - un grand merci à lui!

Fenêtre

Dotter est disponible sur Scoop. Exécutez scoop install dotter pour installer la dernière version.

Autres

Téléchargez le binaire pour votre plate-forme à partir de la dernière version, puis mettez-la dans votre $PATH ou dans votre référentiel DotFile (puis vous l'exécutez avec ./dotter ). Alternativement, Dotter est sur Crates.io, donc si vous avez installé la rustup, exécutez cargo install dotter .

Wiki

Consultez le wiki pour plus d'informations. Entre autres choses, il explique comment configurer et configurer Dotter, ainsi que donner un aperçu du fonctionnement des modèles et du déploiement.

Usage

Maintenant que vous avez configuré toutes les sections de fichiers globales et locales, vous pouvez simplement exécuter dotter à partir de votre référentiel.
Tous les fichiers seront déployés dans leurs emplacements cibles.

Consultez dotter -h pour les drapeaux de ligne de commande que Dotter prend en charge:

 A dotfile manager and templater written in rust

Usage: dotter [OPTIONS] [COMMAND]

Commands:
  deploy           Deploy the files to their respective targets. This is the default subcommand
  undeploy         Delete all deployed files from their target locations. Note that this operates on all files that are currently in cache
  init             Initialize global.toml with a single package containing all the files in the current directory pointing to a dummy value and a local.toml that selects that package
  watch            Run continuously, watching the repository for changes and deploying as soon as they happen. Can be ran with `--dry-run`
  gen-completions  Generate shell completions
  help             Print this message or the help of the given subcommand(s)

Options:
  -g, --global-config <GLOBAL_CONFIG>
          Location of the global configuration [default: .dotter/global.toml]
  -l, --local-config <LOCAL_CONFIG>
          Location of the local configuration [default: .dotter/local.toml]
      --cache-file <CACHE_FILE>
          Location of cache file [default: .dotter/cache.toml]
      --cache-directory <CACHE_DIRECTORY>
          Directory to cache into [default: .dotter/cache]
      --pre-deploy <PRE_DEPLOY>
          Location of optional pre-deploy hook [default: .dotter/pre_deploy.sh]
      --post-deploy <POST_DEPLOY>
          Location of optional post-deploy hook [default: .dotter/post_deploy.sh]
      --pre-undeploy <PRE_UNDEPLOY>
          Location of optional pre-undeploy hook [default: .dotter/pre_undeploy.sh]
      --post-undeploy <POST_UNDEPLOY>
          Location of optional post-undeploy hook [default: .dotter/post_undeploy.sh]
  -d, --dry-run
          Dry run - don't do anything, only print information. Implies -v at least once
  -v, --verbose...
          Verbosity level - specify up to 3 times to get more detailed output. Specifying at least once prints the differences between what was before and after Dotter's run
  -q, --quiet
          Quiet - only print errors
  -f, --force
          Force - instead of skipping, overwrite target files if their content is unexpected. Overrides --dry-run
  -y, --noconfirm
          Assume "yes" instead of prompting when removing empty directories
  -p, --patch
          Take standard input as an additional files/variables patch, added after evaluating `local.toml`. Assumes --noconfirm flag because all of stdin is taken as the patch
      --diff-context-lines <DIFF_CONTEXT_LINES>
          Amount of lines that are printed before and after a diff hunk [default: 3]
  -h, --help
          Print help
  -V, --version
          Print version

Contributif

Les contributions à Dotter sont les bienvenues, que ce soit sous la forme d'une demande de traction ou d'un problème (pour les repoches de bogues, les demandes de fonctionnalités ou d'autres commentaires utiles)

Soutien

Comme ce que je fais et que je veux m'encourager à continuer?
Vous pouvez donner un petit montant via PayPal.
Les dons ne sont pas attendus mais grandement appréciés.