trash-cli - FreeDesktop.org 垃圾桶的命令行界面

|Downloads|

|Donate|_

简体中文_

trash-cli 可以将文件移入垃圾桶，并记录原始路径、删除日期和权限。它使用与 KDE、GNOME 和 XFCE 相同的垃圾桶，但你可以从命令行（和脚本）调用它。

它提供以下命令：

trash-put           将文件和目录移入垃圾桶
trash-empty         清空垃圾桶
trash-list          列出垃圾桶中的文件
trash-restore       恢复垃圾桶中的文件
trash-rm            从垃圾桶中删除单个文件

使用方法

将文件移入垃圾桶：

$ trash-put foo

列出垃圾桶中的文件：

$ trash-list
2008-06-01 10:30:48 /home/andrea/bar
2008-06-02 21:50:41 /home/andrea/bar
2008-06-23 21:50:49 /home/andrea/foo

在垃圾桶中搜索文件：

$ trash-list | grep foo
2007-08-30 12:36:00 /home/andrea/foo
2007-08-30 12:39:41 /home/andrea/foo

恢复垃圾桶中的文件：

$ trash-restore
0 2007-08-30 12:36:00 /home/andrea/foo
1 2007-08-30 12:39:41 /home/andrea/bar
2 2007-08-30 12:39:41 /home/andrea/bar2
3 2007-08-30 12:39:41 /home/andrea/foo2
4 2007-08-30 12:39:41 /home/andrea/foo
要恢复哪个文件 [0..4]: 4
$ ls foo
foo

恢复垃圾桶中的文件并覆盖现有文件：

$ echo "original">foo
$ ls
foo
$ trash foo
$ echo "new">foo
$ trash-restore --overwrite
0 2022-11-01 22:15:00 /home/andrea/foo
要恢复哪个文件 [0..0]: 0
$ cat foo
original

恢复多个垃圾桶中的文件，用逗号分隔，也支持范围：

$ trash-restore
0 2007-08-30 12:36:00 /home/andrea/foo
1 2007-08-30 12:39:41 /home/andrea/bar
2 2007-08-30 12:39:41 /home/andrea/bar2
3 2007-08-30 12:39:41 /home/andrea/foo2
要恢复哪些文件 [0..3]: 0-2, 3
$ ls foo bar bar2 foo2
foo bar bar2 foo2

清空垃圾桶中的所有文件：

$ trash-empty

只删除垃圾桶中超过 <days> 天的文件：

$ trash-empty <days>

示例：

$ date
Tue Feb 19 20:26:52 CET 2008
$ trash-list
2008-02-19 20:11:34 /home/einar/today
2008-02-18 20:11:34 /home/einar/yesterday
2008-02-10 20:11:34 /home/einar/last_week
$ trash-empty 7
$ trash-list
2008-02-19 20:11:34 /home/einar/today
2008-02-18 20:11:34 /home/einar/yesterday
$ trash-empty 1
$ trash-list
2008-02-19 20:11:34 /home/einar/today

只删除匹配特定模式的文件：

$ trash-rm \*.o

注意：你需要使用引号来保护模式不被shell展开。

常见问题

如何创建顶级 .Trash 目录？

步骤：

    sudo mkdir --parent /.Trash
    sudo chmod a+rw /.Trash
    sudo chmod +t /.Trash

我可以将 `rm` 别名为 `trash-put` 吗？
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

你可以这样做，但不应该。早期我认为这是个好主意，但现在我改变了想法。

尽管 `trash-put` 的接口看似与 `rm` 兼容，但它们的语义不同，这会导致问题。例如，`rm` 需要 `-R` 参数来删除目录，而 `trash-put` 不需要。

但有时我忘记使用 `trash-put`，真的不能这样做吗？

你可以将 rm 别名为一个提醒你不要使用它的命令：

alias rm='echo "这不是你要找的命令。"; false'

然后，如果你真的想使用 rm，只需在前面加上反斜杠来绕过别名：

\rm 无望的文件

注意，Bash 别名只在交互式 shell 中使用，所以使用这个别名不应该干扰期望使用 rm 的脚本。

被移入垃圾桶的文件去哪里了？

从主分区移入垃圾桶的文件会被移动到这里：

    ~/.local/share/Trash/

如何自动删除超过 30 天的文件？

运行以下命令：

(crontab -l ; echo "@daily $(which trash-empty) 30") | crontab -

这将更新你的 crontab 文件，添加一个每天运行的 trash-empty 命令，删除超过 30 天的文件。要查看你的 crontab，使用：crontab -l

安装

简单方法

要求：
* Python 3（Python 2.7 也可以）
* pipx（可选，用于在干净的环境中安装）

如果有 pipx，可以使用：

    pipx install trash-cli

或者，使用普通的 pip 安装：

    pip install trash-cli

注意：你可能需要将 ~/.local/bin 添加到 PATH 中：

    echo 'export PATH="$PATH":~/.local/bin' >> ~/.bashrc
    source ~/.bashrc # 重新加载 .bashrc

卸载时使用：

    pipx uninstall trash-cli

或：

    pip uninstall trash-cli

最新版本（从源码安装）

首先需要卸载之前的 trash-cli 版本：

$ [sudo] pip uninstall trash-cli # 使用 pip 卸载之前的版本
$ [sudo] apt-get remove trash-cli # 使用 apt 卸载之前的版本
$ [sudo] yum uninstall trash-cli # 使用 yum 卸载之前的版本
$ ... # 参考你的发行版的包管理器

然后从 git 安装最新版本：

$ [sudo] pip install git+https://github.com/andreafrancia/trash-cli

用户安装后，你可能需要在 .bashrc/.zshrc 中添加这一行：

export PATH=~/.local/bin:"$PATH"

从包管理器安装

Debian/Ubuntu (apt)：

    sudo apt install trash-cli

Arch Linux (pacman)：

    sudo pacman -S trash-cli

Fedora (dnf)：

    sudo dnf install trash-cli

安装 shell 补全

需要通过以下方式安装：

pipx install 'trash-cli[completion]'

或：

pip install 'trash-cli[completion]'

然后：

cmds=(trash-empty trash-list trash-restore trash-put trash)
for cmd in ${cmds[@]}; do
  $cmd --print-completion bash | sudo tee /usr/share/bash-completion/completions/$cmd
  $cmd --print-completion zsh | sudo tee /usr/share/zsh/site-functions/_$cmd
  $cmd --print-completion tcsh | sudo tee /etc/profile.d/$cmd.completion.csh
done

错误

如果你发现了错误，请在这里报告：

https://github.com/andreafrancia/trash-cli/issues

反馈

你可以发送邮件至 andrea@andreafrancia.it。

开发

环境设置：

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt -r requirements.txt

运行测试：

pytest -m 'not slow'        # 只运行快速测试
pytest -m 'slow'            # 运行慢速测试
pytest                      # 运行所有测试

致谢

感谢 Paypal 捐赠者。

感谢项目贡献者。

感谢 JetBrains 为开源开发提供的许可证。