dotter

Apa itu Dotter?

Dotter adalah manajer dotfile dan templater.

Dotfiles adalah file konfigurasi yang biasanya hidup di direktori home dan mulai dengan titik. Sering kali, diinginkan untuk memiliki cadangan dari semua konfigurasi pada sistem Anda, itulah sebabnya banyak pengguna memiliki dotfile mereka disimpan dalam repositori git, kemudian symlinking mereka ke lokasi target mereka menggunakan ln -s .

Namun, ada beberapa masalah dengan pendekatan barebone itu:

• Sulit untuk melacak apa yang berasal dari mana setelah Anda memiliki lebih dari segelintir dotfiles
• Tedious untuk menyiapkan mesin baru - Anda perlu secara manual membuat setiap tautan tunggal
• Tidak ada cara nyata untuk menangani perbedaan antar mesin - Katakanlah Anda ingin pengukur baterai pada bilah Anda tidak muncul di mesin desktop Anda

Dotter bertujuan untuk menyelesaikan semua masalah itu dengan memberikan konfigurasi yang fleksibel dan templating otomatis atau symlinking ke lokasi target.

Instalasi

Mac (Homebrew)

Dotter tersedia di Homebrew menggunakan brew install dotter

Arch Linux

Paket AUR berikut tersedia:

• dotter-rs-bin untuk versi pra-kompil dari rilis terbaru
• dotter-rs untuk sumber rilis terbaru yang dibangun di atas mesin Anda
• dotter-rs-git untuk komit terbaru pada master yang dibangun di atas mesin Anda

Semua itu dikelola oleh Orhun - terima kasih banyak padanya!

Windows

Dotter tersedia di Scoop. Jalankan scoop install dotter untuk menginstal rilis terbaru.

Yang lain

Unduh biner untuk platform Anda dari rilis terbaru dan kemudian letakkan di $PATH Anda atau di repositori dotfile Anda (maka Anda akan menjalankannya dengan ./dotter ). Atau, Dotter ada di crates.io, jadi jika Anda telah menginstal Rustup, jalankan cargo install dotter .

Wiki

Lihat wiki untuk informasi lebih lanjut. Antara lain, ini menjelaskan cara mengatur dan mengkonfigurasi Dotter, serta memberikan wawasan tentang bagaimana templating dan penyebaran bekerja.

Penggunaan

Sekarang setelah Anda mengkonfigurasi semua bagian file global dan lokal, Anda dapat dengan mudah menjalankan dotter dari dalam repositori Anda.
Semua file akan digunakan ke lokasi target mereka.

Lihat dotter -h untuk bendera baris perintah yang didukung Dotter:

 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

Berkontribusi

Kontribusi untuk Dotter dipersilakan, baik dalam bentuk permintaan tarik atau masalah (untuk repot bug, permintaan fitur, atau komentar bermanfaat lainnya)

Mendukung

Seperti apa yang saya lakukan dan ingin mendorong saya untuk melanjutkan?
Anda dapat menyumbangkan sejumlah kecil melalui PayPal.
Sumbangan tidak diharapkan tetapi sangat dihargai.