g villalta 99

1, 2 testando, teste, 1, 2, som…

Sempre tive dúvidas sobre como fazer testes, antes, depois ou durante, fazer mocks e stubs ou não, isolar a aplicação do banco ou não, usar factories ou não, são tantas variáveis, tantas opções, pra não dizer decisões, que realmente fica fácil de se perder.

Primeiro gostaria de fazer uma consideração, tudo que direi aqui é baseado no meu cotidiano com o desenvolvimento de aplicações web com ruby.

Então vamos ver como testar, ou melhor, vou mostrar como eu testo.

Por que ?

Eu testo por que assim eu me prendo a duas coisas, confiabilidade e foco. Testando eu fico mais seguro quanto aquilo que desenvolvo e caso outra pessoa queira trabalhar no projeto ela terá maior confiança sobre o funcionamento do mesmo. Além disso, fazendo os testes eu me atenho a realizar um pequeno avanço bem direcionado no projeto por iteração.

Os testes me auxiliam em ter uma meta durante o processo de desenvolvimento. Também me auxiliam a solucionar problemas, pois, com eles posso quebrar uma solução em pequenas soluções mais tangíveis.

De outra maneira, os testes me auxiliam tanto na análise bottom-up quanto na top-down durante o processo de resolução de um problema.

O que são testes? Como você testa?

Eu prefiro testar meu código com testes automatizados, pratica bem comum entre desenvolvedores da linguagem ruby, pra isso utilizo o rspec de maneira bem próxima à apresentada abaixo:

#test_file.rb
describe ClassName do
  describe "#instance_method" do
    it "should do an amazing thing" do
      ClassName.new.instance_method.should be_amazing
    end
  end
end

Simples e prático, depois para verificar que o teste está funcionando:

rspec test_file.rb

Nesse exemplo pode-se ver que estou descrevendo uma classe (ClassName) e seu o método (instance_method) que será testado. Também foi definida uma espectativa sobre esse método (should be amazing). Dessa forma se tem a estrutura básica de um teste.

E como seria um exemplo real?

A algum tempo atrás desenvolvi um crawler, é algo muito legal, e uma das características desse crawler era que ele precisava baixar photos. Para não bagunçar as responsabilidades do meu crawler resolvi implementar essa funcionalidade em uma outra classe que chamei de PhotoService.

De maneira resumida, essa classe receberia uma url e deveria retornar o nome do arquivo onde foi salva a foto. Sendo assim, ela me parece uma ótima candidata a ser apresentada aqui.

Que comecemos com os testes então:

#spec/photo_service_spec.rb
require_relative '../photo_service'

describe PhotoService do
  let(:photo) { double("photo") }

  describe "#dowload" do
    it "should download the photo"
  end
end

A estrutura do teste segue bem simples por enquanto, foi definida a classe que será testada e qual método será testado. A espectativa ainda não foi definida, porém já temos uma ideia daquilo que iremos fazer.

Em ruby podemos verificar que um arquivo existe usando File.exists? filename

Vamos refatorar nosso teste para atender as nossas espectativas.

#spec/photo_service_spec.rb
describe "#download" do
  it "should download the photo" do
    filename = PhotoService.new.download(url)
    path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
    File.exists?(File.join(path, filename)).should be_true
  end
end

Alguns pontos a se ressaltar, a url ainda não foi definida e determinamos apenas a espectativa quanto a foto estar salva em disco.

Com isso já temos a meta final da nossa aplicação, vamos começar a montar os passos para atingir essa meta:

• Montar a requisição HTTP;
• Pegar a resposta da requisição HTTP;
• Determinar o nome do arquivo que será salvo;
• Salvar o corpo dessa resposta em no arquivo;
• Retornar o nome do arquivo;

… continua no próximo capítulo.