Documentation
¶
Overview ¶
Package app は mdots の実行系（Store解決・コピー・登録・差分）を束ねる。
表面の定義は cli パッケージに置き、副作用のある処理は本パッケージに寄せる。 config/sync の詳細には触れず、入口の編成だけを行う。
Index ¶
- func Add(cwd, rawDest, target string) (string, string, error)
- func Init(cwd string) error
- func Pull(cwd string, target string, stderr io.Writer) error
- func PullDryRun(cwd string, target, color string, stdout, stderr io.Writer) int
- func Push(cwd string, target string, stderr io.Writer) error
- func PushDryRun(cwd string, target, color string, stdout, stderr io.Writer) int
- func Targets(cwd string) ([]string, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Add ¶
Add は未登録の既存ファイルを新規Entryとして登録する。 Store発見（カレント直下のみ）→dest正規化→src算出→Load→意味検査→ fragment生成→元ファイル追記→完成形再Load→atomic置換の順に行い、 ファイルのコピーは行わない。回収は pull が行う。 target 指定時は dotfiles/<target>/... に写像し、targets形式で登録する。 いずれかの検証で失敗したときは登録せず、mdots.tomlを変更しない。 素のsrc済み・同一Targetの再登録はエラーとする。 targets形式で別Targetが未登録なら追記マージする。
func Pull ¶
Pull は指定なし＋指定Target の Entry を dest から Store へ回収する。 target 未指定時は指定なし Entry のみが対象になる。 override=false の既存 Store は保護して skip 継続し、警告を stderr に出す。
func PullDryRun ¶
PullDryRun は pull の差分を stdout に出し、書き込みは行わない。 差分ありは exit 1、差分なしは exit 0。
func Push ¶
Push は指定なし＋指定Target の Entry を Store から dest へコピーする。 target 未指定時は指定なし Entry のみが対象になる。 override=false の既存 dest は保護して skip 継続し、警告を stderr に出す。
func PushDryRun ¶
PushDryRun は push の差分を stdout に出し、書き込みは行わない。 差分ありは exit 1、差分なしは exit 0。
Types ¶
This section is empty.
Source Files