dirts

Sujas (seleção de testes de regressão consciente da injeção de dependência)

Dirts é uma ferramenta de pesquisa de seleção de seleção de regressão no nível da classe ou método (RTS), que está ciente dos mecanismos de injeção de dependência (DI).

Pré -requisitos

• Jdk> = 11
• Maven Surefire> = 2,14 (embora recomendado> = 3.0.0-m5)
• qualquer versão do Junit

Objetivos maven

Selecione Mojos

Mojo	Descrição
class_level_select	Selecione testes usando a abordagem de nível de classe
method_level_select	Selecione testes usando a abordagem no nível do método

Gráfico Mojos

Mojo	Descrição
class_level_graph	Mostrar gráfico criado pela abordagem de nível de classe
method_level_graph	Mostrar gráfico criado pela abordagem no nível do método

Mojos de utilidade

Mojo	Descrição
clean	Limpe arquivos e diretórios temporários

Opções de configuração

Relevante para cada mojo

Opção	Descrição	Padrão
logging	Nível de registro (valores em java.util.logging.Level )	INFO
useSpringExtension	Analisar dependências induzidas pela primavera	false
useGuiceExtension	Analisar dependências induzidas por Guice	false
useCDIExtension	Analisar dependências induzidas pelo CDI	false

Relevante para mojos selecionados

Opção	Descrição	Padrão
standalone	Executar no modo independente - se não estiver presente, Dirts espera que outro RTS -Tool já tenha excluído alguns testes no excludesFile	false
overrideExtension	Em combinação com standalone=false , comporte-se como uma ferramenta está em execução independente, mas exclui apenas os testes afetados por alterações relacionadas a DI	false

Relevante para o gráfico mojos

Opção	Descrição	Padrão
toFile	Armazene a representação gráfica no sistema de arquivos em vez de imprimi -lo para stdout	false
outputFile	O nome do arquivo, onde o gráfico é armazenado se toFile estiver definido como true	[class|method]_level

Casos de uso

Independente

Dirtes podem ser usadas completamente independentes para RTs especificando standalone=true .

Como uma extensão para outra ferramenta RTS

As sujas também podem ser usadas para ser executadas após outra ferramenta RTS e corretas apenas para testes afetados por alterações relacionadas a DI. A outra ferramenta é necessária para excluir testes no arquivo especificado pela propriedade excludesFile do Surefire. As sujas precisam ser executadas após a outra ferramenta RTS e, em seguida, comentam os testes afetados por alterações relacionadas a DI, mas já foram excluídas antes. Este é o comportamento padrão das sujas.

Exemplos de uso

Dirts é construído para ser usado com o MAVEN Surefire. A maneira mais simples de usar sujas em um projeto Maven é através do plug -in Dirts Maven:

< plugin >
    < groupId >edu.tum.sse.dirts</ groupId >
    < artifactId >dirts-maven-plugin</ artifactId >
    < version >${dirts.version}</ version >
    < configuration >
        ...
    </ configuration >
</ plugin >

Pré -requisitos

1. excludesFile -Property da Surefire precisa ser definido, idealmente para cada submódulo separadamente. Caso contrário, a exclusão de teste não funcionará.
2. A análise para o DI-frameworks desejada deve ser ativada, definindo a respectiva propriedade (por exemplo, useSpringExtension ) como true .

Compilar, selecionar e testar de uma só vez

Embora a Dirts analise o código-fonte simples, no caso de certas dependências entre módulos, pode ser necessário compilar antes de executar o procedimento de seleção.

$ mvn compile dirts:class_level_select test

Selecione, compilar e testar apenas os módulos que têm pelo menos um teste selecionado

Os sujos criam uma lista desses módulos em .dirts/affected_modules dentro da pasta do módulo mais externo.

$ mvn dirts:class_level_select
$ mvn -am -pl " $( cat .dirts/affected_modules ) " test

Combinado com a seleção de teste Git - antes de se fundir

1. Confira a filial principal.
2. Execute a seleção para criar somas de verificação e gráfico, se esses arquivos ainda não existem. Por exemplo: $ mvn dirts:class_level_select
3. Confira a filial do recurso.
4. Execute a seleção e os testes.

• Para compilação combinada, seleção e execução de teste: $ mvn compile dirts:class_level_select test
• Para compilar e testar apenas módulos afetados:

$ mvn dirts:class_level_select
$ mvn -am -pl " $( cat .dirts/affected_modules ) " test 

Configurar

Para construir sujas, simplesmente corra:

$ mvn clean install

Isso criará o código para todos os módulos, executará todos os testes e instalará os frascos no seu repositório local do MAVEN.