Aplicação Java que analisa projetos do Git e determina ownership e expertise de código através de informações de logs do Git. A aplicação é voltada para projetos desenvolvidos na disciplina de Laboratório de Programação II na Universidade Federal de Campina Grande (UFCG), mas pode ser estendida a qualquer projeto que faz uso de Git para controle de versões. Para utilizar a aplicação basta executar o comando abaixo e seguir as intruções.
$ java -jar codeOwnership.jar
Caso o arquivo codeOwnership.jar esteja desatualizado, é possível executar o projeto como uma aplicação Java. Para obter os resultados da análise, basta indicar o caminho para a pasta do projeto que se deseja analisar (na qual está contido o diretório .git). Nessa mesma pasta, é necessário ter um arquivo students.json contendo uma associação entre nomes e aliases dos contribuidores do projeto da seguinte forma:
// students.json
{
"students": [
{
"name": "Student 1",
"aliases": [
"Username 1",
"Username 2"
]
},
{
"name": "Student 2",
"aliases": [
"Username 3",
"Username 4",
"Username 5"
]
}, ...
]
}
Fazemos uso desse arquivo .json já que muitas vezes os usuários de sistemas Git ficam associados a mais de um username quando não configuram corretamente suas máquinas.
Caso o processo de análise ocorra com sucesso, um arquivo analysis-result.tsv será gerado na pasta outputs. Ele deverá seguir o modelo que está contido neste repositório.