Agile Hacking » Hacking http://gabrielfalcao.com The GNUs of mine, and its green builds Tue, 08 Jun 2010 13:22:40 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 Apresentando Lettuce, BDD em python http://gabrielfalcao.com/2010/05/12/apresentando-lettuce-bdd-em-python/ http://gabrielfalcao.com/2010/05/12/apresentando-lettuce-bdd-em-python/#comments Wed, 12 May 2010 23:50:14 +0000 Gabriel Falcão http://gabrielfalcao.com/?p=175 Depois de muitas horas de hacking intenso, venho apresentar a primeira release candidate do Lettuce.

Trata-se de uma ferramenta de BDD 100% baseada no Cucumber.

O nome teve duas motivações:

  • Lettuce (Alface) é um vegetal verde, assim como Cucumber (Pepino), a idéia é que os testes sempre estejam verdes :)
  • Letuce é também o nome de uma banda à qual tenho muita admiração.

Mãos ao código

Deixei links para a documentação no fim deste post, mas aqui vai uma prévia:

Funcionalidades são descritas em arquivos com a extensão .feature, e devem ficar por padrão, dentro do seu projeto, chamada features

Por sua vez, features são descritas assim:

Feature: Introduce lettuce to my friends
  In order to show it working
  As lettuce author
  I want to create a scenario that passes

  Scenario: Concatenate names
    Given I have the following names:
      | name | surname |
      | john | doe     |
      | ian  | murdock |
    When I join them
    Then I see the data:
      | joined       |
      | Doe, John    |
      | Murdock, Ian |

Para implementar as steps, basta criar um arquivo python qualquer dentro da pasta features o Lettuce importará todos eles recursivamente.
Exemplo:

# -*- coding: utf-8 -*-
from lettuce import step, world, before
from some_module import NameJoiner

# setup
@before.each_scenario
def set_joined(scenario):
    world.joined = []

# steps
@step('I have the following names')
def set_names(step):
    world.people = step.hashes

@step('join them')
def join_names(step):
    for person in world.people:
        joiner = NameJoiner(
            name=person["name"],
            surname=person["surname"]
        )
        world.joined.append(joiner.join())

@step('I see the data')
def check_names(step):
    for name, data in zip(world.joined, step.hashes):
        assert name == data['joined']

(baixe o exemplo completo aqui)

Motivação

Desde que comecei a praticar TDD em Python tive várias experiências, testei várias bibliotecas de mock e técnicas de teste.
Em projetos de aplicações web usei o Pyccuracy, assim podia descrever o comportamento da aplicação ao mesmo tempo que fazia testes automatizados da interface.

No entanto, tive a chance de testar o  Cucumber num projeto Django aqui na globo.com, me apaixonei por funcionalidades incrivelmente produtivas, como step tables que permite desenhar uma tabela com caracteres, e mapear como lista de hashes, bem como scenario outlines.

Daí veio a grande inspiração: implementar uma ferramenta como o Cucumber, mas em python puro.

Por que?
Para programadores python, é mais cômodo usar bibliotecas em python puro. Eu pessoalmente evito misturar linguagens, a não ser que a melhor solução seja realmente em outra linguagem.

Cucumber é, na minha opinião, uma lib que torna ruby ainda mais sexy :)
Criar uma aplicação robusta, bem testada requer paciência, que tal tornar isso mais divertido ?
É mais fácil empacotar módulos python para debian/ubuntu :P

Além disso, apesar de Cucumber dar suporte a Python, seria interessante usar python puro dentro das step definitions.
Supondo o desenvolvimento de uma aplicação Django com cucumber, seria útil manipular os models dentro de step definitions. Entretanto, para isso acontecer, é necessário usar algo como rubypython, cuja última release data outubro de 2009.

Exemplos de bibliotecas similares/equivalentes entre python e ruby

Framework web:

ruby: rails
python: django

Micro-framework web:

ruby: sinatra
python: cherrypy

Deploy automatizado:

ruby: capistrano
python: fabric

Behaviour-driven development:

ruby: cucumber
python: lettuce ?! (quem sabe :P )

Direto ao assunto!

Hoje estou liberando oficialmente a primeira release candidate do Lettuce, que atualmente possui as seguintes features:

  • Hooks pre/pós execução de:
    • Toda a suíte de testes
    • Cada feature
    • Cada scenario
    • Cada step
  • Contexto global: world
  • Scenario outlines
  • Step tables
  • Nomes e formato de arquivo de features compatível com cucumber
  • Output colorido
  • Output sem cor

Mas… O que falta para fechar a primeira release oficial? Além de ter feedback sobre possíveis bugs das features já implementadas para melhorá-las, a intenção é que a primeira release também tenha as seguintes funcionalidades:

Documentação

Não poderia faltar, mas ainda está sendo escrita.
De qualquer forma, já possui o básico para colocar o um novo projeto funcionando. E se você já conhece o Cucumber, não terá dificuldades.

Acesse a documentação aqui

Ou melhor ainda, vá direto ao “quick start”

Contribua!

Estou sedento por feedbacks (negativos e positivos), sendo assim:

Por fim, o lettuce está sob GNU GPL 3+ e ainda tem um longo caminho pela frente. Toda forma de ajuda é bem vinda, seja com patches, documentação, suporte para outros idiomas, etc.

Happy hacking :)

]]> http://gabrielfalcao.com/2010/05/12/apresentando-lettuce-bdd-em-python/feed/ 16 Playing with ANSI colors and python with Couleur http://gabrielfalcao.com/2010/04/19/playing-with-ansi-colors-and-python-with-couleur/ http://gabrielfalcao.com/2010/04/19/playing-with-ansi-colors-and-python-with-couleur/#comments Mon, 19 Apr 2010 15:50:24 +0000 Gabriel Falcão http://gabrielfalcao.com/?p=150 Last night I’ve just released the first version of Couleur, which is (or at least try to be) a simple and awesome tool for using ANSI colors with python.

Couleur indeed turns very easy to handle shell colors in python.

In action

import time
import couleur

sh = couleur.Shell(linebreak=True)
for mood in ["bad", "awful", "normal", "nice", "awesome"]:
  sh.red_on_black(mood, replace=True)
  time.sleep(1)

Couleur creates colored output dinamically, so that you can mix colors and modifiers at will:

import couleur
sh = couleur.Shell(linebreak=True)
sh.bold_black_and_bold_yellow_on_red("Gray | Yellow")

And even use “static” output, let’s simulate the output of a “git clone”:

import time
import couleur

sh = couleur.Shell(linebreak=True)
for x in range(101):
  if x is 0:
    print
  sh.normal_and_bold_green(
    "Counting objects: |%d%%" % x,
    replace=True
  )
  time.sleep(0.08)

Installation

user@machine:~$ sudo pip install couleur

Full Documentation

Available here

Contributing

Fork me on github, write tests, write code, make it pass, send a pull request :)

]]> http://gabrielfalcao.com/2010/04/19/playing-with-ansi-colors-and-python-with-couleur/feed/ 1 MOSV http://gabrielfalcao.com/2008/07/08/mosv/ http://gabrielfalcao.com/2008/07/08/mosv/#comments Tue, 08 Jul 2008 21:08:32 +0000 gabriel http://gabrielfalcao.com/?p=6 There is a group of free software here in Belo Horizonte/MG named Minas Livre in which we often made hack parties. Last weekend we done a 48h hack party, with pit stops to sleep (only). During the conversations, a subject was brought: CSV.

A dude said that CSV must be considerated only when using commas, so if you use a semi-colon would be SCSV (semi-colon separated values).

It was going too boring when i thought: Off course, don’t fight for little stuff. Use MOSV (Memory offset separated values).It is simple!

]]> http://gabrielfalcao.com/2008/07/08/mosv/feed/ 2 New blog! http://gabrielfalcao.com/2008/06/29/new-blog/ http://gabrielfalcao.com/2008/06/29/new-blog/#comments Sun, 29 Jun 2008 20:41:00 +0000 gabriel http://gabrielfalcao.com/?p=3 i’m proud to present my brand new blog!

It’s awesome to be able to publish hackerish stuff like GObject, Python, GNOME, and anything else related to coding and freedom.

For now that is all!

]]> http://gabrielfalcao.com/2008/06/29/new-blog/feed/ 0