用于为odk collect创建xforms的python包。
pyxform的Python项目详细描述
pyxform是一个python库,它使为odk collect和enketo编写xforms成为可能。 通过将xls(x)电子表格转换为xforms很容易。它在许多工具中用作库,包括the ODK online converter和Ona。
用作输入的xls(x)文档必须遵循XLSForm standard,结果输出遵循ODK XForms标准。
- formhub.org在这里使用回购协议:https://github.com/modilabs/pyxform
pyxform是xls2xform的主要重写。
运行pyxform的最新版本
对于那些想在命令行转换表单的人,可以使用pip:
pip install pyxform
然后可以使用xls2xform命令:
xls2xform path_to_XLSForm [output_path]
pyxform可以与python 2或python 3一起运行。持续集成在两代python上运行测试,以确保持续的兼容性。
从本地源运行pyxform
注意,要使用本地模块,必须卸载所有全局安装的pyxform实例。 请安装Java 8或更新版本。
从命令行:
python setup.py develop python pyxform/xls2xform.py path_to_XLSForm [output_path]
考虑使用virtualenv和virtualenvwrapper来简化依赖关系管理并保持全局网站包目录的干净:
pip install virtualenv pip install virtualenvwrapper mkvirtualenv local_pyxform # or whatever you want to name it (local_pyxform)$ python setup.py develop # install the local files (local_pyxform)$ python pyxform/xls2xform.py --help (local_pyxform)$ xls2xform --help # same effect as previous line (local_pyxform)$ which xls2xform. # ~/.virtualenvs/local_pyxform/bin/xls2xform
离开并返回虚拟环境:
(local_pyxform)$ deactivate # leave the virtualenv $ xls2xform --help # -bash: xls2xform: command not found $ workon local_pyxform # reactivate the virtualenv (local_pyxform)$ which xls2xform # & we can access the scripts once again ~/.virtualenvs/local_pyxform/bin/xls2xform
从远程源安装pyxform
pip可以从任何github存储库安装:
pip install git+https://github.com/XLSForm/pyxform.git@master#egg=pyxform
然后可以从命令行运行xls2xform:
xls2xform path_to_XLSForm [output_path]
测试
要确保安装成功,您可以执行以下操作:
pip install nose==1.0.0 cd your-virtual-env-dir/src/pyxform nosetests
文档
要查看pyxform的文档,请执行以下操作:
pip install Sphinx==1.0.7 cd your-virtual-env-dir/src/pyxform/docs make html