Qt+Pyhton实现麒麟V10系统下word文档读写功能

- - 前言
  - 1.C++调用python
  - - 1.1 安装Python开发环境
    - 1.2 修改Qt工程配置
    - 1.3 初始化Python环境
    - 1.4 C++ 调用Python 函数
    - 1.5 常用的Python接口
  - 2.python虚拟环境
  - - 2.1Python虚拟环境简介
    - 2.2 virtualenv 安装及使用
    - 2.3 在C++程序中配置virtualenv 虚拟环境
  - 3.python-docx库的应用
  - 4.总结

前言

我最近遇到一个这样的需求，即把某个软件中采集的数据按照特定的格式导出到world文档中。因为程序是用Qt开发的，所以想找一个满足要求的C++库，通过一番查询发现能完成这个需求的常用C++库有LibreOffice、OpenOffice。这两个库虽然能实现这一需求但是学习成本比较高，在规定的时间内完成这个需求比较困难。

这时只能将目光转向其他语言的读写word文档的库上，我发现python-docx 这个库不仅能实现需求而且学习成本很低，只要懂点Python几乎不需要额外花时间就能学会使用这个库。

本文主要从三个方面介绍了如何在Qt应用程序中调用Python实现数据导出到world文档中。这三个方面分别是C++调用python、在程序中使用Python虚拟环境及Python-docx库的基本应用。

1.C++调用python

1.1 安装Python开发环境

麒麟V10 默认安装了python3.8，但是没有安装C++调用Python需的头文件，在系统中找不到Python.h文件。安装Python 开发环境，执行下面的命令：

sudo apt-get update 
sudo apt-get install python3-dev

安装完成后会在/usr/include/python3.8 目录下看到需要的头文件。

1.2 修改Qt工程配置

新建Qt工程demo，并在pro文件中增加Python头文件和库的引用。

INCLUDEPATH += /usr/include/python3.8
LIBS += -L/usr/lib/python3.8/config-3.8-aarch64-linux-gnu -lpython3.8

1.3 初始化Python环境

 	//初始化Python C APIPy_Initialize();//将Python文件所在的目录添加到环境变量，以便能正确加载Python文件。PyRun_SimpleString("import sys");QString pyfilePath = QString::fromLocal8Bit("sys.path.append('%1')").arg(qApp->applicationDirPath() + "/python");qDebug() << "pyfilePath:" << pyfilePath;PyRun_SimpleString(pyfilePath.toLocal8Bit().data());QString printSysPath = "print(sys.path)";PyRun_SimpleString(printSysPath.toLocal8Bit().data());//加载Python文件，其中testdocx.py 所在的目录即为 qApp->applicationDirPath() + /python/testdocx.pyPyObject *pWriteWordModule = PyImport_ImportModule("testdocx");if(!pWriteWordModule){qDebug() << "import module faild!";//如果失败打印错误，方便调试PyErr_Print();}

上面的代码，首先初始化Python环境，然后设置Python文件搜索路径到path中，最后加载testdocx.py 文件。

1.4 C++ 调用Python 函数

假设testdocx.py 文件中的内容如下，定义了一个函数，并打印传进来的参数。

def writeWord(wordPath):print(wordPath)

在C++中调用这个函数

	//获取Python中定义的函数的指针PyObject *pFunc = PyObject_GetAttrString(pWriteWordModule, "writeWord");if(!pFunc){qDebug() << "get func faild!";}//初始化参数元组，其中包含一个参数PyObject *pTuple = PyTuple_New(1);QString wordFilePath = QString("%1/python/%2").arg(qApp->applicationDirPath()).arg(QString::fromLocal8Bit("xxx.docx"));//设置参数PyTuple_SetItem(pTuple, 0, Py_BuildValue("s", wordFilePath.toLocal8Bit().data()));//调用Python中的函数PyObject_CallObject(pFunc, pTuple);

运行程序，如果一切顺利的话会在终端打印：
/home/demo/bin/python/xxx.docx

1.5 常用的Python接口

Python C API参考文档地址
在这里插入图片描述

PyObject 在C++和Python混合编程中最常用的一个类型，所有对象类型都是这个类型的扩展。PyObject中包含了Python需要将对象的指针视为对象的信息。在一般的“release”版本中，它只包含对象的引用计数和指向相应类型对象的指针。实际上并没有任何东西被声明为PyObject，但是每个指向Python对象的指针都可以转换为PyObject*。必须使用宏Py_REFCNT和Py_TYPE来访问成员。下面是一些编程中常用的Python C API。

PyList_New 创建一个Python list 对象，返回类型为PyObject*；
PyDict_New 创建一个Python Dict 对象，返回类型为PyObject*；
PyTuple_New 创建一个Python 元组对象，返回类型为PyObject*；
Py_BuildValue 将C数据类型转换为Python对象，返回类型为PyObject*，下面是Py_BuildValue函数的原型：
PyObject* Py_BuildValue(const char* format, …);其中，format是一个描述返回的Python对象的格式字符串，而…表示可变数量的参数列表，这些参数与格式字符串中指定的类型相对应。
下面是一些常见的格式字符串和相应的参数列表：
‘()’：表示一个空元组。
‘(i)’：表示一个包含一个整数（参数为整数）的元组。
‘(ii)’：表示一个包含两个整数（参数为两个整数）的元组。
‘s’：表示一个字符串。
‘d’：表示一个浮点数。
‘z’：表示一个NULL指针或None。
‘O’：表示一个通用对象。
下面是一个示例，演示如何使用Py_BuildValue函数将C数据类型转换为Python对象：

#include <Python.h>
int main(int argc, char* argv[]) {Py_Initialize();int x = 42;double y = 3.14;char* z = "Hello, World!";PyObject* result = Py_BuildValue("(iO)", x, Py_None);if (result == NULL) {PyErr_Print();return 1;}printf("Result: %s\n", PyUnicode_AsUTF8(result));Py_DECREF(result);Py_Finalize();return 0;
}

PyDict_SetItemString 设置字典键值对；

//函数原型
PyAPI_FUNC(int) PyDict_SetItemString(PyObject *dp, const char *key, PyObject *item);
//示例：
PyObject* pDictObj = PyDict_New();
PyObject* deviceNameObj = Py_BuildValue("s", deviceData.deviceName.toLocal8Bit().data());
PyDict_SetItemString(pDictObj, "deviceName", deviceNameObj);

PyList_Append 向列表中添加元素；

//函数原型
PyAPI_FUNC(int) PyList_Append(PyObject *, PyObject *);
//示例：
PyObject *PointDataListObj = PyList_New(0);
PyList_Append(PointDataListObj, pDictObj);

PyRun_SimpleString 在Python解释器中执行一个简单的 Python 代码字符串;

//函数原型
int PyRun_SimpleString(const char *command);
//示例
const char* code = "print('Hello, World!')";
int result = PyRun_SimpleString(code);
if (result == 0) {//执行成功printf("Successfully executed code.\n");
} else {//执行失败printf("Failed to execute code.\n");
}

PyImport_ImportModule 在C程序中导入Python模块；

//函数原型
PyObject* PyImport_ImportModule(const char *name);
//说明，该函数返回一个Python对象，表示导入的模块。如果导入成功，则返回该模块对象的引用，否则返回NULL。
//示例：
PyObject* mymodule = PyImport_ImportModule("mymodule");
if (mymodule != NULL) {printf("Successfully imported mymodule.\n");
} else {printf("Failed to import mymodule.\n");
}

PyObject_CallObject 在C中调用Python对象的方法和函数；

//函数原型
PyObject* PyObject_CallObject(PyObject *callable, PyObject *args);
//说明，callable是一个指向要调用的Python对象（如函数或方法）的指针，args是一个指向参数列表的指针。
//该函数返回调用结果，表示为Python对象。如果调用成功，则返回调用结果的引用，否则返回NULL。//示例：
PyObject* mymodule = PyImport_ImportModule("mymodule");
PyObject* myfunction = PyObject_GetAttrString(mymodule, "myfunction");
PyObject* args = PyTuple_New(1);
PyTuple_SetItem(args, 0, PyLong_FromLong(42));PyObject* result = PyObject_CallObject(myfunction, args);
if (result != NULL) {printf("Function returned: %ld\n", PyLong_AsLong(result));
} else {printf("Failed to call function.\n");
}

PyErr_Print 用于将当前错误信息打印到标准错误输出，方便调试程序。

2.python虚拟环境

2.1Python虚拟环境简介

virtualenv和anaconda都是用于创建Python虚拟环境的工具，二者的主要区别如下：

包管理器：virtualenv使用pip作为包管理器，而anaconda使用conda作为包管理器。
环境隔离：virtualenv只能隔离Python包，而anaconda可以隔离整个Python环境及其依赖项。
系统依赖：anaconda自带了许多科学计算所需的系统依赖，而virtualenv则需要手动安装这些依赖。
平台支持：anaconda支持Windows、Linux和MacOS等多个平台，而virtualenv则主要支持Linux和MacOS。

在这里选择virtualenv，原因是anaconda 在飞腾架构的麒麟系统上安装失败。

2.2 virtualenv 安装及使用

1.安装

 sudo apt-get install pippip install virtualenv

2.创建虚拟环境

cd /home/demo/bin/python
virtualenv demoEnv
#或者指定Python版本
virtualenv -p /usr/bin/python3.8 demoEnv

3.激活虚拟环境

demoEnv\Scripts\activate

4.安装依赖包

pip install -r requirements.txt
pip install python-docx

5.退出虚拟环境

demoEnv\Scripts\deactivate

2.3 在C++程序中配置virtualenv 虚拟环境

demo程序利用了系统自带的Python3.8环境，所以在C++程序中只需配置好虚拟环境的包安装目录即可，这点是参考在终端通过命令执行Python脚本时的环境设置。例如执行下面的命令来查看当前Python环境的path内容：

python3 test.py
#其中 test.py 内容如下
import sys
print(sys.path)

因此Qt程序中Python环境初始化部分要增加设置Python虚拟环境安装包路径的代码，如下：

    QString modulePath = QString::fromLocal8Bit("sys.path.append('%1')").arg(qApp->applicationDirPath() + "/python/demoEnv/lib/python3.8/site-packages");PyRun_SimpleString(modulePath.toLocal8Bit().data());

经过上述设置就可以在虚拟环境中用pip命令安装应用程序所需的python包，并在应用程序所在目录的python文件中使用第三方包，如python-docx。当Qt程序需要发布到其他飞腾架构的麒麟V10设备上时，可以直接把虚拟环境一起打包，省去了在新的设备安装依赖包的步骤。

3.python-docx库的应用

官方参考文档https://python-docx.readthedocs.io
在这里插入图片描述
python-docx 作为word文档读写库算是很轻量了，其涉及的概念不多，很容易理解与掌握。下面是python-docx的一些核心概念。

Document 表示word文档。
Text 表示word文档中的文本和段落。
Section 表示页面布局，方向相同的页面。
Headers 、 Footers 表示页眉页脚
Table 表格
Image 图片

下面是一个快速上手指南：

打开一个word文档

from docx import Document
document = Document()

添加一个段落

paragraph = document.add_paragraph('Lorem ipsum dolor sit amet.')
或
prior_paragraph = paragraph.insert_paragraph_before('Lorem ipsum')

添加页眉

document.add_heading('The REAL meaning of the universe')
或
document.add_heading('The role of dolphins', level=2)

添加分页符

document.add_page_break()

添加表格

table = document.add_table(rows=2, cols=2)
cell = table.cell(0, 1)
cell.text = 'parrot, possibly dead'
row = table.rows[1]
row.cells[0].text = 'Foo bar to you.'
row.cells[1].text = 'And a hearty foo bar to you too sir!'
for row in table.rows:for cell in row.cells:print(cell.text)
row_count = len(table.rows)
col_count = len(table.columns)
row = table.add_row()
# get table data -------------
items = ((7, '1024', 'Plush kittens'),(3, '2042', 'Furbees'),(1, '1288', 'French Poodle Collars, Deluxe'),
)# add table ------------------
table = document.add_table(1, 3)# populate header row --------
heading_cells = table.rows[0].cells
heading_cells[0].text = 'Qty'
heading_cells[1].text = 'SKU'
heading_cells[2].text = 'Description'# add a data row for each item
for item in items:cells = table.add_row().cellscells[0].text = str(item.qty)cells[1].text = item.skucells[2].text = item.desc
table.style = 'LightShading-Accent1'

添加一个图片

document.add_picture('image-filename.png')
#设置图片尺寸
from docx.shared import Inches
document.add_picture('image-filename.png', width=Inches(1.0))

4.总结

以上就是本篇的所有内容了，关于python-docx应用的一些细节本文并未涉及太多，想要了解更多的话还是要阅读官方文档。对C++ python混合编程有疑问的朋友欢迎留言讨论！！！