GitLocker: The Coding Marketplace

Description:

pythondupan 0.0.1.3.8

百度网盘 Web API 的 Python 封装

安装
通过 pypi
pip install -U python-dupan

入门介绍
1. 导入模块和创建实例
导入模块
from dupan import DuPanClient, DuPanFileSystem

创建客户端对象，需要传入 cookie，如果不传或者 cookie 失效，则需要扫码登录
cookie = "BDUSS=...;STOKEN=..."
client = DuPanClient(cookie)

创建文件系统对象
fs = DuPanFileSystem(client)

或者直接在 client 上就可获取文件系统对象
fs = client.fs

或者直接用 DuPanFileSystem 登录
fs = DuPanFileSystem.login(cookie)

2. 操作网盘使用 Python 式的文件系统方法
文件系统对象的方法，设计和行为参考了 os、posixpath、pathlib.Path 和 shutil 等模块。
dupan.DuPanFileSystem 实现了读写的文件系统方法。

方法
说明
参考

__contains__()path in fs
判断路径是否存在
exists()

__delitem__()del fs[path]
删除文件或目录
rmtree()

__getitem__()fs[path]
获取路径对应的 dupan.DuPanPath 对象
as_path()

__iter__()iter(fs)
遍历目录，获取 dupan.DuPanPath 对象的迭代器
iter(max_depth=-1)

__itruediv__()fs /= path
切换当前工作目录
chdir()

__len__()len(fs)
获取当前目录的直属文件和目录数

__repr__()repr(fs)
获取对象的字符串表示

__setitem__()fs[path] = data
替换文件或上传目录等
touch()upload()upload_tree()write_bytes()write_text()

abspath()
获取绝对路径
posixpath.abspath

as_path()
获取路径对应的 dupan.DuPanPath 对象

attr()
获取文件或目录的属性

chdir()cd()
切换当前工作目录
os.chdir

copy()cp()
复制文件
shutil.copy

copytree()
复制文件或目录
shutil.copytree

download()
下载文件
暂不可用

download_tree()
下载文件或目录
暂不可用

exists()
判断文件或目录是否存在
posixpath.exists

getcwd()pwd()
获取当前工作目录的路径
os.getcwd

get_url()
获取文件的下载链接

glob()
遍历目录并用通配符模式筛选
glob.iglobpathlib.Path.glob

isdir()
判断是否存在且是目录
posixpath.isdir

isfile()
判断是否存在且是文件
posixpath.isfile

is_empty()
判断是否不存在、空文件或空目录

iter()
遍历目录，获取 dupan.DuPanPath 对象的迭代器

iterdir()
迭代目录，获取 dupan.DuPanPath 对象的迭代器
pathlib.Path.iterdir

listdir()ls()
罗列目录，获取文件名列表
os.listdir

listdir_attr()la()
罗列目录，获取文件属性 dict 列表

listdir_path()ll()
罗列目录，获取 dupan.DuPanPath 对象列表

makedirs()
创建多级的空目录
os.makedirs

mkdir()
创建空目录
os.mkdir

move()mv()
对文件或目录进行改名或移动，如果目标路径存在且是目录，则把文件移动到其中（但是目录中有同名的文件或目录，还是会报错）
shutil.move

open()
打开文件（只支持读，如果要写，请用 write_bytes 或 upload 替代）
openio.open暂不可用

read_bytes()
读取文件为二进制
pathlib.Path.read_bytes暂不可用

read_bytes_range()
读取文件为二进制
暂不可用

read_block()
读取文件为二进制
暂不可用

read_text()
读取文件为文本
pathlib.Path.read_text暂不可用

remove()rm()
删除文件
os.remove

removedirs()
（自底向上地）删除多级的空目录
os.removedirs

rename()
对文件或目录进行改名或移动
os.rename

renames()
对文件或目录进行改名或移动，然后对原来所在目录执行 removedirs
os.renames

replace()
对文件或目录进行改名或移动，并且如果原来路径上是文件，目标路径上也存在同名文件，则会先把后者删除
os.replace

rglob()
遍历目录并用通配符模式筛选
pathlib.Path.rglob

rmdir()
删除空目录
os.rmdir

rmtree()
删除文件或目录
shutil.rmtree

scandir()
迭代目录，获取 dupan.DuPanPath 对象的迭代器
os.scandir

stat()
获取文件状态 os.stat_result 信息
os.stat

touch()
访问路径，如果不存在则新建空文件
pathlib.Path.touch暂不可用

upload()
上传文件
暂不可用

upload_tree()
上传目录
暂不可用

unlink()
删除文件
os.unlink

walk()
遍历目录，获取文件名列表
os.walk

walk_attr()
遍历目录，获取文件属性 dict 列表

walk_path()
遍历目录，获取 dupan.DuPanPath 对象列表

write_bytes()
向文件写入二进制
pathlib.Path.write_bytes暂不可用

write_text()
向文件写入文本
pathlib.Path.write_text暂不可用

dupan.DuPanPath 实现了二次封装，从路径的角度来进行操作。
3. 遍历文件系统和查找文件
1. 获取当前目录下所有 .mkv 文件的 url
第 1 种方法，使用 iter，返回 dupan.DuPanPath 对象的迭代器
for path in fs.iter(max_depth=-1):
if path.name.endswith(".mkv"):
print(path.url)

第 2 种方法，使用 glob，参考 pathlib.Path.glob 和 glob.iglob，使用通配符查找
for path in fs.glob("**/*.mkv"):
print(path.url)

第 3 种方法，使用 rglob，参考 pathlib.Path.rglob
for path in fs.rglob("*.mkv"):
print(path.url)

文档

正在编写中