office-tool-plus 0.0.8

基于 Python 开发的自动化 office 工具包

安装

office-tool-plus 一些自动化办公的工具包

# 国内源
pip install --upgrade office-tool-plus -i https://mirrors.aliyun.com/pypi/simple/ 
# 官方源（最新版）
pip install --upgrade office-tool-plus -i https://pypi.org/simple  

使用

excel

single_to_pdf(excel_path: str, sheet_names: list = None, pdf_dir: str = None):

将指定Excel工作簿中的工作表导出为PDF格式。

参数：

• excel_path: Excel文件的路径。
• sheet_names: 需要导出的工作表名称列表。如果未提供，则默认导出所有工作表。
• pdf_dir: PDF文件的保存目录。如果未提供，则默认保存在Excel文件的同目录下。

返回：

• pdf_path: 导出的PDF文件路径。

示例：

from office_tool_plus import ExcelTools

excel = ExcelTools()
# 将整个 Excel 导出为 pdf，并保存在源目录下
excel.single_to_pdf('test.xlsx')
# 将整个 Excel 导出为 pdf，并保存在 output 目录下
excel.single_to_pdf('test.xlsx', pdf_dir='output')
# 将指定 sheet 导出为 pdf，并保存在源目录下
excel.single_to_pdf('test.xlsx', ['Sheet1', 'Sheet2'])
# 将指定 sheet 导出为 pdf，并保存在 output 目录下
excel.single_to_pdf('test.xlsx', ['Sheet1', 'Sheet2'], 'output')

many_to_pdf(excel_dir: str, suffix: list = None, recursive=True, pdf_dir: str = None):

将指定目录下的Excel文件批量导出为PDF格式。

参数：

• excel_dir: Excel文件的目录路径。
• suffix: 需要导出的文件后缀名列表。如果未提供，则默认导出["*.xlsx", "*.xls"]
• recursive: 是否递归搜索子目录。如果为True，则递归搜索子目录，否则只搜索当前目录。
• pdf_dir: PDF文件的保存目录。如果未提供，则默认保存在Excel文件的同目录下。

返回：

• None

示例：

from office_tool_plus import ExcelTools

excel = ExcelTools()
# 将 test 目录下（包含子目录）所有的 Excel 文件批量导出为 pdf，并保存在源目录下
excel.many_to_pdf('test')
# 将 test 目录下（包含子目录）所有的 Excel 文件批量导出为 pdf，并保存在 output 目录下
excel.many_to_pdf('test', pdf_dir='output')
# 将 test 目录下（不包含子目录）所有的 Excel 文件批量导出为 pdf，并保存在源目录下
excel.many_to_pdf('test', recursive=False)
# 将 test 目录下（不包含子目录）,后缀是 *.xlsx 的 Excel 文件批量导出为 pdf，并保存在 output 目录下
excel.many_to_pdf('test', suffix=['*.xlsx'], recursive=False, pdf_dir='output')

word

single_to_pdf(word_path: str, pdf_dir: str = None):

将指定的Word文档导出为PDF格式。

参数：

• word_path: Word文件的路径。
• pdf_dir: PDF文件的保存目录。如果未提供，则默认保存在Word文件的同目录下。

返回：

• pdf_path: 导出的PDF文件路径。

示例：

from office_tool_plus import WordTools

word = WordTools()
# 将指定的 Word 导出为 pdf，并保存在源目录下
word.single_to_pdf('test.docx')
# 将指定的 Word 导出为 pdf，并保存在 output 目录下
word.single_to_pdf('test.docx', pdf_dir='output')

many_to_pdf(word_dir: str, suffix: list = None, recursive=True, pdf_dir: str = None):

将指定目录下的Word文件批量导出为PDF格式。

参数：

• word_dir: Word文件的目录路径。
• suffix: 需要导出的文件后缀名列表。如果未提供，则默认导出["*.docx", "*.doc"]
• recursive: 是否递归搜索子目录。如果为True，则递归搜索子目录，否则只搜索当前目录。
• pdf_dir: PDF文件的保存目录。如果未提供，则默认保存在Word文件的同目录下。

返回：

• None

示例：

from office_tool_plus import WordTools

word = WordTools()
# 将 test 目录下（包含子目录）所有的 Word 文件批量导出为 pdf ，并保存在源目录下
word.many_to_pdf('test')
# 将 test 目录下（包含子目录）所有的 Word 文件批量导出为 pdf，并保存在 output 目录下
word.many_to_pdf('test', pdf_dir='output')
# 将 test 目录下（不包含子目录）所有的 Word 文件批量导出为 pdf，并保存在源目录下
word.many_to_pdf('test', recursive=False)
# 将 test 目录下（不包含子目录）,后缀是 *.docx 的 Word 文件批量导出为 pdf，并保存在 output 目录下
word.many_to_pdf('test', suffix=['*.docx'], recursive=False, pdf_dir='output')