dotter

Was ist Dotter?

Dotter ist ein Dotfile -Manager und Templater.

Dotfiles sind Konfigurationsdateien , die normalerweise im Home -Verzeichnis leben und mit einem Punkt beginnen. Oft ist es wünschenswert, alle Konfigurationen in Ihrem System zu sichern. Deshalb haben viele Benutzer ihre Dotfiles in einem Git -Repository gespeichert und sie dann mit ln -s an ihre Zielorte symlinieren.

Es gibt jedoch mehrere Probleme mit diesem Barebones -Ansatz:

• Es ist schwer zu verfolgen, was kommt, wohin Sie mehr als eine Handvoll Dotfiles haben
• Mühsam, auf einer neuen Maschine einzurichten - Sie müssen jeden einzelnen Link manuell erstellen
• Keine wirkliche Möglichkeit, Unterschiede zwischen Maschinen zu behandeln - sagen Sie, dass das Batterie -Messgerät auf Ihrer Balken nicht auf Ihrem Desktop -Computer angezeigt wird

Dotter zielt darauf ab, all diese Probleme zu lösen, indem sie eine flexible Konfiguration und automatische Vorlagen oder Symbolen für die Zielorte bereitstellen.

Installation

MAC (Homebrew)

Dotter ist auf Homebrew mit brew install dotter erhältlich

Arch Linux

Die folgenden AUR -Pakete sind verfügbar:

• Dotter-rs-bin für eine vorkompilierte Version der neuesten Veröffentlichung
• Dotter-Rs für die Quelle der neuesten Version, die auf Ihrer Maschine basiert
• Dotter-Rs-Git für den neuesten Commit für Master, der auf Ihrer Maschine aufgebaut ist

All diese werden von Orhun gepflegt - dank ihm!

Fenster

Dotter ist auf Scoop erhältlich. Führen Sie scoop install dotter aus, um die neueste Version zu installieren.

Andere

Laden Sie die Binärdehnung für Ihre Plattform von der neuesten Version herunter und stellen Sie sie dann in Ihren $PATH oder in Ihr Dotfile -Repository (dann würden Sie es mit ./dotter ausführen). Alternativ ist Dotter in crate.io. Wenn Sie Rustup installiert haben, führen Sie cargo install dotter .

Wiki

Weitere Informationen finden Sie im Wiki. Unter anderem erklärt es, wie Dotter eingerichtet und konfiguriert werden soll, sowie Einblicke in die Funktionsweise des Vorlagens und der Bereitstellung.

Verwendung

Nachdem Sie alle globalen und lokalen Dateiabschnitte konfiguriert haben, können Sie dotter einfach in Ihrem Repository ausführen.
Alle Dateien werden an ihren Zielorten bereitgestellt.

Schauen Sie sich dotter -h für die Befehlszeilenflags an, die Dotter unterstützt:

 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

Beitragen

Beiträge zu Dotter sind willkommen, ob in Form einer Pull -Anfrage oder eines Problems (für Fehler -Repots, Feature -Anfragen oder andere hilfreiche Kommentare)

Unterstützung

Wie was ich tue und möchte mich ermutigen, fortzufahren?
Sie können einen kleinen Betrag über PayPal spenden.
Spenden werden nicht erwartet, sondern sehr geschätzt.