用法

本文件说明了backup-rat二进制的用法

安装

需要标准的Rust安装（如果您没有，请在此处获取）

使用crates.io

$ cargo install backup_rat

使用git

克隆项目

$ git clone "https://github.com/System-rat/backup-rat.git"

进入目录

$ cd backup-rat

从源安装

$ cargo install --path .

二进制

目前二进制必须有一个配置文件才能正确运行（如果您不想有目标，则不需要，但这有点违背了目的）。

备份配置文件中的所有非可选目标

$ backup-rat backup

备份所有带有“Config”标签的目标

$ backup-rat backup Config

为各种shell生成补全

$ backup-rat completion bash

配置

配置文件位于*NIX系统的$HOME/.config/backup-rat/config.toml，Windows的%HOME%/AppData/Roaming/System.rat/backup-rat/config.toml，OSX的$HOME/Library/Preferences/com.System.rat.backup-rat/config.toml，并使用TOML语法（基本上是.ini文件）

配置文件结构

在这个示例中，所有可选变量都设置为默认值

NYI - 尚未实现（不要使用它，没有这个必要）

# NYI
daemon_interval = 0 

# NYI
color = false 

# NYI
fancy_text = true 

# NYI
verbose = false 

# NYI
runtime_folder = "" 

# This is 1 target, to configure more just put more of these [[target]] tags followed by the target declaration
# Added: 0.1.0
[[target]] 

# Optional: the tag for logging and for backing up (must use if the target is optional)
# Added: 0.1.0
tag = "Config"

# The path to the file or folder to backup
# Added: 0.1.0
path = "/etc" 

# The destination of the backup (in this example the /etc folder will be in /mnt/Backup/etc)
# Added: 0.1.0
target_path = "/mnt/Backup" 

# Optional: If set to true the target will NOT be backed up by the *all* target
# Added: 0.1.0
optional = false 

# Optional: If set to true the files will NOT be checked for modification
# Added: 0.1.0
always_copy = false 

# Optional: A list of files to be ignored during backup
# Prefix the string with a r# to use a regex pattern
# If he string is not prefixed with a r# the full filename is evaluated
# Added: 0.3.0
ignore_files = [
    'r#.*\.ba(c|k)',
    '.build'
] 

# Optional: Same as `ignore_files` except it evaluates the folder path relative
# to the base directory (in example, target: "/home/user/Documents" the sub-folder
# "Rust/backup_rat" gets evaluated as such)
# Added: 0.3.0
ignore_folders = [
    'r#temp$',
    'build'
] 

# Optional: How many copies of the target to keep (folder targets only).
# The name of the directory to be copied will be put in the backup directory
# followed by `keep_num` number of subdirectories with the date of the backup as
# the name.
# DateTime directories are only created if `keep_num` is greater than 1.
# If `keep_num` is greater than 1, always_copy is ignored as it will always create a new directory.
# Example directory location: /mnt/Backup/etc/2042-2-18 12:00:43/
# Added: 0.4.0
keep_num = 2

# Example of a second target that uses the same tag
[[target]] 
tag = "Config"
path = "/home/USERNAME/.config"
target_path = "/mnt/Backup/Config"