Skip to content

Latest commit

 

History

History
78 lines (65 loc) · 3.14 KB

README.md

File metadata and controls

78 lines (65 loc) · 3.14 KB
Raw

导表工具

项目主页：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等。