XXX程序 详细说明

用于记录理解PC程序的程序逻辑

1、程序的作用

根据原作者的说明（文件说明.txt），该程序 (PC.py) 的主要作用是提取某一个文件夹中的某个设备 (通过config中的信息看出来是Ag_T_8) 产生的日志文件，然后提取其中某些需要的数据，进行处理后放进数据库中

文件的主要部分就只有PC.py这一个程序，剩下的都是为他服务的，原作者将.py文件打包成了.exe文件并设置为后台运行

2、涉及到的主要的库

1. Mqtt：MQTT 是一个轻量的发布订阅模式消息传输协议，专门针对低带宽和不稳定网络环境的物联网应用设计，可以理解为这玩意就是用来进行不同软件之间地通信

   mqtt的主要分为三个部分，分别是服务端broker和各种客户端(这里用的是paho-mqtt )，客户端想要与服务器连接需要知道客户端的四个信息，分别是： broker服务端的 ① 地址；② 端口；③ 主题和 ④ 客户端的ID，这四个信息在config.json文件中进行设置，分别对应mqtt_broker、mqtt_port、mqtt_topic、mqtt_client_id

注意：原作者将所有有关于mqtt的内容全部都注释掉了，并没有用到mqtt通信，但是config中关于mqtt的配置信息还是要填写的，否则会因为读取而报错，这因该是原作者之前的开发者出于另外的目的配置的，这里可以直接忽略

2. pyodbc：一个用来进行数据库操作的库，这里作者用的是pypyodbc(pyodbc的纯python实现版)，可以理解为是将读取到的文件写入到数据库中的工具。
   数据库可以看作是一个excel表，pyodbc可以对这个表格进行增删改查等操作，但是与excel不同的是数据库是使用一行一行的命令进行操作的，而且在使用之前需要进行连接，连接需要用到的参数和config.json中对应的参数为:
   ①数据库的IP地址/mssql_ip；
   ② 数据库的端口号/mssql_port；
   ③ 登陆的用户名/mssql_user；
   ④ 该用户名对应的密码/ mssql_password;
   ⑤ 登陆的数据库的名称/ mssql_db

3. watchdog: 这里就当作是一个用来监听某个文件夹中的文件是否有变化的的库就够了

3、业务逻辑

所有的数据处理啥的都封装在FileHandler中，当程序启动后会运行FileWatcher类中的run函数，这个run函数会执行FileHandler类
1、当config.json中"log_path"对应的文件夹中有新的文件生成，会在日志文件logging.conf中进行记录
2、如果生成的这个新的文件不是以.dat结尾的就不进行操作
3、如果是以.dat结尾的就读取这个.dat文件并提取相关信息
4、原作者在datalog中给了6个测试案例，这里以第一个文件1_2111001232800464_230719211823.dat为例，说明从中提取了哪些信息
5、首先是从整个文件的前两行提取reference,sn,start_time,end time和cycle_time，具体的提取情况见：

6、之后总览后面所有的文字，如果出现了 “|01” 这个玩意就表示有错误产生，然后一行一行的看，找到这玩意出现的哪那一行，提取出error code，这个文件的第235行出现了 “|01” ，提取出error code 为 1%led1_color，见下图：

7、如果有错误产生，result为fail,error code 就是上面这样提取的error code，如果没有错误产生，result为pass, error code 为None

8、另外，在config.json中还有两个参数 ：“equipment_code” 和 “equipment_name”，这两个对应的值也会被记录下来

9、所有记录的值如下图：

10、一共得到了10个参数，全部写入到数据库中，他们在数据库中的名字分别为：
reference, sn, test_result, error_code, create_time, equipment_name, equipment_code, start_time, end_time, cycle_time。 都是以字符串的形式写入的

---

其他说明

需要配置的东西：
只需要设置config文件夹中的config.dat文件，其中各个参数的意义为：

注意：要想运行这个程序需要用到一些其他的python库和数据库，可以直接运行这个.py文件也可以打包成.exe文件运行，如果要打包就是另外的东西了，.spec文件就是和打包有关的设置，和这个程序的运行逻辑没啥关系，如果要了解打包的相关操作可以看看pyinstaller库