一个精简实用的导出 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 | 显示命令参数格式 |
根据 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文件 |
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资源管理框架
-
[libx]src about runtime & editor of xasset and more
-
[emo]一个基于 xasset & Xlua 的轻量客户端业务开发框架