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
只删除垃圾桶中超过
$ 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 为开源开发提供的许可证。