Skip to content

gomidegui/exploring-code-evolution

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 

Repository files navigation

Explorando evolução de código

//GUILHERME GOMES PALAHARES GOMIDE//

MATRÍCULA: 2021090048

RELATÓRIO NO FINAL DO ARQUIVO

Neste exercício, iremos explorar a evolução de código em sistemas reais.

Iremos utilizar a ferramenta GitEvo. Essa ferramenta analisa a evolução de código em repositórios Git nas linguagens Python, JavaScript, TypeScript e Java, e gera relatórios HTML como este.

Mais exemplos de relatórios podem ser podem ser encontrados em https://github.com/andrehora/gitevo-examples.

Passo 1: Selecionar repositório a ser analisado

Selecione um repositório relevante na linguagem de sua preferência (Python, JavaScript, TypeScript ou Java). Você pode encontrar projetos interessantes nos links abaixo:

Passo 2: Instalar e rodar a ferramenta GitEvo

Note

Antes de instalar a ferramenta, é recomendado criar e ativar um ambiente virtual Python.

Instale a ferramenta GitEvo com o comando:

$ pip install gitevo

Execute a ferramenta no repositório selecionado utilizando o comando abaixo (ajuste conforme a linguagem do repositório). Substitua <git_url> pela URL do repositório que será analisado:

# Python
$ gitevo -r python <git_url>

# JavaScript
$ gitevo -r javascript <git_url>

# TypeScript
$ gitevo -r typescript <git_url>

# Java
$ gitevo -r java <git_url>

Por exemplo, para analisar o projeto Flask escrito em Python:

$ gitevo -r python https://github.com/pallets/flask

Note

Essa etapa pode demorar alguns minutos pois o projeto será clonado e analisado localmente.

Passo 3: Explorar o relatório de evolução de código

Após executar a ferramenta GitEvo, é gerado um relatório HTML contendo diversos gráficos sobre a evolução do código.

Abra o relatório HTML e observe com atenção os gráficos.

Passo 4: Explicar um gráfico de evolução de código

Selecione um dos gráficos de evolução e explique-o com suas palavras. Por exemplo, você pode:

  • Detalhar a evolução ao longo do tempo
  • Detalhar se as curvas estão de acordo com boas práticas
  • Explicar grandes alterações nas curvas
  • Explorar a documentação do repositório em busca de explicações para grandes alterações
  • etc.

Seja criativo!

Instruções para o exercício

  1. Crie um fork deste repositório (mais informações sobre forks aqui).
  2. Adicione o relatório HTML no seu fork.
  3. No Moodle, submeta apenas a URL do seu fork.

Responda às questões abaixo diretamente neste arquivo README.md do seu fork:

  1. Repositório selecionado: <URL_DO_REPOSITORIO_SELECIONADO_AQUI>
  2. Gráfico selecionado: <IMAGEM_DO_GRAFICO_SELECIONADO_AQUI>
  3. Explicação: <EXPLICACAO_AQUI>

/////////// RELATÓRIO ////////////////////////

Repositório analisado jenkinsci/configuration-as-code-plugin

Gráfico selecionado — Classes e Interfaces (2020–2025) Classes e Interfaces

Explicação O gráfico “Classes, interfaces and records” mostra a evolução das declarações de classes e interfaces no projeto entre 2020 e 2025.

A quantidade de classes cresceu de cerca de 200 em 2020 para quase 250 em 2025, revelando uma expansão contínua do código, com a introdução de novas funcionalidades e melhorias incrementais.
Já o número de interfaces permaneceu praticamente estável, em torno de 10, o que indica que a arquitetura do sistema foi mantida, sem necessidade de criar novos contratos ou abstrações.

Esse padrão sugere que o projeto está, pelo menos neste aspecto, condizente com boas práticas, já que a evolução acontece principalmente pela adição de classes, enquanto a base arquitetural permanece sólida e estável.

About

Exploring code evolution with GitEvo

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 100.0%