乐趣区

关于python:使用Python控制阿里云盘

jiezi

我的项目地址: https://github.com/foyoux/aligo

这个我的项目起源于我的一个简略需要, 我有 25000 个文件, 曾经上传了 9000 个, 然而当初我把这些文件重新整理了, 最初我不晓得哪些文件曾经上传了, 哪些没有, 并且有些文件的文件名也曾经改了, 可能惟一确定一个文件的就是文件名中含有的一串数字 id. 而我不想反复或者从新上传这些文件. 于是我就抽筋地😅做了这个我的项目 aligo 👍🔥🚀

基本功能

  • [x] 扫码登录
  • [x] refresh_token 登录
  • [x] 长久化登录
  • [x] 获取用户信息
  • [x] 获取云盘信息
  • [x] 获取文件信息
  • [x] 批量获取文件下载地址
  • [x] 依据门路获取文件
  • [x] 获取文件列表
  • [x] 批量下载 / 上传文件 (夹)
  • [x] 秒传文件
  • [x] 批量重命名 / 挪动 / 复制文件 (夹)
  • [x] 批量珍藏 / 勾销珍藏文件 (夹)
  • [x] 批量挪动文件到回收站
  • [x] 批量复原回收站文件
  • [x] 获取回收站文件列表
  • [x] 搜寻文件 / 标签
  • [x] 创立官网分享，反对设置明码，有效期
  • [x] 更新分享 (官网)
  • [x] 批量勾销分享 (官网)
  • [x] 批量保留别人分享文件
  • [x] 自定义分享，冲破官网限度
  • [x] 自定义分享保留
  • [x] 反对自定义性能

疾速入门

环境要求

为了欠缺代码提醒, 不便大家代码书写, aligo 引入了一些 python 3.8 的新个性, 所以要求 python >= 3.8. *

装置 

pip install aligo

或 

pip install aligo -i https://pypi.org/simple

必要时能够加个 --upgrade 参数

举个栗子 

from aligo import Aligo

ali = Aligo()

# 获取用户信息
user = ali.get_user()

# 获取网盘根目录文件列表
root_file_list = ali.get_file_list()

扫码登录 

from aligo import Auth, Aligo

auth = Auth()

第一次应用 aligo 时, 执行上述代码

  • 如果是 Windows 零碎, 则调用默认看图工具显示二维码
  • 如果是非 Windows 零碎 (Linux), 则间接将二维码打印在终端中

之后你应用挪动端阿里云盘扫描受权即可实现登录, aligo 会主动将身份验证信息保留到用户目录下的 .aligo 目录下, 默认文件名是 aligo, 你能够应用 name 参数进行指定.

auth = Auth('小号') 或 auth = Auth(name='小号')

也能够应用 show 参数指定显示二维码的形式, 详情请返回 aligo 我的项目地址

refresh_token 登录

auth = Auth(name='refresh_token', refresh_token='<refresh_token>')

refresh_token 参数可在 Chrome -> F12 -> Application -> Local Storage -> token 中寻找

应用 Auth 对象创立 Aligo 对象

咱们所有的操作都是基于 Aligo 对象的, 它有一个可选的结构参数 auth, 默认为 Auth()

所有 Aligo(), Aligo(Auth()) 是没有区别的 

ali = Aligo()

获取网盘信息 

info = ali.get_personal_info()

# 总容量
total_size = info.personal_space_info.total_size

# 已用容量
used_size = info.personal_space_info.used_size

依据门路获取文件 

# 此办法默认以根目录 root 为根底, 也能够应用 parent_file_id 指定
# 即默认 parent_file_id = 'root'
# 必须以 斜杠 / 为门路分隔符
# 会疏忽头尾 斜杠 /, 所有 'aligo/tests', '/aligo/tests', '/aligo/tests/' 是没有区别的.
# 如果找到, 只返回一个 BaseFile 对象, 它能够代表 file, 也能够代表 folder
# 如果没有找到, 只返回 None
file = ali.get_file_by_path('/aligo/tests')

# 咱们能够查看 file 的一些属性
file_type = file.type
name = file.name
download_url = file.download_url
...

获取文件列表

  • 阿里云盘和百度不同, 百度网盘应用的是  门路  形式定位文件, 而阿里云盘应用的是 drive_id / share_id + file_id 定位文件
  • 在 aligo 中, 所有默认 drive_id 都可省略, 所以个别只需提供 file_id 参数即可
  • 以前阿里云盘时容许同名文件的, 但当初已更改了此策略, 文件名辨别大小写 
file_list = ali.get_file_list('<file_id>')

assert isinstance(file_list, list)

重命名文件 

new_file = ali.rename_file('新名字.jpg', '<file_id>', check_name_mode='refuse', drive_id=ali.default_drive_id)

# 批量重命名
# batch_rename_files

挪动文件 

# 挪动默认 drive_id 下的 file_id 文件到 默认 drive_id 的 'root' 下
move_file = ali.move_file('<file_id>', 'root')

# 批量可应用 batch_move_files 办法

# 复制文件
# ali.copy_file()
# ali.batch_copy_files()

挪动文件到回收站 

trash_file = ali.move_file_to_trash('<file_id>')

# 批量 batch_move_to_trash

获取回收站文件列表 

recyclebin_list = ali.get_recyclebin_list()

从回收站复原文件 

restore_file = ali.restore_file('<file_id>')

# 批量 batch_restore_files

珍藏 / 勾销珍藏 

ali.starred_file('<file_id>', starred=True)

# starred=True 示意珍藏
# starred=False 示意勾销珍藏

# 获取珍藏列表, 具体参数用法, 请查看 代码提醒 或 源码
starred_list = ali.ali.get_starred_list()

秒传文件 

# 具体参数看源码
# 必须参数, 取个 name, 随便

# content_hash, size 这两个就是惟一确定一个文件的参数, 即秒传所需参数
ali.create_by_hash(...)

下载文件 (夹)

# ali.download_file()
# ali.download_files()
# ali.download_folder()

上传文件 (夹)

# ali.upload_file()
# ali.upload_files()
# ali.upload_folder()

分享文件, 可设置明码, 有效期 

# 官网分享办法
# ali.share_file()

保留别人分享文件

在阿里云盘分享中, 链接开端那一段, 代表 share_id, 即代表一个分享的惟一识别码, 例如: https://www.aliyundrive.com/s…, 此分享明码 share_pwd=’w652′

其中 nDtTamX9vTP 即为 share_id

share_id = 'nDtTamX9vTP'
# 如果一个分享是公开分享, 那么 share_pwd = '', 默认就是此值, 所以没有明码时, 间接疏忽此参数即可.
# 具体情况你能够在开发工具中查看源码
share_pwd = 'w652'

# 1. 如果想获取 此 share_id 对应分享信息, 能够这样做
info = ali.get_share_info(share_id)

# 2. 当初你想拜访 此分享, 首先你须要获取 share_token
share_token = ali.get_share_token(share_id, share_pwd)

# 3. 当初你能够获取分享文件列表了
share_file_list = ali.get_share_file_list(share_id, share_token.share_token)

# 4. 这里还有一个 get_share_file 办法
file = ali.get_share_file(share_id, file_id=share_file_list[0].file_id, share_token=share_token.share_token)

# 5. 当初咱们能够进行保留了, 比方咱们保留到网盘根目录, 此时 to_parent_file_id 能够省略
save_file = ali.share_file_saveto_drive(share_id, file_id=share_file_list[0].file_id, share_token=share_token.share_token, to_parent_file_id='root')

# 6. 批量保留
batch_save_file = ali.batch_share_file_saveto_drive(share_id, [i.file_id for i in share_file_list], share_token.share_token, 'root')

自定义分享, 冲破官网限度 

# ali.share_files_by_aligo()
# ali.share_folder_by_aligo()

保留自定义分享 

# ali.save_files_by_aligo()

搜寻文件 / 标签 

# ali.search_file()
# ali.searech_aims()

自定义性能

这里以删除文件为例, 自定义性能

其余例子我想不进去了, 因为基本上都实现了 

"""..."""
from aligo import Aligo


class CustomAligo(Aligo):
    """自定义 aligo"""

    V2_FILE_DELETE = '/v2/file/delete'

    def delete_file(self, file_id: str):
        """删除文件"""
        response = self._post(self.V2_FILE_DELETE, body={'file_id': file_id})
        return response.json()


cali = CustomAligo()

cali.delete_file('<file_id>')

欢送大家反馈

文档写的不好, 欢送大家补充.
返回 我的项目地址

有问题? 反馈

有倡议? 探讨

也欢送大家 奉献代码

aligo 交换反馈群

退出移动版