nedots

sourcehut | github | crates.io

一个智能、安全且直观的dotfiles管理工具。

运行 nedots help / nedots -h / nedots 查看文档。

如果您想看到它的实际应用，可以查看一个 构建。构建以最大详细程度运行，因此所有操作都会记录到 stdout。这些构建展示了所有功能 - 它不是一个最直观的“演示”，但它确实让您看到了它能做什么。

待办事项

• 我会避免以 root 运行此工具。我需要确保文件操作由正确的用户执行。

nedots.yml

配置文件位于 $XDG_CONFIG_HOME/nedots/nedots.yml。如果 $XDG_CONFIG_HOME 没有设置，那么 $HOME/.config/nedots/nedots.yml。

当您使用 nedots 时，您维护一个包含远程git仓库地址、目录或文件列表以及git子模块列表的小文件。

GitRepo

以下是一个小示例

remote: [email protected]:~nedia/nedots
sources:
  - .config/bspwm
  - .profile
  - /etc/hostname
  - Wallpapers
git_repos:
  - repo:
    remote: [email protected]:~nedia/config.nvim
    path: .config/nvim

sources

例如，install操作将从$XDG_DATA_HOME/nedots/{source}复制这些文件到$HOME/{source}。如果未设置$XDG_DATA_HOME，则使用$HOME/.local/share/nedots。

相反，gather将从$HOME/{source}复制文件到$XDG_DATA_HOME/nedots/{source}。

目录将递归复制。路径可以属于您或其他人，但在运行时对不属于您的路径执行操作需要正确的权限 - 例如，您需要运行sudo nedots来安装或收集/etc/中的文件。

用法

虽然您可能刚开始使用这种存储dotfiles的方式，但您很可能已经有一个用于存储dotfiles的git仓库。这是已经完成的一些工作。

# To set `nedots` up in its default location `$XDG_DATA_HOME/nedots` or `$HOME/.local/share/nedots`.
nedots init <remote>

接下来，您需要编辑nedots.yml - 特别是sources，以便nedots sync可以收集您的文件。然后，它将它们复制到$XDG_DATA_HOME/nedots/dots。

# Recommend adding `--nopush` so `nedots` won't push these changes to remote.
# You can review them first. Gather is responsible for collecting your files.
nedots sync --gather --nopush

文件结构可能如下所示

tree .local/share/nedots/dots -a
.local/share/nedots/dots
├── etc
│   └── hostname
└── home
    └── aiden
        ├── .config
        │   └── bspwm
        │       ├── bspwmrc
        │       ├── external_rules
        │       └── floating_desktop
        ├── .profile
        └── Wallpapers
            ├── wallhaven-9dxo58.jpg
            ├── wallhaven-dp118j.png
            ├── wallhaven-l35myl.jpg
            ├── wallhaven-q2mgqd.jpg
            ├── wallhaven-v9dez8.jpg
            ├── wallhaven-vqxgql.png
            ├── wallhaven-wqpgw6.png
            ├── wallhaven-y89del.png
            └── wallhaven-zm9kpy.jpg

7 directories, 14 files

就是这样！现在，每次您修改在sources中定义的文件或文件夹时，运行nedots sync -g/--gather将收集文件并将它们推送到远程。

安装

从源代码构建

请参阅rustup.

# rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# stable channel
rustup toolchain install stable
rustup default stable

# clone & build
git clone https://git.sr.ht/~nedia/nedots.rs
cd nedots.rs
cargo build --release

# symlink to .local/bin
ln -s target/release/nedots ~/.local/bin/nedots