dotter

ドッターとは何ですか？

DotterはDotfile Manager and Templaterです。

dotfilesは、通常はホームディレクトリに住んでいて、ドットから始まる構成ファイルです。多くの場合、システム上のすべての構成のバックアップを使用することが望ましいため、多くのユーザーがGitリポジトリにドットファイルを保存してから、 ln -sを使用してターゲットロケーションにシンプリングします。

ただし、そのベアボーンアプローチにはいくつかの問題があります。

• ほんの一握りのドットファイルがあれば、どこから来たのかを追跡するのは難しい
• 新しいマシンでセットアップするのが面倒です - すべてのリンクを手動で作成する必要があります
• マシン間の違いを処理する本当の方法はありません - バーのバッテリーメーターがデスクトップマシンに表示されないようにしたいとします

Dotterは、柔軟な構成とターゲット位置への自動テンプレートまたはシンリンクを提供することにより、これらすべての問題を解決することを目指しています。

インストール

Mac（Homebrew）

Dotterはbrew install dotterを使用してHomeBrewで利用できます

Arch Linux

次のAURパッケージが利用可能です。

• 最新リリースのプリコンパイルバージョン用のDotter-RS-Bin
• マシン上に構築されている最新リリースのソースのDotter-RS
• マシン上に構築されているマスターでの最新のコミットのためのdotter-rs-git

それらはすべてOrhunによって維持されています - 彼に感謝します！

Windows

DotterはScoopで入手できます。 scoop install dotter実行して、最新リリースをインストールします。

その他

プラットフォームのバイナリを最新リリースからダウンロードしてから、 $PATHまたはdotfileリポジトリ（ ./dotterで実行する）に配置します。あるいは、DotterがCrates.ioにいるので、Rustupが設置されている場合は、 cargo install dotterてください。

ウィキ

詳細については、Wikiをご覧ください。とりわけ、Dotterのセットアップと構成の方法と、テンプレートと展開の仕組みに関する洞察を提供する方法を説明しています。

使用法

これにより、すべてのグローバルおよびローカルファイルセクションを構成したため、リポジトリ内からdotterを実行できます。
すべてのファイルは、ターゲットの場所に展開されます。

Dotterがサポートするコマンドラインフラグについては、 dotter -hをご覧ください。

 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

貢献

プルリクエストまたは問題の形であろうと、Dotterへの貢献は歓迎されます（バグリポット、機能リクエスト、またはその他の有用なコメントの場合）

サポート

私がしていることのように、私が続けるように励ましたいですか？
PayPal経由で少量を寄付できます。
寄付は予想されていませんが、大いに感謝しています。