用于pma工作流的python3混合工具包
pmix的Python项目详细描述
pmix:问卷语言实用程序
PMA2020公用事业混合袋。有几个功能都基于 使用电子表格。主要功能如下:
以前,此包已重命名和扩展,以提供新的 功能和新的命令行工具。安装后将介绍命令行工具。
此版本需要Python3或更高版本。不支持Python 2。
安装
这个包裹在派皮上!运行:
python3 -m pip install pmix
对于开发人员,要从github安装,请运行:
python3 -m pip install https://github.com/PMA-2020/pmix/zipball/master
分析
用法< /P>
python3 -m pmix.analytics FILE1 [FILE2 ...]
创建描述分析提示和字段的JSON文件。
借
pmix借用模块用于帮助翻译 ODK表单的管理。它对于合并来自 一个文件变成另一个文件。
命令行用法
使用
调用此模块python3 -m pmix.borrow
它做了两件事。如果没有-m
参数,它只会创建
翻译词典。源字符串在第一列中,并且
目标语言在后面的列中。使用-m
参数,
它创建一个翻译词典,然后将这些翻译合并到
由-m
指定的文件
示例
- 无
-m
,
python3 -m pmix.borrow FILE1 [FILE2 ...]
从file1[file2…]
创建翻译词典
- 使用
-m
,
python3 -m pmix.borrow -m TARGET FILE1 [FILE2 ...]
从file1[file2…]
创建翻译字典,然后合并到target
在这两个示例中,都使用默认输出文件名,但可以使用-o
参数指定一个文件名。
输入文件
输入文件可以是以下两种之一:
- 标准ODK文件。
- 原始翻译文件。
原始翻译文件的格式如下,使用英语和法语作为 示例:
<表><广告>多种翻译
有一组命令行选项可用于各种翻译。
-d
此选项不带参数使用,表示如果文本有不同的翻译,请不要借用它。仅对-m
有效
-c correct
此选项将文件标记为正确。用源文件的路径填写correct
。其翻译优先于其他翻译。如果只有一个输入文件,并且它是正确的,则无需将其标记为正确的,因为没有任何东西可以覆盖它。d多样性
给出在多样性
表单中找到的语言。此选项在没有-m
的情况下使用。它创建一个只包含字符串的文件,这些字符串在源文件提供的语言中有不同的翻译。
输出文件
具有合并翻译的结果文件可能有以下突出显示:
- 橙色RCE和翻译是一样的。
- 如果新翻译更改了旧翻译,则为蓝色。
- 灰色如果新翻译填补了以前丢失的翻译(空白单元格)。
- 绿色如果在翻译dict中找不到翻译,但是有一个预先存在的翻译。
- 如果找不到翻译并且没有预先存在的翻译,则为红色。
- 黄色如果使用
-d
选项,显示不插入不同翻译的字符串。 - 如果翻译与先前的翻译相同,则不突出显示。
级联
用法< /P>
python3 -m pmix.cascade FILE
将地理标识符从宽格式转换为高格式后,创建新的Excel电子表格。
编号
使用编号迷你语言并为ODK调查创建问题编号。
python3 -m pmix.numbering FILE
然后程序在"调查"工作表中查找一个标题为"n"的列。它根据 指示并将其添加到标签列。
工作簿
提供以下功能:
- 使用utf-8编码和unix样式的换行符将工作表转换为csv。
python3 -m pmix.workbook FILE -c SHEET
- 从所有文本单元格中删除所有尾随和前导空格
python3 -m pip install pmix
0
xlsdiff
显示两个Excel文件之间差异的实用程序。
python3 -m pip install pmix
1
上面的命令创建一个新的excel文件,创建一个新版本的file2
突出显示以显示差异。
红色--因此重复的行和列不进行比较
橙色/桃色--标记文件中的行和列(文件2
),但在另一个
浅黄色--两个文件之间不同的单元格
绿色--按更改顺序排列的行
选项
<表><广告>振动筛
Viffer是一个工具,它提供关于两个XLSForms之间差异的列表报告。Viffer代表"版本差异"。
这个工具目前正在pmix的另一个分支下开发。如果您有兴趣使用它,请参见:https://github.com/joeflack4/pmix/tree/feature撸viffer
示例用法
生成viffer报告。
python-m pmix.viffer old_form.xlsx new_form.xlsx
错误
向james pringle提交错误报告,地址为jpringlebear@jhu.edu减去熊。