lanzou-api 2.6.10

LanZouCloud API

- 蓝奏云API -

简介

• 本库封装了蓝奏网盘的基础功能: 登录、注销、获取文件(夹)列表、下载文件、上传文件、删除文件(夹)、 移动文件、清空回收站、恢复文件(夹)、创建文件夹、设置文件(夹)访问密码、设置文件(夹)描述

• 解决了蓝奏云的上传格式限制和单文件大小限制，同时增加了以下功能: 批量上传/下载文件、 上传/下载时断点续传、清理"幽灵"文件夹、移动文件夹、获取下载直链

• 如果有任何问题或建议, 欢迎提 issue, 维护不易，求一个 star (*/ω＼*)

免责声明

• 本项目仅供个人学习使用，严禁用于商业用途
• 本项目没有任何担保，如果您使用这些代码，您必需承担其带来的风险

API 文档

• dev 分支用于修复错误，待稳定后再推到 master 分支
• master 分支将自动发布到 PyPI，使用 pip install lanzou-api 即可安装
• API 文档请查看 wiki 页面

更新日志

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

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 -> list
  • get_file_list() 返回的信息增多，格式 dict -> list
  • get_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 更新说明

• 修复了蓝奏云分享链接格式变化导致无法获取直链的问题

v2.0 更新说明

• 修复了登录时 formhash 错误的问题
• 解决了多次上传大文件被限制的问题 #3
• 细化 API 接口的功能，某些接口被取消、更名
• 操作网盘时会进行检查，屏蔽蓝奏云不合理的设计
• 支持批量上传/下载
• 上传大文件不再直接将数据分段，改用 RAR 分卷压缩 #2
• 取消使用种子文件下载大文件，自动识别分卷压缩文件并解压
• 上传/下载时支持使用回调函数显示进度 #1
• 不再向上抛异常，而是返回错误码