一个精简实用的导出 xlsx 配置到 lua 的 python 工具。借助 xlsx_to_lua 可以让你更轻易的把 xlsx 的配置导出到对应的 lua 文件，并预生成其在 lua 所对应的数据结构。
- GitHub：https://github.com/xasset/xlsx_to_lua
- QQ群: 693203087
主要特性与功能
- 基于多核编程，内建增量的批量和单文件导出机制
- 预生成 xlsx 配置对应的 lua 数据结构，无需在 lua 中进行二次解析
- 支持 nokey、onekey、towkey、keyvalue 样式的 lua 导出，具体参考下面的配置导出示例
配置导出示例
keyvalue
适用于配置是 keyvalue 关系，且 value 只有一列的情况
lua
-- keyvalue.lua export from workbook test.xlsx with sheet keyvalue
-- format: [id]=value
return {
[0]='value_0',
[1]='value_1',
[2]='value_2',
}
sheet
| name | keyvalue | |
|---|---|---|
| key | id | |
| lua_mode | key-value | |
| field | id | value |
| type | int | any |
| value | 0 | value_0 |
| value | 1 | value_1 |
| value | 2 | value_2 |
nokey
适用于配置无需要用 key 取值，value 是一个有序的 table
lua
-- nokey.lua export from workbook test.xlsx with sheet nokey
-- format: {id,type,name,cond}
return {
field = {'id','type','name','cond'},
value = {
{0,0,'name_0',{type=0}},
{1,1,'name_1',{type=1}},
{2,2,'name_2',{type=2}},
},
count = 6,
}
sheet
| name | nokey | |||
|---|---|---|---|---|
| field | id | type | name | cond |
| type | int | int | string | table |
| value | 0 | 0 | name_0 | { type = 0 } |
| value | 1 | 1 | name_1 | { type = 1 } |
| value | 2 | 2 | name_2 | { type = 2 } |
onekey
适用用 key 取值，value 是一个按 keyvalue 映射 的 table
lua
-- onekey.lua export from workbook test.xlsx with sheet onekey
-- format: [id]={id,type,name,cond}
return {
field = {'id','type','name','cond'},
value = {
[0]={0,0,'name_0',{type=0}},
[1]={1,1,'name_1',{type=1}},
[2]={2,2,'name_2',{type=2}},
},
count = 6,
}
sheet
| name | onekey | |||
|---|---|---|---|---|
| key | id | |||
| field | id | type | name | cond |
| type | int | int | string | table |
| value | 0 | 0 | name_0 | { type = 0 } |
| value | 1 | 1 | name_1 | { type = 1 } |
| value | 2 | 2 | name_2 | { type = 2 } |
morekey
同 onekey，但key可以有多个，多个之间用 - 连接起来合成一个新 key，格式参考 format
lua
-- morekey.lua export from workbook test.xlsx with sheet morekey
-- format: [id-type]={id,type,name,cond}
return {
field = {'id','type','name','cond'},
value = {
['0-0']={0,0,'name_0',{type=0}},
['1-1']={1,1,'name_1',{type=1}},
['2-2']={2,2,'name_2',{type=2}},
},
count = 6,
}
sheet
| name | morekey | |||
|---|---|---|---|---|
| key | id | type | ||
| field | id | type | name | cond |
| type | int | int | string | table |
| value | 0 | 0 | name_0 | { type = 0 } |
| value | 1 | 1 | name_1 | { type = 1 } |
| value | 2 | 2 | name_2 | { type = 2 } |
功能与参数
导出 xlsx 到 lua
命令行输入 python3.8 xlsx_to_lua.py，可以用来将 in_dir 下的所有 xlsx 文件的数据，按预定的格式导出到 out_dir 下对应的 lua 文件中
| 选项 | 含义 |
|---|---|
| -f | 要导出的单个文件，默认 None |
| -i | 指定 in_dir，即 xlsx 输入目录，默认 ./xlsx |
| -o | 指定 out_dir， 即 lua 输出目录，默认 ./lua |
| -m | 模式 0 = 关闭增量模式，其他情况默认开启 |
| -h | 显示命令参数格式 |
cmd_1.png
根据 json 配置创建 xlsx
命令行输入python3.8 xlsx_generator.py -i sheets.json -o ./xlsx/test.xlsx, 可以用来根据指定输入的 sheets.json 文件创建指定输出的 ./xlsx/test.xlsx 文件
| 选项 | 含义 |
|---|---|
| -i | 指定infile，即输入的json文件 |
| -o | 指定outfile，即输出的xlsx文件 |
cmd_2.png
sheet 的 json 配置参数说明
| 参数 | 说明 |
|---|---|
| name | sheet 的名称 |
| header | sheet 的表头 |
header 的 json 配置参数说明
| 说明 | 说明 |
|---|---|
| name | lua 的名称 |
| field | 默认为空，如果配置了 key-value，则会导出 keyvalue 样式的 lua |
| key | 可以填一个或多个字段的名称，不填会导出 nokey 样式的 lua，一个对应onekey，多个对应morekey |
| field | 导出到 lua 的字段的名称 |
| type | 导出到 lua 的字段的数据类型，支持 int、number、string、table、any（根据内容自动识别类型） |
开发环境
| 系统 | mac OS Catalina 10.15.4 |
|---|---|
| Python | Python 3.8.2 - 64 bit |
| 核心库 | xlrd、xlwt、json |
更多项目
-
[xasset]一个简易轻量的Unity资源管理框架
https://github.com/xasset/xasset
-
[libx]src about runtime & editor of xasset and more
https://github.com/xasset/libx
-
[emo]一个基于 xasset & Xlua 的轻量客户端业务开发框架
https://github.com/xasset/emo