Tabugen

Tabugen是一个配置导出和代码生成工具，主要用于游戏项目中简化业务开发数据抽象过程。

Tabugen导入Excel表格生成编程语言的结构体定义，导出CSV数据文件，并生成对应的CSV文件加载代码。

Tabugen解决的几个痛点

写一个从excel表格导出csv和生成对应的业务代码的工具并不难，但是要解决好日常使用中的几个痛点

解决痛点1 基本功能

从excel表格里导出结构体定义，并且把excel转为csv，这个是基本需求

比如我们有一个HeroConfig.xlsx文件，里面有如下内容：

#备注	ID	Name	Exp
流浪剑客	1001	Sven	2000
冥界亚龙	1002	Viper	2500

• 第一行为字段名称，此名称会原样生成到结构体里；
• 以#开头的字段名在导出的时候会被忽略，可以用于配置一些说明信息；
• 第二行开始就是具体的数据内容

最后会生成代码如下：

struct HeroConfig {
    int ID;
    int Name;
    int Exp;
}

解决痛点2 字段类型支持简单的数组和字典格式

#备注	ID	Name	Exp	Buff	Drop
流浪剑客	int	string	int64	int[]	<int,int>
流浪剑客	1001	Sven	2000	1201,1202	2001=100,2002=300
冥界亚龙	1002	Viper	2500	1302,1304	2001=150,2002=200

• 需要单独用第二行来描述每个字段的详细类型；
• int[]表示数组类型，默认使用竖线,分隔元素，格式如：value1,value2,value3
• <int,int>表示字典类型，默认使用竖线,分隔元素，用=分隔键值，格式如: key1=value1,key2=value2
• 第三行开始才是具体的数据内容；

解决痛点3 支持字段嵌套

宝箱ID	概率1	物品1	数量1	概率2	物品2	数量2
ID	Weight[0]	ItemID[0]	ItemNum[0]	Weight[1]	ItemID[1]	ItemNum[1]
int	int	int	int	int	int	int

如上表的配置格式，期望是配一个宝箱的掉落每个掉落有对应的概率和物品，这个表格期望生成的代码格式是：

struct TreasureBoxItem
{
    int Weight;
    int ItemId;
    int ItemNum;
}

struct TreasureBox
{
    int ID;
    TreasureBoxItem[] BoxItems;
}

Tabugen是支持这种配置格式的，字段名后面带数组索引的ItemID[0], ItemID[1]，就认为是要做字段嵌套，只需要在@meta表里，配置上InnerTypeClass=TreasureBoxItem表示嵌套的子类的class名称，和InnerFieldName=BoxItems表示对应字段名 生成的时候不需要加任何选项，就可以生成类似上面的代码。

解决痛点4 全局变量表的纵向解析格式

字段名	字段类型	值	说明
ID	Name	Price	# Desc
string	string	int	string
Key1	float	3.14	浮点数值
Key2	string	SUCEE	显示文字
Key3	bool	0	功能开关
Key4	int[]	1 | 2 | 3	等级列表

会生成下面格式结构体

struct Global
{
    float Key1;
    string Key2;
    bool Key3;
    int[] Key4;
}

解决痛点5，不同项目类型的区分导出

这是一个常见的需求，比如有一个excel表格，某些字段只有客户端需要，某些字段只有服务器需要， Tabugen的做法是通过前缀来实现

ID	S_Field1	C_Field2	Field3
1001	1	2	3

• 如果是仅服务器使用的字段，字段名的前缀加上S_，导出的时候指定选项--project_kind=S
• 如果是仅客户端使用的字段，字段名的前缀加上C_，导出的时候指定选项--project_kind=C

如何使用Tabugen(How to Use)

从pip导入

pip install tabugen
tabugen --asset_path=example.xlsx --cpp_out=MyConfig --package=config  --with_csv_parse --with_conv --source_file_encoding=utf_8_sig

这是推荐的方式，pip可以和项目的CI/CD更好的集成

使用PyInstaller从源码打包

• git clone https://github.com/qki7chen/tabugen.git
• cd tabugen && python -m PyInstaller --name "tabugen" -F tabugen/__main__.py

几种主流强类型语言的示例

请查看examples目录下的示例工程：

• C++的示例 examples/Cpp 演示如何配合C++使用;
• C#的示例 examples/CSharp 演示如何配合C#(Unity)使用;
• Golang的示例 examples/Go 演示如何配合Golang使用;
• Java的示例 examples/Java 演示如何配合Java使用;
• 对于Python, JavaScript等动态语言，将Excel导出为json即可，指定选项--out_data_format=json

== TO-DO

• 增加结构体对齐优化选项；
• 其它细节优化；