DTest

dtest é uma estrutura de teste, semelhante ao pacote unittest padrão fornecida pelo Python. O valor acrescentado para dtest, no entanto, é que a execução do teste é roscado, por meio do uso do pacote de eventlet. O pacote dtest também fornece o conceito de "dependências" entre testes e dispositivos de teste - assim o "D" em "dtest" - que assegurar que os testes não são executados até que a correspondência de configurar dispositivos de teste foram concluídas, e que a derrubar dispositivos de teste não são executados até que todos os testes associados tenham concluído. Dependências também pode ser utilizado para assegurar que os ensaios que requerem a disponibilidade de certas funcionalidades não são executadas se os testes de funcionalidade específica que falham.
Testes escrita
Os programas mais simples teste são funções simples com nomes que começam com "test", localizado em arquivos de origem Python cujos nomes começam também com "teste". Nem sequer é necessário importar qualquer parte do quadro dtest. Se os testes são coletados nas aulas, no entanto, ou se o uso dos recursos mais avançados do dtest é desejado, um simples de dtest import * é necessário. Isso torna disponível a classe Dtestcase - que deve ser prorrogado por todas as classes contendo testes - assim como esses decoradores comoskip enottest.
Os testes podem ser realizados utilizando a instrução assert Python padrão; no entanto, uma série de rotinas de serviço público estão disponíveis no módulo dtest.util (também segura para a importação *). Muitas destas rotinas de utilidade tem nomes semelhantes aos métodos de unittest.TestCase - por exemplo, dtest.util.assert_dict_equal () é análoga à unittest.TestCase.assertDictEqual ().
Chaves Teste
O quadro dtest suporta dispositivos de teste - configurar e derrubar funções - no nível de classe, módulo e pacote. Luminárias de nível pacote consistem em funções nomeadas setup () e tearDown () contidos dentro de arquivos "__init__.py"; da mesma forma, dispositivos elétricos de nível de módulo consistem em funções de configuração samed () e tearDown () dentro de módulos contendo funções de teste e classes de métodos de ensaio. Ao nível da classe, classes podem conter setUpClass () e tearDownClass () métodos de classe (ou métodos estáticos), que pode realizar configurar e derrubar para cada classe. Em todos os casos, as funções de configuração () eo método setUpClass () são executadas antes de qualquer um dos testes dentro do mesmo âmbito de aplicação; Da mesma forma, depois de todos os testes em um determinado escopo tiver executado, os tearDownClass correspondentes (método) e tearDown () funções são executadas.
O quadro dtest também suporta funções ou métodos, que são executados antes e depois de cada teste associado setUp per-teste () e tearDown (). Para as classes contendo testes, cada teste tem automaticamente o setup () e tearDown () métodos da classe que lhes estão associados; no entanto, para todos os testes, estes jogos podem ser explicitamente definido (ou substituídos a partir da classe padrão). Considere o seguinte exemplo:
istest
test_something def ():
& Nbsp; # Teste algo aqui
& Nbsp; passe
@ Test_something.setUp
something_setup def ():
& Nbsp; # começar tudo configurado pronto para ir ...
& Nbsp; passe
@ Test_something.tearDown
something_teardown def ():
& Nbsp; # limpar depois de nós mesmos
& Nbsp; passe
Neste exemplo, um decorador dtest (exceptonottest) é necessário anterior test_something (); aqui utilizou-seistest, mas qualquer outro disponível decorador dtest poderia ser utilizada aqui. Isso torna o @ test_something.setUp e decoradores @ test_something.tearDown disponível. (Para algo análogo no padrão do Python, vá para o decoradorproperty built-in).
Executando testes
A execução de testes usando a estrutura dtest é bastante direto. Um script chamado run-dtests está disponível. Por padrão, o diretório atual é digitalizado para todos os módulos ou pacotes cujos nomes começam com "test"; a pesquisa também recurses para baixo através de todos os pacotes. (Um "pacote" é definida como uma pasta contendo "__init__.py".) Uma vez que todos os testes são descobertos, que eles são, em seguida, executado, e os resultados dos testes emitido na saída padrão.
Várias opções de linha de comando estão disponíveis para controlar o comportamento de run-dtests. Por exemplo, o "--no-ignore" opção irá causar-dtests executados para executar todos os testes, mesmo aqueles decorado com o decoradorskip, ea opção "-d" faz-dtests correm para procurar um diretório específico, em vez de o diretório atual. Para obter uma lista completa de opções, use a opção "-h" ou "help".
Executando-dtests executados a partir da linha de comando não é a única maneira de executar testes, no entanto. O script run-dtests é um script muito simples que analisa as opções de linha de comando (usando a OptionParser construído pela função dtest.optparser ()), converte essas opções em um conjunto de argumentos nomeados (usando dtest.opts_to_args ()), em seguida, passa esses argumentos nomeados para a função dtest.main (). Os usuários podem usar essas funções para construir a mesma funcionalidade com extensões específicas do usuário, tais como o fornecimento de uma instância alternativa DTestOutput para controlar como os resultados dos testes são apresentados, ou o fornecimento de um método alternativo para controlar quais testes são ignorados. . Veja as cordas de documentação para essas funções e classes para mais informações