atualizado artigo sobre Selenium - Mario Chaves

Author: luzfcb

content/introducao_a_testes_funcionais_com_selenium_e_python.rst

@@ -7,6 +7,12 @@ Introdução a testes funcionais com Selenium e Python
 :slug: introducao-a-testes-funcionais-com-selenium-e-python
 :author: Mário Chaves
 :email:  [email protected]
+:github: macndesign
+:bitbucket: macndesign
+:twitter: macndesign
+:linkedin: macndesign
+:facebook: macndesign
+:site: http://www.xsd.com.br/blog/
 
 
 
@@ -22,10 +28,10 @@ Porquê usar a linguagem Python nos testes funcionais?
 Como sabemos os testes funcionais são em sua grande parte desenvolvidos por Analistas de Testes e/ou Testadores.
 Para que se tenha uma manutenção mais rápida e eficaz a medida que o código do projeto vai crescendo e ganhando mais funcionalidades, é interessante que os testes estejam coesos e de fácil entendimento. `IMHO <http://pt.wiktionary.org/wiki/IMHO>`_  Python é a linguagem que deixa seu código mais elegante, limpo e entendível.
 
-  *"Python é uma linguagem de programação de alto nível , interpretada, imperativa, orientada a objetos, funcional, 
+  *"Python é uma linguagem de programação de alto nível , interpretada, imperativa, orientada a objetos, funcional,
   de tipagem dinâmica e forte."* `Wikipedia <http://pt.wikipedia.org/wiki/Python>`_
 
-Em uma rápida comparação de verbosidade entre Python e Java com o tão criticado "Hello, World!", podemos notar o 
+Em uma rápida comparação de verbosidade entre Python e Java com o tão criticado "Hello, World!", podemos notar o
 que quero dizer quando citei *"IMHO Python é a linguagem que deixa seu código mais elegante, limpo e entendível"*.
 
 
@@ -50,7 +56,7 @@ Exemplo em Python 2.x
 
 
 
-Isso mesmo, os dois exemplos fazem a mesma coisa, porém, o exemplo em Java tem 104 caracteres enquanto o exemplo 
+Isso mesmo, os dois exemplos fazem a mesma coisa, porém, o exemplo em Java tem 104 caracteres enquanto o exemplo
 em Python possui apenas 21 caracteres.
 
 Mas, voltando ao que interessa, vamos ao passo-a-passo de como configurar seu ambiente e depois testar executando algo como exemplo.
@@ -60,7 +66,7 @@ Mas, voltando ao que interessa, vamos ao passo-a-passo de como configurar seu am
 Montando o ambiente
 ===================
 
-Supondo que você usa Windows e não tem nada do que vamos precisar instalado, faça o download dos 
+Supondo que você usa Windows e não tem nada do que vamos precisar instalado, faça o download dos
 seguintes itens:
 
   Python 2.7.6 - https://www.python.org/downloads/
@@ -73,7 +79,7 @@ seguintes itens:
     *Navegador Web mais recomendado para o uso do Selenium e onde será instalado o plugin SeleniumIDE*
 
   PhantomJS v1.9 - https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.7-windows.zip
-    *Navegador Headless que possibilita a execução dos testes em background, sem a necessidade de executar 
+    *Navegador Headless que possibilita a execução dos testes em background, sem a necessidade de executar
     toda a interface gráfica do navegador*
 
 
@@ -143,30 +149,35 @@ Biblioteca Selenium para o Python
 Criando um teste simples com a famosa Selenium IDE lo/
 ======================================================
 
-Após instalar a Selenium IDE dentro do Firefox e reiniciar o navegador, clique no ícone da ferramenta que está no 
+Após instalar a Selenium IDE dentro do Firefox e reiniciar o navegador, clique no ícone da ferramenta que está no
 canto superior direito do Navegador.
 
 .. image:: images/test-ff-sel-btn.png
+  :alt: Botão para iniciar a Selenium IDE
 
 Note que na Selenium IDE, a opção de gravar já vem selecionada por padrão.
 
 .. image:: images/test-ff-sel-gravar-ligado.png
+  :alt: Botão de gravar ligado
 
 E para nossa alegria, a URL do site atual que está em nosso Firefox, já está definida no campo "URL Base" da Selenium IDE.
 
 Cliquei no link "Como apoiar o IFIC" e acessei a seguinte página.
 
 .. image:: images/test-ff-sel-clicar-no-link.png
+  :alt: Clicando no link
 
 Ao ver o que está acontecendo na Selenium IDE, notamos que ela está gravando tudo o que está acontecendo no navegador.
 
 .. image:: images/test-ff-sel-initial-view.png
+  :alt: Visualização inicial
 
 Retorno ao navegador e faço um simples assert para ver se ao entrar na página o título H1 está correto.
 
 .. image:: images/test-ff-sel-assert-h1.png
+  :alt: Assert no H1
 
-Veja como é simples ver as propriedades que podem ser usadas para certificar que você realmente está na tela correta e 
+Veja como é simples ver as propriedades que podem ser usadas para certificar que você realmente está na tela correta e
 verificar se os textos estão corretamente aplicados em seus devidos lugares.
 
 Nesse exemplo eu verifico se o título H1 da página contém "Como Apoiar o IFIC", para isso foi necessário:
@@ -179,17 +190,19 @@ Nesse exemplo eu verifico se o título H1 da página contém "Como Apoiar o IFIC
 Agora veja o que a Selenium IDE gravou:
 
 .. image:: images/test-ff-sel-assert-h1-view.png
+  :alt: Vendo o resultado do assert no H1
 
 Como era de se esperar, apenas o que você fez no navegador ;)
 
-  *Note que se você já for um usuário experiente da Selenium IDE, souber usar os seletores e conhecer bem o código HTML 
+  *Note que se você já for um usuário experiente da Selenium IDE, souber usar os seletores e conhecer bem o código HTML
   da página, você poderá escrever todo o seu código na própria Selenium IDE e depois executar.*
 
 Para executar o teste criado, basta clicar no botão "Play entire test suite" como na imagem abaixo:
 
 .. image:: images/test-ff-sel-play-test.png
+  :alt: Botão para executar os testes
 
-Note que o teste foi executado com sucesso, pois está tudo verdinho :) . Logo abaixo existem algumas mensagens 
+Note que o teste foi executado com sucesso, pois está tudo verdinho :) . Logo abaixo existem algumas mensagens
 na sequência que foram executadas.
 
 
@@ -200,33 +213,35 @@ Salvando/Exportando e executando os testes
 Selenium IDE
 ------------
 
-Ao concluir seu teste você tem a opção de salvar e então executar futuramente para verificar 
+Ao concluir seu teste você tem a opção de salvar e então executar futuramente para verificar
 se o sistema continua funcionando como deveria.
 
 Para salvar é muito simples, se estiver no Windows ou Linux, basta dar um Ctrl+S e no Mac Command+S, escolher
 uma pasta e clicar em Salvar.
 
 .. image:: images/test-ff-sel-save.png
+  :alt: Salvando teste
 
-Sinceramente, se você sempre quiser executar seus testes usando o Mozilla Firefox eu aconselho usar a própria 
-Selenium IDE para esse propósito, pois com ela você salva seus testes em HTML e os executa tranquilamente com 
-opção de rodar todo um Test Case de uma vez. Observe que após salvar o teste ele fica disponível na coluna 
+Sinceramente, se você sempre quiser executar seus testes usando o Mozilla Firefox eu aconselho usar a própria
+Selenium IDE para esse propósito, pois com ela você salva seus testes em HTML e os executa tranquilamente com
+opção de rodar todo um Test Case de uma vez. Observe que após salvar o teste ele fica disponível na coluna
 "Test Case" da Selenium IDE e você pode ir adicionando os demais testes a essa coluna para que sejam todos executados.
 
 
 Exportando para uma linguagem de programação
 --------------------------------------------
 
-Na Selenium IDE existe a opção de exportar seu teste para várias linguagens de programação como: Ruby, Python, 
+Na Selenium IDE existe a opção de exportar seu teste para várias linguagens de programação como: Ruby, Python,
 Java e C#.
 
-Exportar seu teste para uma linguagem de programação pode ser bem útil para o caso de integrar seu teste 
-ao código de teste desenvolvido pelos programadores já que os testes exportados pela Selenium IDE são 
+Exportar seu teste para uma linguagem de programação pode ser bem útil para o caso de integrar seu teste
+ao código de teste desenvolvido pelos programadores já que os testes exportados pela Selenium IDE são
 codificados utilizando a lib unittest, ou seja, na forma de testes unitários.
 
 A imagem abaixo mostra como exportar o teste para uma das linguagens disponíveis:
 
 .. image:: images/test-ff-sel-export-lang.png
+    :alt: Exportando o teste
 
 No caso, Python 2 / unittest / Webdriver, mas o teste poderia ser exportado para qualquer outra linguagem disponível.
 Clique nesse item e salve na pasta que desejar com um nome sucinto e seguido da extensão .py (por exemplo: test_como_apoiar.py)
@@ -251,23 +266,23 @@ Veja abaixo o código gerado pela exportação do teste para Python (48 linhas):
           self.base_url = "http://www.ific.com.br/"
           self.verificationErrors = []
           self.accept_next_alert = True
-      
+
       def test_como_apoiar(self):
           driver = self.driver
           driver.get(self.base_url + "/")
           driver.find_element_by_link_text("Como apoiar o IFIC").click()
           self.assertEqual("Como Apoiar o IFIC", driver.find_element_by_css_selector("h1").text)
-      
+
       def is_element_present(self, how, what):
           try: self.driver.find_element(by=how, value=what)
           except NoSuchElementException, e: return False
           return True
-      
+
       def is_alert_present(self):
           try: self.driver.switch_to_alert()
           except NoAlertPresentException, e: return False
           return True
-      
+
       def close_alert_and_get_its_text(self):
           try:
               alert = self.driver.switch_to_alert()
@@ -278,7 +293,7 @@ Veja abaixo o código gerado pela exportação do teste para Python (48 linhas):
                   alert.dismiss()
               return alert_text
           finally: self.accept_next_alert = True
-      
+
       def tearDown(self):
           self.driver.quit()
           self.assertEqual([], self.verificationErrors)
@@ -367,16 +382,16 @@ Veja o mesmo código gerado pela exportação do teste para Java (73 linhas):
   }
 
 
-Tendo a versão do teste escrita em Python posso simplesmente dar um clique duplo sobre o ícone do arquivo 
-test_como_apoiar.py que instantaneamente é aberto o navegador (Mozilla Firefox) e executado todo teste 
+Tendo a versão do teste escrita em Python posso simplesmente dar um clique duplo sobre o ícone do arquivo
+test_como_apoiar.py que instantaneamente é aberto o navegador (Mozilla Firefox) e executado todo teste
 ao vivo.
 
 Mas como já disse, se for para rodar o teste no Firefox, é melhor executar pela própria Selenium IDE.
 
 É por isso que agora vamos saber porquê instalamos o PhantomJS.
 
-Com o PhantomJS temos a possibilidade de executar o browser em "Background", podemos chamar de modo "Headless", 
-isso faz com que possamos executar toda a nossa suíte de testes sem precisar ligar o Mozilla Firefox e todo o 
+Com o PhantomJS temos a possibilidade de executar o browser em "Background", podemos chamar de modo "Headless",
+isso faz com que possamos executar toda a nossa suíte de testes sem precisar ligar o Mozilla Firefox e todo o
 peso de sua interface gráfica, para isso vamos alterar a primeira linha do método setUp() e trocar o webdriver Firefox para PhantomJS:
 
 .. code-block:: python
@@ -394,6 +409,7 @@ Então vamos abrir o terminal, console ou cmd, como queira chamar, e navegar at
 O arquivo é executado como na imagem abaixo:
 
 .. image:: images/test-ff-change-webdriver.png
+  :alt: Teste executado com um webdriver headless
 
 Bem amigos, a leitura foi uma breve descrição sobre os seguintes tópicos:
 
@@ -412,3 +428,4 @@ Qualquer dúvida pode entrar em contato:
   * Google + `plus.google.com/+MárioChaves81 <https://plus.google.com/+M%C3%A1rioChaves81>`_
 
 Grande abraço!
+