|
|
- # py_exceltools
- 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
- 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标识。如果不存在，则不导出些表。方便策划做备注
|
