Introdução a testes funcionais com Selenium e Python

Passos para a instalação do Python no Windows

Nota: ele já vem instalado no Mac e Linux

1. Executar o instalador e instalar com passos simples (Avançar, Avançar, Concluir)
2. Entre no CMD (Terminal) e digite python, se entrar no interpretador então já está instalado, se não, vá para o passo 3
3. Feche o Terminal, vá em Iniciar e clique com o botão direito sobre o “Computador” e selecione “Propriedades”
4. No menu lateral clique em “Definições avançadas de sistema” e selecione “Variáveis de ambiente”
5. Na caixa “Variáveis do sistema” selecione com um duplo clique o item “Path”
6. Ao final da linha “Valor da variável” insira ";C:\Python27\Scripts\" então dê Ok, Ok e Ok novamente
7. Abra o CMD (Terminal) novamente, digite python, e dê enter. Dessa vez vai entrar no interpretador!

Pip (Gerênciador de pacotes do Python) no Windows

1. Através do Terminal vá até a pasta onde você fez download do arquivo get-pip.py, provavelmente em "C:\Users\SeuUsuario\Downloads"
2. Ao entrar na pasta Downloads (Se o get-pip.py estiver nela) execute: python get-pip.py (Ele fará toda a instalação do Pip)

Sei que não tem necessidade, mas: Mozilla Firefox (Navegador Web)

1. Executar o instalador e instalar com passos simples (Avançar, Avançar, Concluir)

PhantomJS no Windows

1. Descompactar o arquivo e colocar a pasta “phantomjs-1.9.7-windows” dentro de C: (Veja se logo dentro dessa pasta existe um arquivo chamado phantomjs, que é um arquivo executável com o ícone de um Fantasminha) se tem, está certo, se não tem, então você tem que colocar a pasta “phantomjs-1.9.7-windows” que está dentro de “phantomjs-1.9.7-windows” em C: as vezes ao descompactar um arquivo no Windows ele descompacta em uma pasta com o mesmo nome
2. Vá em Iniciar e clique com o botão direito sobre o “Computador” e selecione “Propriedades”
3. No menu lateral clique em “Definições avançadas de sistema” e selecione “Variáveis de ambiente”
4. Na caixa “Variáveis do sistema” selecione com um duplo clique o item “Path”
5. Ao final da linha “Valor da variável” insira ";C:\phantomjs-1.9.7-windows\" então dê Ok, Ok e Ok novamente
6. Abra o CMD (Terminal) e digite phantomjs e dê enter, se entrar no interpretador é porquê deu certo, Ctrl+c pra sair e então feche o terminal

Selenium IDE (IDE para facilitar a criação de testes com o Selenium) no Firefox

1. Execute o Mozilla Firefox
2. Abra a seguinte URL: http://release.seleniumhq.org/selenium-ide/2.5.0/selenium-ide-2.5.0.xpi e a instalação já é feita de forma automática

Biblioteca Selenium para o Python

1. Abra o Terminal, digite "pip install -U selenium" e dê enter, a instalação é feita de forma automática

Levando em conta que o público alvo do artigo são testadores, não estenderei ao uso de ferramentas muito interessantes também para esse fim, porém mais utilizadas por desenvolvedores, como: Virtualenv, Fabric, Sphinx e etc.

Selenium IDE

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.

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, 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 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:

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)

Veja abaixo o código gerado pela exportação do teste para Python (48 linhas):

from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.support.ui import Select
from selenium.common.exceptions import NoSuchElementException
import unittest, time, re

class TestComoApoiar(unittest.TestCase):
    def setUp(self):
        self.driver = webdriver.Firefox()
        self.driver.implicitly_wait(30)
        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()
            alert_text = alert.text
            if self.accept_next_alert:
                alert.accept()
            else:
                alert.dismiss()
            return alert_text
        finally: self.accept_next_alert = True

    def tearDown(self):
        self.driver.quit()
        self.assertEqual([], self.verificationErrors)

if __name__ == "__main__":
    unittest.main()

Veja o mesmo código gerado pela exportação do teste para Java (73 linhas):

package com.example.tests;

import java.util.regex.Pattern;
import java.util.concurrent.TimeUnit;
import org.junit.*;
import static org.junit.Assert.*;
import static org.hamcrest.CoreMatchers.*;
import org.openqa.selenium.*;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.support.ui.Select;

public class TestComoApoiar {
  private WebDriver driver;
  private String baseUrl;
  private boolean acceptNextAlert = true;
  private StringBuffer verificationErrors = new StringBuffer();

  @Before
  public void setUp() throws Exception {
    driver = new FirefoxDriver();
    baseUrl = "http://www.ific.com.br/";
    driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);
  }

  @Test
  public void testComoApoiar() throws Exception {
    driver.get(baseUrl + "/");
    driver.findElement(By.linkText("Como apoiar o IFIC")).click();
    assertEquals("Como Apoiar o IFIC", driver.findElement(By.cssSelector("h1")).getText());
  }

  @After
  public void tearDown() throws Exception {
    driver.quit();
    String verificationErrorString = verificationErrors.toString();
    if (!"".equals(verificationErrorString)) {
      fail(verificationErrorString);
    }
  }

  private boolean isElementPresent(By by) {
    try {
      driver.findElement(by);
      return true;
    } catch (NoSuchElementException e) {
      return false;
    }
  }

  private boolean isAlertPresent() {
    try {
      driver.switchTo().alert();
      return true;
    } catch (NoAlertPresentException e) {
      return false;
    }
  }

  private String closeAlertAndGetItsText() {
    try {
      Alert alert = driver.switchTo().alert();
      String alertText = alert.getText();
      if (acceptNextAlert) {
        alert.accept();
      } else {
        alert.dismiss();
      }
      return alertText;
    } finally {
      acceptNextAlert = true;
    }
  }
}

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 peso de sua interface gráfica, para isso vamos alterar a primeira linha do método setUp() e trocar o webdriver Firefox para PhantomJS:

class TestComoApoiar(unittest.TestCase):
    def setUp(self):
        self.driver = webdriver.PhantomJS()

Então vamos abrir o terminal, console ou cmd, como queira chamar, e navegar até a pasta onde foi salvo o arquivo test_como_apoiar.py e executar o teste com o seguinte comando:

python test_como_apoiar.py

O arquivo é executado como na imagem abaixo:

Bem amigos, a leitura foi uma breve descrição sobre os seguintes tópicos:

• Porquê usar Python para guardar seus testes funcionais
• Como montar o ambiente no Windows
• Como criar um teste simples na Selenium IDE
• Como salvar/exportar e executar com um browser Headless os testes que foram criados com a IDE

Para mais detalhes sobre o uso da biblioteca Selenium do Python acompanhe a série de artigos iniciados pelo Lucas Magnum

Qualquer dúvida pode entrar em contato:

• Email macndesign@gmail.com
• Twitter @macndesign
• Facebook facebook.com/macndesign
• Google + plus.google.com/+MárioChaves81

Grande abraço!