团队查看器-用于分析的数据提取
tv-extract的Python项目详细描述
团队视图-提取(用于团队分析的数据提取)
从git中提取团队分析数据(当前) 以及其他相关来源(未来)。
使用的先决条件
如果您没有安装Rust并且当前没有使用Tokei,我们建议您使用 team-view-extractDocker图像。
设置
必须定义定义要提取的“项目”的配置文件。这个 配置文件是json。
示例:
{"extracts":[{"name":"Project 1","repos":[{"name":"TeamView","remote":"git@github.com:rappdw/TeamViewer.git"},{"name":"team-view-extract","remote":"git@github.com:rappdw/team-viewer-extract.git"}],"start_date":"2018-07-18","end_date":"2018-08-31"}],"output_path":"~/.local/share/cache/TeamView","mailmap_file":"~/.local/share/cache/.mailmap","logging":20}
可以在singl配置文件中定义多个提取。start_date
、end_date
、mailmap_file
和logging
都是可选的。logging
默认为信息级别。start_date
默认为项目开始。end_date
默认值
到today
。如果未指定mailmap_file
,则应用标准git配置。
创建mailmap文件的一个好方法是基于每个存储库的git shortlog -sne
构造。
结果
对于配置文件中指定的每个提取,将在指定的目录中创建一个子目录
output_path
。将创建以下文件:
- author_totals.csv-按作者和存储库列出的提交计数(不包括合并提交)
- loc.csv-按语言、提交和存储库列出的文件计数(仅提交到主分支)
- loc_delta.csv-按作者、语言、提交和存储库列出的文件计数(不包括合并提交)
- prs.csv-回购请求,包括上次提交到分支和合并到主节点之间的持续时间
- repo.csv-每个repo的按语言列出的代码量的当前状态
- revs.csv-按回购修订图表
“临时”文件
~/.local/share/cache
用于缓存临时文件,包括由extract指定的repo签出和
每个回购的loc修订历史。如果存在,则在后续运行时更新此缓存。如果不存在
从头开始重建。