a spreedsheet export and code generate tool for rapid game development
Project description
Tabugen
Tabugen是一个配置导出和代码生成工具,主要用于游戏项目中简化业务开发数据抽象过程。
Tabugen导入Excel表格生成编程语言的结构体定义,导出CSV数据文件,并生成对应的CSV文件加载代码。
Tabugen解决的几个痛点
写一段代码来从excel表格导出csv和生成对应的业务代码并不难,但是要解决好日常使用中的几个痛点
解决痛点1 基本功能
从excel表格里导出结构体定义,并且把excel转为csv,这个是基本需求
一个excel表格需要遵从下面的配置格式
配置人 | 英雄ID | 英雄名字 | 初始价格 |
---|---|---|---|
# | ID | Name | Price |
string | int | string | int |
Tom | 1001 | Sven | 2000 |
Jack | 1002 | Viper | 2500 |
- 第一行为注释说明文字;
- 第二行为字段名称,此名称会原样生成到结构体里;
- 第三行为字段类型,可以使用
bool, int8, int16, int32, int64, float, string
等基础类型; - 以
#
开头的字段名在导出为csv的时候会被忽略,可以用于配置一些说明信息; - 每个表格还可以在名称为
@meta
的sheet里配置一些选项参数;
解决痛点2 字段类型支持简单的数组和字典格式
章节 | 需要完成的任务 | 可以获得的奖励 |
---|---|---|
Chapter | Tasks | Reward |
int | int[] | <int,int> |
1 | 101 | 102 | 103 | 3506=10 | 3602=20 |
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_Field | C_Field |
string | string | int |
- 如果是仅服务器使用的字段,字段名的前缀加上
S_
,导出的时候指定选项--project_kind=server
- 如果是仅客户端使用的字段,字段名的前缀加上
C_
,导出的时候指定选项--project_kind=client
技术实现上来讲,只是匹配--project_kind
参数的首字母是否与字段的X_Field
中的X
匹配
如何使用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
- 增加结构体对齐优化选项;
- 其它细节优化;
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for tabugen-1.0.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4178fefabd5682b6be96ce750a7c6b31885c691eaa58f37f3af46912acf278a |
|
MD5 | 05d807124428ad420e6830f70d6cbf29 |
|
BLAKE2b-256 | 9c1af7bc8d2ad6abb828cc6ca7d8a8bfa2837391f42eeb47170d4d00a69fc6f9 |