我的项目地址: 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 Aligoali = Aligo()# 获取用户信息user = ali.get_user()# 获取网盘根目录文件列表root_file_list = ali.get_file_list()

扫码登录

from aligo import Auth, Aligoauth = 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# 如果没有找到, 只返回 Nonefile = ali.get_file_by_path('/aligo/tests')# 咱们能够查看 file 的一些属性file_type = file.typename = file.namedownload_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_tokenshare_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 Aligoclass 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交换反馈群