Awesome
<p align="center"> <img src="https://pc.woozooo.com/img/logo2.gif" width="200"> </p> <h1 align="center">- 蓝奏云API -</h1> <p align="center"> <img src="https://img.shields.io/github/v/release/zaxtyson/LanZouCloud-API.svg?logo=iCloud"> <img src="https://img.shields.io/badge/support-Windows-blue?logo=Windows"> <img src="https://img.shields.io/badge/support-Linux-yellow?logo=Linux"> <img src="https://github.com/zaxtyson/LanZouCloud-API/workflows/Publish%20to%20PyPI/badge.svg"> </p>简介
-
本库封装了蓝奏网盘的基础功能: 登录、注销、获取文件(夹)列表、下载文件、上传文件、删除文件(夹)、 移动文件、清空回收站、恢复文件(夹)、创建文件夹、设置文件(夹)访问密码、设置文件(夹)描述
-
解决了蓝奏云的上传格式限制和单文件大小限制，同时增加了以下功能: 批量上传/下载文件、 上传/下载时断点续传、清理"幽灵"文件夹、移动文件夹、获取下载直链
-
如果有任何问题或建议, 欢迎提 issue, 维护不易，求一个 star (*/ω＼*)
免责声明
- 本项目仅供个人学习使用，严禁用于商业用途
- 本项目没有任何担保，如果您使用这些代码，您必需承担其带来的风险
API 文档
dev分支用于修复错误，待稳定后再推到master分支master分支将自动发布到 PyPI，使用pip install lanzou-api即可安装- API 文档请查看 wiki 页面
更新日志
v2.6.10
- 修复
get_dir_list缺少 uid 无法使用的问题#114
v2.6.9
- 修复上传成功后文件名不完整问题#95
v2.6.8
- 修复分享链接带有
webpage参数时无法下载的问题#81
v2.6.7
- 修复分享链接带有
webpage参数时无法下载的问题#74
v2.6.6
v2.6.5
v2.6.4
- 修复无法获取分享文件夹信息的问题#58
v2.6.3
- 修复下载页的 Cookie 验证问题#55
v2.6.2
- 修复文件后缀非小写导致的误判问题#92
v2.6.1
- 修复下载某些 txt 文件失败的问题#53
- 修复判断文件(夹)是否存在提取码功能异常的问题
v2.6.0
v2.5.8
- 修复部分网络环境下无法工作的问题 #44
v2.5.7
- 修复 VIP 用户分享的递归文件夹无法下载的问题#49
- 修复用户描述中带字符串
请输入密码而文件没有设置提取码导致误判的问题 get_folder_info_by_url()、get_folder_info_by_id()返回值中添加了子文件夹信息, 见API文档down_dir_by_id()和down_dir_by_url()函数增加参数recursive用于递归下载子文件夹, 见API文档
v2.5.6
v2.5.5
- 修复下载两个同名文件时断点续传功能异常的问题#35
- 下载函数新增
overwrite参数，确定是否覆盖本地文件(默认不覆盖,自动重命名) - 下载函数新增
downloaded_handler参数，可设置回调函数处理下载完成的文件, 具体见 API文档 - 修复蓝奏云将文件名敏感词(小姐)替换为
*导致无法创建文件的问题 - 修复文件大小中出现
,导致无法完整匹配文件大小的问题
v2.5.4
- 解决了下载时出现的验证问题，不需要手动识别图形验证码，因此去除了
set_captcha_handler()方法 #32 - 取消使用
f-string debug特性，向下兼容 Python3.6 #30
v2.5.3
- 修复 URL 包含大写字符无法匹配的问题 #28
v2.5.2
- 修复子域名不存在导致链接判断失误的问题#26
v2.5.1
- 修复蓝奏云域名变更导致的链接判断失误的问题#25
v2.5.0
- 新增函数
ignore_limits(), 解除官方限制(默认关闭状态, 不允许上传大文件, 文件格式限制) - 解除官方限制, 意味着您要承担由此带来的风险
- 用户名密码登录失效, 请使用 cookie 登录
v2.4.5
- 修复蓝奏云自定义域名文件无法下载的问题
- 修复新用户调用
get_move_folders()崩溃的问题 - 上传大文件时，临时数据块文件即时删除，避免占用空间
upload_file()函数增加回调函数uploaded_handler用于进一步处理上传完成的文件(对大文件而言是文件夹 , 其中的数据文件默认关闭密码), 详情参考 API 文档或者源码注释upload_dir()函数增加回调函数uploaded_handler用于进一步处理上传完成的文件夹- 新增函数
set_upload_delay()用于设置上传大文件数据块时的延时, 减小被官方封号的可能性
v2.4.4
- 修复蓝奏云 js 含有注释导致匹配文件信息错误的问题
- 修复
is_file_url()、is_folder_url()、get_file_info_by_url()无法正确处理 VIP 用户分享页面的问题 - 修复上传大文件自动创建文件夹名包含
mkdir字符串后缀的问题(这不是feature，只是测试时无意中写到代码里了－_－)
v2.4.3
- 上传/下载时支持断点续传(包括大文件)
- 降低了下载大文件时出现验证码的可能性(
dwg、gho等后缀容易触发验证码) - 调整了数据分段大小的权重，降低数据块平均大小(便于上传时断点续传)
- 修复
get_file_info_*()无法获取某些文件的文件名和日期的问题 - 修复
get_full_path()可能碰到无效数据导致崩溃的问题 - 新增
clean_ghost_folders()用于清理网盘中的"幽灵文件夹"(不在网盘和回收站显示的文件夹,移动文件时可以看见,文件移进去就丢失) - 新增
set_captcha_handler()用于处理下载时的验证码校验 - 新增
delete_rec_multi()用于批量删除文件(夹) - 新增
recovery_multi()用于批量恢复文件(夹) - 新增
recovery_all()用于恢复全部文件(夹)
v2.4.2
- 紧急修复了蓝奏云网页端变化导致
get_full_path()和get_dir_list()失效的 Bug
v2.4.1
- 修复使用 URL 下载时，记录文件被误判为普通文件，导致异常截断的问题
- 修复上传小文件时没有去除文件名中非法字符的问题
2.4.0 更新说明
- 放弃分段压缩，使用更复杂的方式上传大文件。分段数据文件名、文件大小、文件后缀随机，下载时自动处理。
- 放弃使用修改文件名的方式绕过上传格式限制。上传的文件末尾被添加了 512 字节的信息，储存真实文件名， 下载时自动检测并截断，不会影响文件 hash。一般情况下，不截断此信息不影响文件的使用，但纯文本类文件会受影响(比如代码文件)， 建议压缩后上传。
- API 不再返回
dict，减少大量使用result['attr']方式取值，而是返回namedtuple，直接使用result.attr取值。 - 获取文件(夹)列表不再返回
list，而是返回FileList或FolderList对象，支持list的操作，同时支持find_by_id()find_by_name()、filter()、pop_by_id()等方法查找和筛选数据。get_file_id_list()、get_dir_id_list()废弃，直接访问ListObj.name_id属性即可。 get_folders_id_name()、get_folders_name_id()被废弃，使用get_move_folders()获取网盘全部文件夹列表(FolderList对象)， 使用get_move_paths()获取网盘全部文件夹的绝对路径列表(排序好的list)，因此支持在不同路径下创建同名文件夹- 上传下载大文件时隐藏更多细节，回调函数只显示一个文件。数据切片由生成器实现，边上传边切片数据，减少等待时间。下载时按顺序写入一个文件，无需再次合并。
- 批量上传下载时，使用回调函数
failed_callback()即时处理失败文件，不再等待全部任务完成后返回失败列表。
2.3.5 更新说明
- 修复发送请求时
timeout无效的问题 #7 - 修复回收站文件夹中文件名过长，导致后缀丢失，程序闪退的问题 #14
- 修复回收站存在多个文件重复时，序号添加不合理的问题
- 修复官方启用滑动验证导致无法登录的问题 #15
2.3.4 更新说明
- 修复了官方对
.wtf[0-9]+.rar分卷后缀限制 #11 #12 - 新增函数
move_folder()支持移动文件夹 - 新增函数
set_max_size()允许修改单个文件大小限制(会员用户) #9 - 新增函数
rename_file()支持修改文件名(会员用户) - 修复了函数
get_rec_all()在某些情况下崩溃的问题 - 函数
get_folder_id_list()重命名为get_folders_name_id() - 新增函数
get_folders_id_name()以应对用户手动创建同名文件夹带来的问题 - 上传时不再自动删除文件名中空格, 自动转换
\xa0，\u3000为英文空格 - 函数
down_dir_by_url()、down_dir_by_id()增加参数mkdir=True, 下载时自动创建子文件夹 - 修复文件日期错误 #8
2.3.3 更新说明
- 修复上传超过 1GB 的文件时，前 10 个分卷丢失的 Bug #7
2.3.2 更新说明
- 修复了文件无法上传的 Bug
- 解除了官方对文件名包含多个后缀的限制
- 允许使用 cookie 登录
2.3.1 更新说明
- 开放了对
is_file_url()和is_folder_url()两个函数的调用 - 修复了文件夹深度达到 4 层时
get_full_path()报错的问题 mkdir()创建文件夹时会检查是否有同名文件夹，有的话加上_后缀get_folder_id_list()返回的文件夹中加入了根目录信息{LanZouCloud: -1}
2.3.0 更新说明
-
重新封装了
_get()、_post()方法，防止弱网环境炸出一堆网络异常导致程序崩溃 -
文件的上传时间统一为
%Y-%m-d格式，不再使用蓝奏云显示的N小时前、N天前、前天之类词语 -
变更的函数
get_dir_list()返回的信息增多，格式dict->listget_file_list()返回的信息增多，格式dict->listget_share_info()返回的信息增多list_recovery()被移除rename_dir()功能减少，仅用作重命名文件夹
-
更名的函数
get_file_list2()->get_file_id_list()get_dir_list2()->get_dir_id_list()get_direct_url()->get_durl_by_url()get_direct_url2()->get_durl_by_id()download_file()->down_file_by_url()download_file2()->down_file_by_id()set_share_passwd()->set_passwd()clean_recovery()->clean_rec()
-
新增的函数
get_rec_dir_list()获取回收站文件夹信息列表get_rec_file_list()获取回收站文件信息列表get_rec_all()获取整理后的回收站全部信息delete_rec()彻底删除回收站文件(夹)get_folder_id_list()获取全部文件夹 id 列表get_folder_info_by_url()获取文件夹及其文件信息get_folder_info_by_id()获取文件夹及其文件信息get_file_info_by_url()获取文件信息get_file_info_by_id()获取文件信息set_desc()设置文件(夹)描述信息
-
本次更新内容较多，其它诸多细节不再列举，具体变更请查看 wiki 页的 API 文档
v2.2.2 更新说明
- 修复无提取码文件夹无法下载的问题
- 修复文件夹、文件链接判断不完整的问题
get_dir_list()函数返回文件夹详细信息get_dir_list2()函数返回文件夹"name-id"列表- 文档转至 wiki 页面
v2.2.1 更新说明
- API 发布到 PyPI ，直接使用
pip install lanzou-api即可安装依赖
v2.2 更新说明
- 修复了文件和文件夹 id 冲突的问题(导致部分 API 接口参数变化)
- 修复了蓝奏云网页变化导致文件(夹)无法下载的问题 #4
- 修复了上传 rar 分卷文件被 ban 的问题
- 修复了无后缀文件上传出错的问题
- 修复了文件中空白字符导致上传和解压失败的问题
- 修复偶尔出现的 SSL 握手错误
v2.1 更新说明
- 修复了蓝奏云分享链接格式变化导致无法获取直链的问题