LanZouCloud API
Project description
- 蓝奏云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
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
->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
更新说明
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
lanzou-api-2.6.10.tar.gz
(35.9 kB
view hashes)
Built Distribution
Close
Hashes for lanzou_api-2.6.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4d85e60ae857e0b2860c349262200bb76e9f4dd4eaf2fffe34f29d7d82f36fd6 |
|
MD5 | 2373234776379e7ebc5c6a18be4a8504 |
|
BLAKE2b-256 | c0d90ed4187662baef2d45adc5a4e4f2edc6e548ef8c8743b04e70e858343620 |