xlsx_to_lua

一个精简实用的导出 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