导表工具

项目主页：https://github.com/youlanhai/ExcelToCode

Excel文件：

转换后的python数据表：

# -*- coding: utf-8 -*-
# 此文件由导表工具自动生成，禁止手动修改。
# from example.xlsx

# A ID                  编号
# B name                名称
# C describe            描述
# D quality             品质
# E drop                掉落关卡
main_sheet = {
    1: {"describe": "切菜用的", "drop": [1, 2, 3, 4, ], "name": "菜刀", "quality": 1, },
    2: {"drop": [2, ], "name": "上方宝剑", "quality": 5, },
    3: {"name": "偃月弯刀", "quality": 0, },
}

原理

1. 构造exporter对象，开始整个导表流程
2. 搜索INPUT_PATH路径下的所有Excel文件
3. 构造parser对象，将Excel数据转换成python格式的中间数据表
4. 如果定义了后处理操作，exporter将对数据表执行后处理操作。比如表头合并，合法性检查
5. 实例化writer对象，将python表转换成最终的python、lua、json等格式的数据表。

准备

• python 2.7
• 安装python插件openpyxl。使用pip install openpyxl安装，或者在config文件配置DEPENDENCIES项，指定openpyxl的安装包路径，导表工具会自动安装。

工具用法

python main.py --export your_configure_file

main导表参数 | 说明 ------------|-------- config_file | python格式的配置文件。配置文件的详细写法，参考配置文件参数详解 --gen-code | 生成类代码，目前仅支持Java。需要在config文件中，指定代码生成器参数CODE_GENERATORS --export | 执行导表 --fast-mode | 快速模式，仅重新解析最近修改过的Excel表。解析Excel表的过程非常慢，快速模式会使用已经生成的中间文件来避免二次解析Excel表 --force-run | 出错后是否继续进行导表。常用于发现更多的错误 --gen-header| 根据转换器描述信息，自动生成表头

范例

见samples目录。direct-mode目录下的例子使用的是直接模式(Direct)，config-mode目录下的例子使用的是配置模式(Config)，mix-mode目录下的例子使用的是混合模式(Mix)。

文件名称 | 描述 --------|--------- config.py | 导表工具配置文件 export.bat/export.sh | 导表批处理文件 excels | 存放excel文件所在目录 converters | 转换器父级目录 converters/converter | 转换器脚本存放路径

文档

1. 配置文件参数详解
2. 表格添加方法

路径说明

路径 | 说明 ------|------- codegen | 代码生成器。如，生成Java代码 doc | 文档 exporters | 导出器。用于将excel表转换成相应的数据结构 parsers | excel解析器。解析单个excel表格 postprocess | 后处理器。导表结束后，可以执行一些额外的操作。比如，移动文件目录，生成文件列表等 samples | 一些例子 tps | 通用类型转换器。用于将数据转换成具体的Python数据类型 writers | 写出器。用于将Python数据表，写出成不同格式的数据表。如，Lua、Json等。