Skip to content

raydrawc/genCfgs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

genCfgs

python3 基于openpyxl的excel转换工具。支持xlsx文件转换为erlang,elixir,lua,json,xml,python等配置文件。
关于openpyxl库:https://pypi.python.org/pypi/openpyxl。

python(推荐3.5-3.7 因为目前pyinstaller支持这些版本)和openpyxl安装

linux安装

apt-get install python-pip
pip install openpyxl

win安装

安装python(同时安装pip并添加到Path)
安装openpyxl, 在安装python后在cmd中运行: pip install openpyxl

使用

lancher.bat(win)和lancher.sh(linux)为对应运行脚本。
当前配置了用于参考的参数来转换example.xlsx,
可在对应server、client输出文件夹查看生成配置效果。

参数:
--input   :需要转换的excel文件所在目录
--srv     : 服务端配置文件输出目录
--clt     : 客户端配置文件输出目录
--timeout : 需要转换的excel文件最后更新时间距当前时间秒数。-1转换所有
--suffix  :excel文件后缀,通常为.xlsx 
--swriter : 服务端配置文件转换器,可以指定为: erlanghrl,erlangerl,elixir,lua,jsonarray,jsonobject,xml,python
--cwriter : 客户端配置文件转换器,可以指定为: erlanghrl,erlangerl,elixir,lua,jsonarray,jsonobject,xml,python

注:对于client和server,如果未配置输出目录或转换器,则不会导出。

数据类型

支持int(int64), number(float), string, tuple, list, dict, json、lua
其中tuple, list, dict 为 python原生数据结构 json 为json数据类型 Lua为 lua table

数据格式示范(可以参考本工具自带的示例配置表)

int 整数 1,2,1000 64位
number 整数或者小数都OK
string 字符串 excel表中配置时不需要额外加双引号
tuple  (元素, 元素, ...) 元素可以为 int number string tuple list dict
list   [元素, 元素, ...] 元素可以为 int number string tuple list dict
dict   [key:value, key:value, ...] key可以为 int number string tuple value可以为 int number string tuple list dict
    特别注意该类型的使用 因为在一些语言中 对应dict类似的类型的key不支持 int 比如 jsonarray和xml,如果在转成jsonarray和xml时key不能配置为int和number
json   {key:value, key:value, ...}该类型为json的对象类型 Key为字符串, Value可以为任意Json数据类型即可以是对象,数字,基本数据类型。
lua    该类型为lua的table类型  
其中 list dict json 三种数据格式可以互相嵌套
转换时会将这些数据类型转换为其他语言支持的数据类型,另外注意点是一些其他语言的一些限制 
比如 json不能用数字做为对象的Key(), xml的也不能用数字作为标签, 在配置的时候需要注意
而且导出xml和jsonjsonarray都是用的库,出错的时候不太好找到对应配置错误的数据,需要配置前
就额外注意,以免不必要的懵逼和浪费时间,策划不太明白的可以请教程序或者百度

打包exe

部署时,可以将python打包成exe。建议使用pyinstaller。
pip install pyinstaller
cd src && pyinstaller -F -c genCfgs.py

关于文件命名

excel文件名命名格式

为了表名的可视化和可理解性,文件命名支持 MMM-NNN.xlsx的方式。MMM可以是任意字符(一般为文件中文名,但是不用下划线结尾),
作为文件名的注释性描述。NNN只能是数字,字母和下划线(不能以下划线开头和数字开头),作为导出的配置以NNN做为表名前缀

excel sheet命名格式

为了考虑策划会使用一个excel配置同一的功能的多个配置子表,且方便导出和查看,sheet命名为YYY-XXX或者 YYY+XXX, 
或者YYY (里面不包含 "+"""-"),  YYY可以为任意字符(一般为中文描述),XXX为导出配置的表名后缀,
当sheet命名为 YYY-XXX或者 YYY+XXX时 导出文件名为: NNN_XXX.lang(此种命名一般用于 一个excel配置多个需要导出的sheet页签)
当sheet命名为 YYY 时 导出文件名为: NNN.lang (此种命名用法仅仅用于一个excel只配置一个需要导出的sheet页签)
lang为目标语言的后缀名
具体示例:
    A_arrary表示例--cfg_array.xlsx 前缀Y可以用方便排序显示 更多具体参见配置excel示例

注意

* 在string中无法直接使用换行等特殊称号。请用\n等转义字符替代。
* 由于xml并不存在数组等结构,不建议使用。
* 工具会检测server和client标识。如果不存在,则不导出些表。方便策划做备注

About

游戏配置导表工具 将excel配置表数据生成导出为erlang,elixir,lua,json,xml,python格式的配置

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 63.2%
  • Lua 22.5%
  • Elixir 6.8%
  • Erlang 6.6%
  • Other 0.9%