Team Viewer - Data Extract for analysis
Project description
Team View - Extract (Data extraction for team analysis)
Extract team analysis data from git (current) and other relevant sources (future).
Pre-requisites for Use
- Tokei (This fork has initial, rudementary, support for Jupyter notebooks). Tokei is used to collect metrics on volume of source based per source language.
If you don't have rust installed and aren't currently using Tokei, We recommend utilizing the team-view-extract docker image.
Setup
A configuration file that defines the "project" for extract must be defined. The configuration file is json.
Example:
{
"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
}
Multiple extracts can be defined in a singl configuration file. start_date
, end_date
, mailmap_file
and logging
are all optional. logging
defaults to info level. start_date
defaults to beginning of project. end_date
defaults
to today
. If no mailmap_file
is specified, standard git configuration applies.
A good way to create the mailmap file is to construct based on git shortlog -sne
for each repository.
Results
For each extract specified in the configuration file, a sub-directory will be created in the directory spcified by
output_path
. The following files will be created:
- author_totals.csv - Commit counts by author and repository (excluding merge commits)
- loc.csv - File counts by language, commit and repository (commits to master branch only)
- loc_delta.csv - File Counts by author, language, commit and repository (excluding merge commits)
- prs.csv - Pull request by repo including duration between last commit to branch and merge to master
- repo.csv - Current state of volume of code by language for each repo
- revs.csv - Revision graph by repo
'Temporary' Files
~/.local/share/cache
is used to cache temporary files including checkout of repos specified by extract and a cache of
the LOC revision history of each repo. If present this cache is updated on subsequent runs. If not present it is
recreated from scratch.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for tv_extract-1.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ceca6929710a0c85c31c828190ae136eb1a701d818f956593207a13f1f1846bd |
|
MD5 | a2fd49bd3a92777dc00fd4b794b0e5cd |
|
BLAKE2b-256 | 2ceb911e44458d2f950753e8358a5b058e6e1da7876adf1c337729ae23616b57 |