As bibliotecas de cliente do Cloud para Rust permitem que você faça o stub de implementações de cliente reais e injete um modelo para teste de unidade. O uso de um cliente simulado permite que você escreva testes de unidade controlados e confiáveis que não fazem chamadas de rede nem geram cobranças.
Antes de começar
Antes de executar o código neste documento, siga as instruções em Começar a usar o Rust para instalar o Rust e configurar um projeto do Cargo.
Dependências
Neste documento, usamos o crate mockall como framework de simulação e o cliente Speech do Speech-to-Text para ilustrar o fluxo de trabalho. O mesmo padrão se aplica a outros clientes gerados.
Adicione a biblioteca de cliente e google-cloud-gax ao arquivo Cargo.toml:
cargo add google-cloud-speech-v2 google-cloud-gax
Adicione mockall e tokio como dependências de desenvolvimento:
cargo add --dev mockall
cargo add --dev tokio --features macros,rt-multi-thread
Simular um cliente
Para testar o código sem chamadas de rede, implemente o atributo de stub do serviço em
uma estrutura simulada e configure as expectativas. Em seguida, crie um cliente com
from_stub e transmita-o para a função do aplicativo:
Adicione aliases
usepara encurtar os nomes dos crates:Escreva uma função de aplicativo que aceite uma referência ao cliente
Speech, chameget_recognizere processe a resposta do servidor:Defina uma struct simulada que implemente a característica
speech::stub::Speechusandomockall::mock!:No teste, crie uma instância do simulado. A macro
mockall::mock!anexaMockao nome do struct para criarMockSpeech:Configure as expectativas no simulador para validar os campos de solicitação recebidos e retornar uma resposta
Recognizersimulada:Crie um cliente
Speechdo simulado usandoSpeech::from_stub:Chame a função do aplicativo com o cliente simulado:
Verifique o valor retornado:
Simular erros
Para testar o tratamento de erros, configure a expectativa simulada para retornar um Err
construído com Error::service:
Preencher código
O exemplo a seguir combina os testes de unidade de sucesso e erro em um módulo de teste completo:
Execute cargo test para executar os testes de unidade:
cargo test