5 个不稳定版本

0.5.0 2019年11月12日
0.4.2 2019年11月12日
0.4.1 2019年11月12日
0.4.0 2019年11月12日
0.2.0 2019年10月29日

#35 in #symlink

MIT 许可证

31KB
533

正在进行中:badm - 但另一个点文件管理器

Maintenance Build Status Crates.io Documentation OS Support License

badm 是 "But Another 点文件 管理器"。

工作原理

badm 将您的点文件存储在目录中,该目录复制点文件原始路径的目录层次结构,并创建指向其原始路径的符号链接。这为在不同系统和用户之间管理、部署和共享点文件提供了一种标准化的方法。

快速演示

  • ferris 在 ~/.dots 创建了一个存储点文件的目录
  • badm set-dir ~/.dots 设置 BADM 点文件目录为 ~/.dots
  • badm 将在两个有效位置之一搜索 badm 配置文件: $HOME$XDG_CONFIG_HOME。如果找不到配置文件,badm 将在 $HOME 下创建它
/home
└── ferris
    └── .dots
        ├── .badm.toml
        └── .gitconfig
  • ~/.gitconfig 作为点文件存储,ferris 运行 badm stow ~/.gitconfig (相对路径也适用)
  • badm 在 ~/.dots 目录下复制点文件的路径
  • 点文件被移动到点文件目录的新路径,并在其原始路径处创建符号链接,该原始路径指向其新路径
/home
└── ferris
    ├── .badm.toml
    ├── .dots
    │   └── home
    │       └── ferris
    │           └── .gitconfig
    └── .gitconfig -> /home/ferris/.dots/home/ferris/.gitconfig

正在进行中:入门/安装

待办事项:v1.0.0 版本发布时将填充

命令

  • badm set-dir <DIRECTORY> - 设置点文件目录位置,如果位置不存在,BADM 有能力为您创建一个
  • badm stow <FILE> - 在点文件目录中存储文件,在存储文件的原始位置创建符号链接。
    • 审查:递归标志?
  • badm deploy <FILE> - 对于新的配置,在相对于点文件目录层次结构的目录中创建符号链接。如果找不到,将创建复制存储点文件的目录结构。
  • badm restore <FILE> - 从点文件目录恢复存储的文件,并用原始文件替换符号链接

路线图

  • 命令行工具,具有以下功能:
    • 创建/设置点文件目录(v0.3.0)
    • 在badm目录中存储点文件(v0.4.0)
    • 从badm目录部署点文件到新系统(v0.4.0)
    • 将点文件恢复到原始路径位置(v0.4.0)
  • 使用TOML文件进行持久化配置
  • 支持Glob通配符(*?)(v0.4.0)
  • 支持排除模式
  • 支持特定于系统的点文件
  • 支持多个点文件目录(?)

贡献

欢迎提交拉取请求、问题/功能请求和错误报告!

类似项目

许可证

本项目在MIT许可证下提供。有关更多信息,请参阅LICENSE文件。

依赖项

~1.3–2.4MB
~39K SLoC