= Rspec-i18n

* http://github.com/tomas-stefano/rspec-i18n/wikis
* http://gemcutter.org/gems/rspec-i18n
* http://rspec-i18n.lighthouseapp.com

== Install

  [sudo] gem install rspec-i18n

Or if you use rvm(for example ruby 1.8.7):

  rvm 1.8.7 gem install rspec-i18n

== Description

The Rspec-i18n gem provide a easy way to write specs in any speaking language you
prefer - If don't have your speaking language, please make a fork =)
The Rspec-i18n was created for the purpose of teaching people who are
starting to developing applications but also serves to Production use.
I know that many people prefer to write code/specs in English.
But if you don't prefer that, you'll like the Rspec-i18n. =)

== Synopsis
  
Rspec-i18n will supports some speaking language(If don't have your speaking language, please make a fork and send pull requests!)
(See http://github.com/tomas-stefano/rspec-i18n/blob/master/lib/spec-i18n/languages.yml file). 
Here is a simple example of Portuguese(Brazil):
   
First your <b>spec_helper</b>:
 
    # In spec/spec_helper

    require 'spec-i18n'

    Spec::Runner.configure do |config|
      
      config.spec_language :pt
      
      # ...
    end

Then you have <b>Translated -> Matchers, Before Hooks, After Hooks ...(etc)</b>
in Portuguese Language.
Start with a very very simple example in Portuguese:

    # In spec/personagem_spec.rb

    require 'spec_helper'
	
    descreva Personagem do
     
      antes(:de_cada) do
        @homer = Personagem.new("Homer Simpson", :desenho => :simpson)
		@meggie = Personagem.new("Meggie Simpson", :desenho => :simpson)
      end
                                                                                  
      isto "deve retornar o desenho ao qual o personagem pertence" do             
        @homer.desenho.deve ser_igual_a(:simpson)                                 
      end                                                                         
                                                                                  
      isto "deve ser personagem principal" do                                     
        @homer.deve ser_personagem_principal # look personagem_principal? method  
      end                                                                         
                                                                                  
      isto "deve beber cerveja Duffy" do                                          
        @homer.bebe_cerveja_duffy?.deve ser_verdadeiro                            
      end                                                                         
                                                                                  
      isto "deve beber cerveja Duffy" do                                          
        @meggie.bebe_cerveja_duffy?.deve ser_falso                                
      end
                                                                                
  end                                                                           

== Examples

See more examples in http://github.com/tomas-stefano/rspec-i18n/blob/master/examples/i18n

== Listing the available languages

    rspec-i18n --language help

== Listing the available keywords for the language

	rspec-i18n --language pt
	
	rspec-i18n --language es

== Adding a new language or completing a existing one

  1. Make a fork of Rspec-i18n and pull it down
  2. Add your language keywords to languages.yml
  3. Commit and push your changes - then send a pull request at Github

<b>OBS: Ideas for better words in languages.yml are Welcome =D.</b>

== Tested Versions

<b>ONLY Ruby 1.8</b>
<b>Rspec-i18n >= 1.0.0</b> supports <b>ONLY Rspec 1.3</b>

The older versions supports this versions: Rspec:  1.2.7, 1.2.8, 1.2.9

<b>Support for Rspec 2.0 and Ruby 1.9 come soon!</b>

== TODO

See the <b>TODO.txt</b> file and see more details