<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`

修复 pickle 库反序列化导致内存溢出的问题#65
更换为最新域名, 防止解析失败#68

`v2.6.5`

修复蓝奏云主域名解析异常的问题#59 #60

`v2.6.4`

修复无法获取分享文件夹信息的问题#58

`v2.6.3`

修复下载页的 Cookie 验证问题#55

`v2.6.2`

修复文件后缀非小写导致的误判问题#92

`v2.6.1`

修复下载某些 txt 文件失败的问题#53
修复判断文件(夹)是否存在提取码功能异常的问题

`v2.6.0`

修复无法上传文件的问题 #52
修复 login() 函数(只对某些用户有效) #50
新增 11 种允许上传的文件格式#90
修复会员自定义文件夹 URL 识别错误的问题#84

`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`

修复文件删除后解析无效分享链接崩溃的问题 #36
下载同名文件时重命名优化 #37

`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() 即时处理失败文件，不再等待全部任务完成后返回失败列表。