0.2版本迁移指南
大约 1 分钟
V0.2.0 破坏性更新
返回参数更新
取消了version
参数,统一返回值为一个包含三个元素的元组 (list1, list2, bool)
,其顺序与输入文件顺序保持一致:
list1
(list
): 成功处理的文件路径列表- 元素为处理后的文件路径(字符串)
- 处理失败时为空字符串
list2
(list
): 处理失败的文件列表- 元素为字典,包含两个键:
'error'
: 错误信息(字符串)'path'
: 处理失败的文件路径(字符串)
- 处理成功时,两个键的值均为空字符串
- 元素为字典,包含两个键:
bool
: 处理状态True
: 至少有一个文件处理失败False
: 全部文件处理成功
如何最小化修改以适应更新
如果您的旧版本代码并没有使用version参数,例如:
from pdfdeal.doc2x import Doc2X
client = Doc2X()
filepath = client.pdf2file(
"tests/pdf/sample.pdf", output_names=["Test.zip"], output_format="latex"
)
print(filepath)
所有函数的返回值在新版本中变为了三个值,(list1, list2, bool)
,您仅需要更改第4行:
from pdfdeal.doc2x import Doc2X
client = Doc2X()
filepath, failed, flag = client.pdf2file(
"tests/pdf/sample.pdf", output_names=["Test.zip"], output_format="latex"
)
print(filepath)
如果您的代码 使用了version="v2" 参数,例如:
from pdfdeal.doc2x import Doc2X
from pdfdeal import get_files
client = Doc2X()
file_list, rename_list = get_files(
path="./tests/pdf", mode="pdf", out="docx"
)
success, failed, flag = client.pdf2file(
pdf_file=file_list,
output_path="./Output/newfolder",
output_names=rename_list,
output_format="docx",
version="v2",
)
print(success)
print(failed)
print(flag)
您仅需要删除version="v2",
即可:
from pdfdeal.doc2x import Doc2X
from pdfdeal import get_files
client = Doc2X()
file_list, rename_list = get_files(
path="./tests/pdf", mode="pdf", out="docx"
)
success, failed, flag = client.pdf2file(
pdf_file=file_list,
output_path="./Output/newfolder",
output_names=rename_list,
output_format="docx",
)
print(success)
print(failed)
print(flag)