Metadata-Version: 2.1
Name: xiaoya
Version: 0.1.4
Summary: 小雅 alist 部署和维护
Home-page: https://github.com/podboy/xiaoya-kits
Author: Mingzhe Zou
Author-email: zoumingzhe@outlook.com
License: MIT
Project-URL: Source Code, https://github.com/podboy/xiaoya-kits
Project-URL: Bug Tracker, https://github.com/podboy/issues
Project-URL: Documentation, https://github.com/podboy/xiaoya-kits
Keywords: docker,podman
Platform: any
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: xarg-python>=1.5.1
Requires-Dist: requests

# xiaoya-kits

> 小雅 alist 部署和维护。

## ❤️ 赞助

`xiaoya-kits` 完全免费获取及使用，但是您的赞赏可以鼓励作者维护，万分谢谢！

### 🌟 GitHub Star

请点击 [GitHub](https://github.com/podboy/xiaoya-kits) 右上角的 `⭐ Star` 增加人气，以便更多的人发现此工具。

### 💽 转存阿里云盘文件

点击链接保存，或者复制本段内容，打开「阿里云盘」APP 。

<https://www.alipan.com/s/dn6J8Gg4FUC>

这是一个非常小的文件（仅占用您几KB空间），您的转存可以使作者获得更多的存储空间。

## 🗑️ xiaoya clear-aliyundrive

> 一个清理`阿里云盘`中 `xiaoya` 转存文件的工具。

### 为什么选择 `xiaoya clear-aliyundrive`

相比于其他（使用 `Shell` 开发）的清理脚本，`xiaoya clear-aliyundrive` 的清理更加灵活。

由于 `xiaoya-kits` 基于 `Python` 开发，并且使用了 [xarg-python](https://github.com/bondbox/xarg-python) 模块，因此 `xiaoya clear-aliyundrive` 命令行更为友好，可同时进行多维度的清理过滤，维护也相对来说更加简单。

### 过滤条件

`xiaoya clear-aliyundrive` 会对小雅转存文件夹下的所有文件（包括文件夹）按照 `updated_at` 时间进行排序，所有最新的转存文件会被优先保留。

#### 强制条件

1. 为避免清理正在转存或者刚刚转存的文件，会强制保留 `60` 秒内的文件（和文件夹）。
2. 由于当前文件夹没有 `size` 属性，还无法统计文件夹的占用空间，并且小雅一般转存的都是文件而非文件夹，所以文件夹会被强制清理。

#### file

`--file`，十进制数，指定最大保留的文件数（默认值为：100）。

按照 `updated_at` 时间进行排序，超过指定数量后的文件会被强制清理。

#### byte

`--byte`，十进制数，最大保留的空间（默认值为：50.0GB），单位为字节数。

按照 `updated_at` 时间进行排序并计算空间，超过指定空间后的文件会被清理。

#### minute

`--minute`，十进制数，最大保留的分钟数（默认值为：24h），单位为分钟。

按照 `updated_at` 时间，和当前时间的差值超过指定分钟数强制清理。

### ⏩ 快速清理（一次性）

使用 `Python>=3.8` 环境，在小雅数据目录下执行以下命令：

```bash
pip3 install --upgrade xiaoya && xiaoya --version
xiaoya clear-aliyundrive --stdout --debug
```

### ⏱️ 定时清理

您可以将 `xiaoya clear-aliyundrive` 命令添加到 `crontab` 中，实现定时清理。

### docker 部署

> 想要在 docker 中运行需要守护模式，此功能正在开发，敬请期待！
