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.

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

• Python: https://github.com/topics/python?l=python
• JavaScript: https://github.com/topics/javascript?l=javascript
• TypeScript: https://github.com/topics/typescript?l=typescript
• Java: https://github.com/topics/java?l=java

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

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.

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!

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: https://github.com/n8n-io

2. Gráfico selecionado:

3. Explicação: gráfico de LOC / TypeScript files mostra como, em média, cada arquivo do n8n foi ficando mais “enxuto” ao longo do tempo.

Em 2020, cada arquivo tinha em média ~247 linhas de código. Esse número sobe um pouco até 2022 (~250), mas a partir de 2023 começa a cair bastante, chegando a ~172 linhas por arquivo em 2025.

Isso sugere uma evolução positiva no estilo de desenvolvimento: conforme o projeto cresceu, a equipe e a comunidade provavelmente começaram a dividir melhor a lógica em vários arquivos menores, ao invés de concentrar muito código em poucos lugares. Arquivos mais curtos tendem a ser mais fáceis de entender, testar e manter.

Em outras palavras: mesmo com o crescimento gigante do projeto, o time conseguiu organizar o código de forma a evitar “arquivos monstrões” e manter uma estrutura mais saudável.