Nesse mini EP vou me propor a fazer uma calculadora de média de dados. Ou seja, um programa que recebe uma string representando resultados de dados e calcula a esperança do resultado dos dados.
Por exemplo,
1d6 representa o lançamento de um dado de seis lados.
XdN representa o lançamento de X dados de N lados. O resultado final desse lançamento é a soma das faces viradas para cima de cada dado.
Podemos também somar lançamentos de dados diferentes. Sejam N e M dois números inteiros, então podemos ter a fórmula:
XdN + YdM, onde X e Y também são números inteiros. Nesse caso, estamos fazendo um lançamento com X dados de N lados e Y dados de M lados. Se N=M, então a fórmula é equivalente a Xd2N.
Por fim, além de somar dados, podemos somar ou multiplicar valores inteiros.
XdN + Y representa fazer um lançamento de X dados de N lados e somar Y ao resultado final.
O programa será feito em python e utilizaremos os framework de testes unittest.
Comecei testando apenas uma fórmula simples. Isso fez com que fossemos obrigados a criar a classe mencionada no setUp e também o método get_mean_for_die_formula, que recebe uma string e retorna um float.
Entretanto, ao testar apenas uma fórmula, resolvi isso facilmente retornando 3.5 na função criada, o que claramente não é o esperado.
Portanto, foram adicionados mais testes para verificar se o programa está calculando a média corretamente (ainda com strings do tipo 1dN). Assim, basta retornar (N+1)/2 e passamos esse teste também.
Para os próximos passos, queremos criar funções que recebam strings do tipo XdN e retornem ou X ou N (dependendo da função). Para isso, fizemos mais dois testes.
Depois, fazemos novamente testes de várias fórmulas simples, mas do tipo XdN. O programa não necessariamente usará as funções que o forçamos a criar nos testes anteriores, mas isso seria o ideal (de fato não há forma de assegurar que o programa as usará usando TDD).
Agora é hora de testar somas de dados. Para começar, vamos somar apenas dois dados, mas vamos testar com várias fórmulas e com uma quantidade de espaços variada entre cada um dos dados.
Em sequência, temos os testes mais complexos, que envolvem somas de vários dados.
E, por fim, vamos testar também a média somando valores que não são dados (valores inteiros normais, que são chamados no programa de escalares).
E ao final desse processo, temos um programa funcionando da forma como gostaríamos =).
- Melhorar os testes: existem alguns códigos repetidos entre os testes. Poderíamos melhorar essa classe para deixar os testes um pouco mais robustos. Além disso, poderíamos realizar mais testes (por exemplo, testar o comportamento de quando passamos apenas um número inteiro para o programa);
- Subtração: seria legal se pudéssemos também subtrair dados ou inteiros, isso seria uma boa feature para o futuro;
- Verificação de input: atualmente não estamos tratando os possíveis erros de inputs inválidos, o
unittestpermite testar o lançamento de exceções e isso seria algo interessante de se fazer em uma versão futura.