# Uso da Linha de Comando

Para facilitar testes automatizados, a funcionalidade de vetor de teste pode ser executada a partir da linha de comando:

> `logisim --test-vector <circuit_name> <test_vector_file> <project.circ>`

Ou usando o arquivo JAR:

> `java -jar logisim-evolution.jar --test-vector <circuit_name> <test_vector_file> <project.circ>`

## Argumentos

- <circuit_name>: O nome do circuito a ser testado (deve corresponder a um circuito no arquivo do projeto)
- <test_vector_file>: Caminho para o arquivo de vetor de teste (por exemplo, `TestsDLatch.txt`)
- <project.circ>: Caminho para o arquivo de projeto do Logisim contendo o circuito

## Exemplo

> `java -jar logisim-evolution.jar --test-vector dlatch TestsRegisterFile.txt /home/user/Computer.circ`

## O que o Comando Faz

O comando irá:

1. Carregar o circuito especificado do arquivo do projeto
2. Carregar e analisar o arquivo de vetor de teste
3. Executar todos os testes (respeitando as regras de execução sequencial)
4. Imprimir resultados mostrando testes aprovados e falhados
5. Sair com código de status 0 em caso de sucesso, diferente de zero em caso de falha

## Exemplos de Saída do Comando

O resultado de um teste bem-sucedido será enviado para a saída padrão (stdout), por exemplo:

    Carregando vetor de teste "testv1b.txt" ...
    Executando 4 vetores ...
    1
    2
    3
    4

    Aprovados : 4, Falhados : 0

E em caso de falha:

    Carregando vetor de teste "testv1a.txt" ...
    Executando 4 vetores ...
    1
    2
    3

      ob = 0 (esperado 1)
    4

      ob = 1 (esperado 0)

    Aprovados : 2, Falhados : 2

Nota: Na saída de erro (stderr) você lerá:

    Erro no vetor de teste 3:
    Erro no vetor de teste 4:

Anterior: Testes Sequenciais | Próximo: Dicas e Melhores Práticas.