rspec-i18n 0.1.0

data/History.rdoc

@@ -0,0 +1,9 @@
+=== Version 0.1.0
+
+This is the first preview release of Rspec-i18n, a Internacionalization Development library for Ruby.
+
+* Added translation to all the base keywords(describe, it, should, should_not, 
+  before(:each), before(:all), before(:suite), after(:each), after(:all),
+  after(:suite))
+* Added a languages.yml. Will be translated to all languages.
+* Added a simple parser for the read the languages in languages.yml.

data/License.txt

@@ -0,0 +1,23 @@
+The MIT License
+
+Copyright (c) 2009 Tomás D'Stefano
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,64 @@
+= Rspec-i18n
+
+== Description
+
+The Rspec-i18n gem provide a easy way to write specs in any language you
+prefer. 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 any language you want(See languages.yml file). This is 
+Portuguese(Brazil):
+    
+    require 'spec'
+    require 'spec-i18n'
+
+    Spec::Runner.configure do |config|
+      
+      config.spec_language :pt
+      
+      ...
+    end
+
+    # In spec/pessoa_spec.rb
+
+	require 'spec_helper'
+	
+    descreva Pessoa do
+      antes(:de_cada) do
+        @nome = "Tomas"
+        @pessoa = Pessoa.new(@nome)
+      end
+
+      exemplo "retornar o seu nome" do
+        @pessoa.nome.deve == @nome
+      end
+    end
+
+== Examples
+
+See more examples in the examples folder
+
+== Listing the available languages
+
+    spec-i18n --language help (NOT YET IMPLEMENTED)
+
+== Adding a new language or completing a existing one(based on Cucumber implementation)
+
+  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
+
+  ** OBS: Hints for better words in languages.yml are Welcome =D.
+
+== Install
+
+  [sudo] gem install rspec-i18n
+
+== TODO
+
+See the TODO.txt file and see more details

data/Rakefile

@@ -0,0 +1,27 @@
+# encoding: utf-8
+require 'rubygems'
+require 'rake'
+
+$:.unshift(File.dirname(__FILE__) + '/lib')
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "rspec-i18n"
+    gemspec.summary = "The internacionalization gem for Rspec"
+    gemspec.description = "A internacionalization tool written in Ruby"
+    gemspec.email = "tomasdestefi@gmail.com"
+    gemspec.homepage = "http://github.com/tomas-stefano/rspec-i18n"
+    gemspec.authors = ["Tomas D'Stefano"]
+
+    gemspec.add_dependency('rspec', '>= 1.2.9')
+
+    gemspec.add_development_dependency('rspec', '>= 1.2.9')
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts("-" * 80)
+  puts "Jeweler not available. Install it with:
+  [sudo] gem install jeweler"
+  puts("-" * 80)
+end

data/TODO.txt

@@ -0,0 +1,31 @@
+== Refactoring
+
+* The SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language) is duplicated in 
+some places - check a better way to implement this
+* Simplified more and more tests!
+* Find the right module for the example group specs(it/example) (I think =>
+  Spec::Example::ExampleGroupMethods but I think I was wrong)
+
+== Future
+
+* Translate all matchers
+* Translate subjects
+* Translate shared examples
+* Put a #language header in the spec_helper file (Cucumber Style) instead load from config(maintain the two options)
+* Create the directory features to test with Cucumber
+* Make the describe/it i18n available from a class 
+	
+	Example:
+	#	class StackSpec < Spec::ExampleGroup
+	#     describe Stack, "with no elements"
+	#
+	#     before
+	#       @stack = Stack.new
+	#     end
+	#
+	#     it "should raise on pop" do
+	#       lambda{ @stack.pop }.should raise_error
+	#     end
+	#   end
+	
+* Check a better way to manipulating the mocks and stubs for i18n (What do you think?)

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:patch: 0
+:major: 0
+:minor: 1
+:build: 

data/bin/rspec-i18n

@@ -0,0 +1,2 @@
+#!/usr/bin/env ruby
+rspec_i18n_dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))

data/examples/person_spec.rb

@@ -0,0 +1,47 @@
+require 'spec-i18n'
+
+Spec::Runner.configure do |config|
+  config.spec_language :pt
+end
+
+class Pessoa
+  attr_reader :idade
+  def initialize(nome, sobrenome, idade=0)
+    @nome = nome
+    @sobrenome = sobrenome
+    @idade = idade
+  end
+  
+  def nome_completo
+    "#{@nome} #{@sobrenome}"
+  end
+end
+
+# Silly Tests
+descreva Pessoa do
+  
+  antes(:de_todos) do
+    @pessoa = Pessoa.new("Tomás", "D'Stefano")
+  end
+  
+  antes(:de_cada) do
+    @pessoas = [@pessoa]
+  end
+  
+  depois(:de_todos) do
+    @outras_pessoas = @pessoas.dup
+  end
+  
+  depois(:de_cada) do
+    @outras_pessoas = []
+  end
+  
+  exemplo "deve retornar o nome completo" do
+    @pessoa.nome_completo.deve == "Tomás D'Stefano"
+  end
+  
+  especificar "a idade é opcional" do
+    Pessoa.new("Aaromn", "Monkey", 20).idade.deve == 20
+  end
+  
+end

data/lib/spec-i18n/dsl/main.rb

@@ -0,0 +1,22 @@
+module Spec
+  module DSL
+    module Main
+
+      # Register adverbs for the dsl keywords
+      #
+      # { "describe" => ["descreva", "contexto"]}
+      # 
+      # Register alias for the language specified
+      def register_adverbs
+        language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+        @adverbs = language.dsl_keywords
+        @adverbs.each do |key, values|
+          values.map { |value| alias_method value, key }
+        end
+      end
+
+    end
+  end
+end
+
+include Spec::DSL::Main

data/lib/spec-i18n/dsl.rb

@@ -0,0 +1,2 @@
+require 'spec-i18n/spec_language'
+require 'spec-i18n/dsl/main'

data/lib/spec-i18n/example/before_and_after_hooks.rb

@@ -0,0 +1,51 @@
+module Spec
+  module Example
+    module BeforeAndAfterHooks
+      
+      def register_hooks
+        language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+        language.before_and_after_keywords.each do |key, values|
+          values.map { |value| alias_method value, key }
+        end
+      end
+  
+      def before_parts(scope)
+        if SpecI18n.spec_language
+          language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+          scope = grep_the_scope(scope, language.hooks_params_keywords)
+        end
+        case scope
+        when :each; before_each_parts
+        when :all; before_all_parts
+        when :suite; before_suite_parts
+        end
+      end
+      
+      def after_parts(scope)
+        if SpecI18n.spec_language
+          language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+          scope = grep_the_scope(scope, language.hooks_params_keywords)
+        end
+        case scope
+        when :each; after_each_parts
+        when :all; after_all_parts
+        when :suite; after_suite_parts
+        end
+      end
+
+      # Receive a String Scope and return the scope in english for
+      # the rspec run the right method
+      def grep_the_scope(scope, hooks)
+        scopes = [:each, :all, :suite]
+        return scope if scopes.include?(scope)
+        
+        hooks.each do |scope_in_english, language_hooks|
+          return scope_in_english.to_sym if language_hooks.include?(scope.to_s)
+        end
+      end
+
+    end
+  end
+end
+
+include Spec::Example::BeforeAndAfterHooks

data/lib/spec-i18n/example/example_group_methods.rb

@@ -0,0 +1,17 @@
+module Spec
+  module Example
+    module ExampleGroupMethods
+      
+        def self.register_example_adverbs
+          language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+          @adverbs = language.example_group_keywords
+          @adverbs.each do |key, values|
+            values.map do |value|
+              alias_method value, key
+            end
+          end
+        end
+        
+    end
+  end
+end

data/lib/spec-i18n/example.rb

@@ -0,0 +1,2 @@
+require 'spec-i18n/example/before_and_after_hooks'
+require 'spec-i18n/example/example_group_methods'

data/lib/spec-i18n/expectations/extensions/kernel.rb

@@ -0,0 +1,9 @@
+module Kernel
+  def register_expectations_keywords
+    language = SpecI18n::Parser::NaturalLanguage.get(SpecI18n.spec_language)
+    @adverbs = language.expectation_keywords
+    @adverbs.each do |key, values|
+      values.map { |value| alias_method value, key }
+    end
+  end
+end

data/lib/spec-i18n/expectations/extensions.rb

@@ -0,0 +1 @@
+require 'spec-i18n/expectations/extensions/kernel'

data/lib/spec-i18n/expectations.rb

@@ -0,0 +1 @@
+require 'spec-i18n/expectations/extensions'

data/lib/spec-i18n/languages.yml

@@ -0,0 +1,54 @@
+# encoding: utf-8
+#
+# (based on Cucumber implementation)
+# If you want several aliases for a keyword, just a separate them 
+# with a | character. Make sure there are no ambiguities in the keywords
+
+"en":
+  name: English
+  nativo: English
+  describe: describe
+  it: it|specify
+  should: should
+  should_not: should_not
+  before: before
+  after: after
+  hooks:
+    each: each
+    all: all
+    suite: suite
+  matchers:
+    be_equal: be_equal
+
+"pt":
+  name: Portuguese
+  nativo: português
+  describe: descreva|contexto
+  it: exemplo|especificar
+  should: deve
+  should_not: nao_deve
+  before: antes
+  after: depois
+  hooks:
+    each: de_cada|de_cada_exemplo
+    all: de_todos|de_todos_exemplos
+    suite: suite
+  matchers:
+    be_equal: ser_igual_a
+
+# Please put the right words for this language! =D
+"es":
+  name: Spanish
+  native: español
+  describe: describir 
+  it: ejemplo
+  should: deberia
+  should_not: no_debe
+  before: antes
+  after: despues
+  hooks:
+    each: de_cada_ejemplo
+    all: de_todos_ejemplo
+    suite: suite
+  matchers:
+    be_equal: ser_igual_a

data/lib/spec-i18n/parser/natural_language.rb

@@ -0,0 +1,63 @@
+module SpecI18n
+  module Parser
+    class NaturalLanguage
+      KEYWORDS_LANGUAGE = %w{ name native describe before after it should}
+
+      class << self
+        def get(language)
+          new(language)
+        end
+
+        def all
+          SpecI18n::SPEC_LANGUAGES.keys.sort.map { |language| get(language) }
+        end
+      end
+
+      attr_reader :keywords
+      
+      def initialize(language)
+        @keywords = SpecI18n::SPEC_LANGUAGES[language]
+        raise(LanguageNotFound, "Language #{language} Not Supported") if @keywords.nil?
+        @parser = nil
+      end
+
+      def dsl_keywords
+        spec_keywords("describe")
+      end
+
+      def expectation_keywords
+        language_adverbs = spec_keywords("should")
+        language_adverbs.merge(spec_keywords("should_not"))
+      end
+      
+      def before_and_after_keywords
+        adverbs = spec_keywords("before")
+        adverbs.merge(spec_keywords("after"))
+      end
+      
+      def hooks_params_keywords
+        hooks = {}
+        keywords['hooks'].each do |hook, value|
+          values = value.split('|')
+          hooks[hook] = values
+        end
+        hooks
+      end
+      
+      def example_group_keywords
+        spec_keywords("it")
+      end
+
+      def spec_keywords(key, space=false)
+        raise "No #{key} in #{@keywords.inspect}" if @keywords[key].nil?
+        values = keywords[key].split('|')
+        { key => values }
+      end
+
+    end
+
+    class LanguageNotFound < StandardError
+    end
+
+  end
+end

data/lib/spec-i18n/parser.rb

@@ -0,0 +1,2 @@
+require 'spec-i18n/platform'
+require 'spec-i18n/parser/natural_language'

data/lib/spec-i18n/platform.rb

@@ -0,0 +1,8 @@
+require 'yaml'
+
+module SpecI18n
+  version = YAML.load_file(File.dirname(__FILE__) + '/../../VERSION.yml')
+  SPEC_I18n_VERSION = [version[:major], version[:minor], version[:build]].compact.join(".")
+  SPEC_LANGUAGE_FILE = File.expand_path(File.dirname(__FILE__) + '/languages.yml')
+  SPEC_LANGUAGES = YAML.load_file(SPEC_LANGUAGE_FILE)
+end

data/lib/spec-i18n/runner/configuration.rb

@@ -0,0 +1,27 @@
+module Spec
+  module Runner
+    class Configuration
+      def spec_language(language)
+        @spec_language = language ? language.to_s : "en"
+        load_language
+        @spec_language
+      end
+
+      def language
+        @spec_language
+      end
+      
+      # Load all Modules and Classes for the language specified
+      def load_language
+        Spec::DSL::Main.register_adverbs
+        Kernel.register_expectations_keywords
+        Spec::Example::ExampleGroupMethods.register_example_adverbs
+        Spec::Example::BeforeAndAfterHooks.register_hooks
+      end
+    end
+    
+    class UndefinedLanguageError < StandardError
+    end
+    
+  end
+end

data/lib/spec-i18n/runner.rb

@@ -0,0 +1,2 @@
+require 'spec-i18n/runner/configuration'
+

data/lib/spec-i18n/spec_language.rb

@@ -0,0 +1,7 @@
+module SpecI18n
+  def spec_language
+    Spec::Runner.configuration.language
+  end
+end
+
+include SpecI18n

data/lib/spec-i18n.rb

@@ -0,0 +1,10 @@
+
+require 'yaml'
+require 'spec'
+require 'spec-i18n/platform'
+require 'spec-i18n/runner'
+require 'spec-i18n/spec_language'
+require 'spec-i18n/parser'
+require 'spec-i18n/example'
+require 'spec-i18n/expectations'
+require 'spec-i18n/dsl'

data/spec/spec-i18n/dsl/main_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+include Spec::DSL
+
+describe Main do
+  
+  before(:each) do
+    @languages = ["en", "pt", "es"]
+  end
+
+  describe 'the manipulation of methods of the domain specific language' do
+    
+      it "should have the methods of the dsl keywords of the language specified" do
+        @languages.each do |language|
+          Spec::Runner.configuration.spec_language(language)
+          dsl_keywords = SpecI18n::Parser::NaturalLanguage.get(language).dsl_keywords
+          dsl_keywords.values.flatten.each do |keyword|
+            Main.methods.should be_include(keyword)
+          end
+        end
+      end
+  end
+
+end

data/spec/spec-i18n/example/before_and_after_hooks_spec.rb

@@ -0,0 +1,129 @@
+require 'spec_helper'
+
+module Spec
+  module Example
+    describe BeforeAndAfterHooks do
+      
+      before(:each) do
+        @languages = ["pt", "en", "es"]
+      end
+      
+      it "should include all i18n methods to Before and After Hooks" do
+        @languages.each do |language|
+          Spec::Runner.configuration.spec_language(language)
+          language = SpecI18n::Parser::NaturalLanguage.get(language)
+          language.before_and_after_keywords.keys.map do |keyword|
+            BeforeAndAfterHooks.methods.should be_include(keyword)
+          end
+        end
+      end
+      
+      context "the before hook" do
+        
+        it "should translate the :each parameters and parse options" do
+          @languages.each do |language|
+            Spec::Runner.configuration.spec_language(language)
+            language = SpecI18n::Parser::NaturalLanguage.get(language)
+            scope = language.hooks_params_keywords["each"].first
+            self.should_receive(:before_each_parts)
+            before_parts(scope)
+          end
+        end
+    
+        it "should translate the :all scope and call the right method" do
+          @languages.each do |language|
+            Spec::Runner.configuration.spec_language(language)
+            language = SpecI18n::Parser::NaturalLanguage.get(language)
+            scope = language.hooks_params_keywords["all"].first
+            self.should_receive(:before_all_parts)
+            before_parts(scope)
+          end
+        end
+    
+        it "should translate the :suite scope and call the right method" do
+          @languages.each do |language|
+            Spec::Runner.configuration.spec_language(language)
+            language = SpecI18n::Parser::NaturalLanguage.get(language)
+            scope = language.hooks_params_keywords["suite"].first.to_sym
+            self.should_receive(:before_suite_parts)
+            before_parts(scope)
+          end
+        end
+      end
+      
+      context "the after hook" do
+        it "should translate the :all scope and call the right method" do
+          @languages.each do |language|
+            Spec::Runner.configuration.spec_language(language)
+            language = SpecI18n::Parser::NaturalLanguage.get(language)
+            scope = language.hooks_params_keywords["all"].first.to_sym
+            self.should_receive(:after_all_parts)
+            after_parts(scope)
+          end
+        end
+      end
+      
+      context "grep the scope and call the hook" do
+        
+        before(:each) do
+          @pt = Spec::Runner.configuration.spec_language(:pt)
+          @language = SpecI18n::Parser::NaturalLanguage.get(@pt)
+          @hooks = @language.hooks_params_keywords 
+        end
+        
+        it "should return the same scope if scope is in English" do
+          [:each, :all, :suite].each do |scope|
+            grep_the_scope(scope, @hooks).should == scope
+          end
+        end
+        
+        it "should grep the scope each" do
+          scopes = @hooks["each"]
+          scopes.each do |scope|
+            grep_the_scope(scope, @hooks).should == :each            
+          end
+        end
+        
+        it "should grep the scope all" do
+          scopes = @hooks["all"]
+          scopes.each do |scope|
+            grep_the_scope(scope, @hooks).should == :all
+          end
+        end
+        
+        it "should grep the scope suite" do
+          scopes = @hooks["suite"]
+          scopes.each do |scope|
+            grep_the_scope(scope, @hooks).should == :suite            
+          end
+        end
+        
+        context "with Symbol scopes" do
+          
+          it "should grep the scope :each" do
+            scopes = @hooks["each"].map { |hook| hook.to_sym }
+            scopes.each do |scope|
+              grep_the_scope(scope, @hooks).should == :each
+            end
+          end
+
+          it "should grep the scope :all" do
+            scopes = @hooks["all"].map { |hook| hook.to_sym }
+            scopes.each do |scope|
+              grep_the_scope(scope, @hooks).should == :all
+            end
+          end
+          
+          it "should grep the scope :suite" do
+            scopes = @hooks["suite"].map { |hook| hook.to_sym }
+            scopes.each do |scope|
+              grep_the_scope(scope, @hooks).should == :suite
+            end
+          end
+          
+        end
+      end
+          
+    end
+  end
+end

data/spec/spec-i18n/example/example_group_methods_spec.rb

@@ -0,0 +1,22 @@
+require "spec_helper"
+
+module Spec
+  module Example
+    describe ExampleGroupMethods do
+      
+      before(:each) do
+        @languages = ["pt", "es", "en"]
+      end
+      
+      it "should include #it example translated methods" do
+        @languages.each do |language|
+          Spec::Runner.configuration.spec_language(language)
+          language = SpecI18n::Parser::NaturalLanguage.get(language)
+          language.example_group_keywords.values.flatten.each do |keyword|
+            pending "I don't know wich module is included the keywords (Is 2:43 AM - I'll relaxing in my couch)"
+          end
+        end
+      end
+    end
+  end
+end

data/spec/spec-i18n/example_spec.rb

@@ -0,0 +1,47 @@
+require 'spec-i18n'
+
+Spec::Runner.configure do |config|
+  config.spec_language :pt
+end
+
+class Pessoa
+  attr_reader :idade
+  def initialize(nome, sobrenome, idade=0)
+    @nome = nome
+    @sobrenome = sobrenome
+    @idade = idade
+  end
+  
+  def nome_completo
+    "#{@nome} #{@sobrenome}"
+  end
+end
+
+# Silly Tests
+descreva Pessoa do
+  
+  antes(:de_todos) do
+    @pessoa = Pessoa.new("Tomás", "D'Stefano")
+  end
+  
+  antes(:de_cada) do
+    @pessoas = [@pessoa]
+  end
+  
+  depois(:de_todos) do
+    @outras_pessoas = @pessoas.dup
+  end
+  
+  depois(:de_cada) do
+    @outras_pessoas = []
+  end
+  
+  exemplo "deve retornar o nome completo" do
+    @pessoa.nome_completo.deve == "Tomás D'Stefano"
+  end
+  
+  especificar "a idade é opcional" do
+    Pessoa.new("Aaromn", "Monkey", 20).idade.deve == 20
+  end
+  
+end

data/spec/spec-i18n/expectations/kernel_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe Object, "#should and #should_not" do
+  
+  before(:each) do
+    @languages = ["pt", "en", "es"]
+  end
+
+  it "should have the 'should' and 'should_not' methods translated" do
+    @languages.each do |language|
+      Spec::Runner.configuration.spec_language(language)
+      language = SpecI18n::Parser::NaturalLanguage.get(language)
+      language.expectation_keywords.values.flatten.each do |keyword|
+        Kernel.methods.should be_include(keyword)
+      end
+    end
+  end
+end

data/spec/spec-i18n/parser/natural_language_spec.rb

@@ -0,0 +1,123 @@
+require 'spec_helper'
+
+module SpecI18n
+  module Parser
+    describe NaturalLanguage do
+
+      before(:each) do
+        @pt = NaturalLanguage.get('pt')
+        @es = NaturalLanguage.get('es')
+        @en = NaturalLanguage.get('en')
+      end
+
+      context "get languages" do
+        
+        it "should get the default language" do
+          NaturalLanguage.get("en").should_not be_nil
+        end
+        
+        it "should raise for the non existing language" do
+          language = "non_existing"
+          lambda {  
+            NaturalLanguage.new(language) 
+          }.should raise_error(LanguageNotFound, "Language #{language} Not Supported")
+        end
+
+      end
+
+      %w(describe before after it should).each do |keyword|
+        it "should have the #{keyword} keyword" do
+          @pt.keywords.keys.should be_include(keyword)
+        end
+      end
+
+      context "of dsl keywords" do
+      
+        it "should return all the dsl keywords" do
+          @pt.dsl_keywords.should == {"describe" => [ "descreva", "contexto"] }
+        end
+
+        it "should return the describe dsl keyword" do
+          lang = { "describe" => "descreva", :before => "antes" }
+          @pt.should_receive(:keywords).and_return(lang)
+          @pt.dsl_keywords.should == { "describe" => [ lang["describe"] ] }
+        end
+      end
+
+      context "of expectations keywords" do
+        
+        before(:each) do
+          @keywords = { "should" => ["deve"], "should_not" => ["nao_deve"] }
+        end
+
+        it "should return the expectation keyword of the language" do
+          lang = {"describe" => "descreva", "should" => "deve", "should_not" => "nao_deve"}
+          @pt.should_receive(:keywords).twice.and_return(lang)
+          @pt.expectation_keywords.should == @keywords
+        end
+        
+        it "should return the expectation keywords of the current language" do
+          keywords = { "should" => ["deberia"], "should_not" => ["no_debe"]}
+          @es.expectation_keywords.should == keywords
+        end
+      end
+      
+      context "of before and after keywords" do
+        
+        it "should return the hooks for the current language" do
+          keywords = { "before" => ["before"], "after" => ["after"]}
+          @en.before_and_after_keywords.should == keywords
+        end
+        
+        it "should return the hooks for the language" do
+          keywords = { "before" => ["antes"], "after" => ["depois"]}
+          @pt.before_and_after_keywords.should == keywords
+        end
+      end
+      
+      context "of hooks keywords" do
+        
+        it "should return the hooks parameters for the current language" do
+          keywords = { "each" => ["de_cada", "de_cada_exemplo"], 
+                       "all" => ["de_todos", "de_todos_exemplos"],
+                       "suite" => ["suite"]}
+          @pt.hooks_params_keywords.should == keywords                       
+        end
+      end
+      
+      context "of example group keywords" do
+        
+        before(:each) do
+          @keywords = { "it" => ["exemplo", "especificar"] }
+        end
+        
+        it "should return the example group keywords for the current language" do
+          @pt.example_group_keywords.should == @keywords
+        end
+        
+        it "should return the example group for the portuguese language" do
+          @keywords = { "it" => ["it", "specify"]}
+          @en.example_group_keywords.should == @keywords
+        end
+      end
+
+      context "of all matchers" do
+        it "should parse all matchers"
+      end
+
+      context "splitting the keys" do
+        it "should raise no found key" do
+          lambda {
+            @pt.spec_keywords("no_found")
+          }.should raise_error(RuntimeError)
+        end
+
+        it "should split correctly the keys" do
+         lang = { "describe" => "descreva|contexto" }
+         NaturalLanguage.instance_variable_set(:@keywords, lang["describe"])
+         @pt.spec_keywords("describe").should == { "describe" => ["descreva", "contexto"] }
+        end
+      end
+    end
+  end
+end

data/spec/spec-i18n/runner/configuration_spec.rb

@@ -0,0 +1,51 @@
+require 'spec_helper'
+
+module Spec
+  module Runner
+    describe Configuration do
+      with_sandboxed_options do
+        with_sandboxed_config do
+          describe "#spec_language" do
+
+            it "should default a english language for nil" do
+              config.spec_language(nil).should == "en"
+            end
+
+            it "should return a pt language" do
+              config.spec_language(:pt).should == "pt"
+            end
+
+            it "should return a es language using a Symbol" do
+              config.spec_language(:es).should == "es"
+            end
+            
+            it "should return a en language for the nil parameter" do
+              config.spec_language(nil)
+              config.language.should == "en"
+            end
+
+            it "should set the portuguese language" do
+              config.spec_language(:pt)
+              config.language.should == "pt"
+            end
+
+            it "should set the espanish language" do
+              config.spec_language(:es)
+              config.language.should == "es"
+            end
+
+          end
+          
+          describe "load language" do
+            before(:each) do
+              config.spec_language(:pt)
+            end
+            it "should load all the modules" do
+              config.load_language.should be_true
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/spec-i18n/runner/runner_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+module Spec
+  describe Runner do
+      
+      describe "the right language for the specs" do
+        
+        before(:each) do
+          @language = :pt
+        end
+        
+        it "should assign the spec_language" do
+          Spec::Runner.configure do |config|
+            config.spec_language @language
+          end
+          Spec::Runner.configuration.language.should == @language.to_s
+        end
+      end
+
+  end
+end

data/spec/spec-i18n/spec_language_spec.rb

@@ -0,0 +1,16 @@
+require "spec_helper"
+
+describe SpecI18n do
+  
+  before(:each) do
+    include SpecI18n
+  end
+  
+  it "should assign the spec language constant" do
+    languages = ["pt", "es"]
+    languages.each do |language|
+      Spec::Runner.configuration.spec_language(language)
+      spec_language.should == language
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,3 @@
+--colour
+--diff
+--format specdoc

data/spec/spec_helper.rb

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'ruby-debug'
+require 'spec'
+require 'spec-i18n'
+
+$:.unshift(File.dirname(__FILE__), '../lib')
+
+def with_sandboxed_options
+  attr_reader :options
+  
+  before(:each) do
+    @original_rspec_options = ::Spec::Runner.options
+    ::Spec::Runner.use(@options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new))
+  end
+
+  after(:each) do
+    ::Spec::Runner.use(@original_rspec_options)
+  end
+  
+  yield
+end
+
+def with_sandboxed_config
+  attr_reader :config
+  
+  before(:each) do
+    @config = ::Spec::Runner::Configuration.new
+    @original_configuration = ::Spec::Runner.configuration
+    spec_configuration = @config
+    ::Spec::Runner.instance_eval {@configuration = spec_configuration}
+  end
+  
+  after(:each) do
+    original_configuration = @original_configuration
+    ::Spec::Runner.instance_eval {@configuration = original_configuration}
+    ::Spec::Example::ExampleGroupFactory.reset
+  end
+  
+  yield
+end

metadata

@@ -0,0 +1,118 @@
+--- !ruby/object:Gem::Specification 
+name: rspec-i18n
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Tomas D'Stefano
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-27 00:00:00 -02:00
+default_executable: rspec-i18n
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: A internacionalization tool written in Ruby
+email: tomasdestefi@gmail.com
+executables: 
+- rspec-i18n
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- History.rdoc
+- License.txt
+- README.rdoc
+- Rakefile
+- TODO.txt
+- VERSION.yml
+- bin/rspec-i18n
+- examples/person_spec.rb
+- lib/spec-i18n.rb
+- lib/spec-i18n/dsl.rb
+- lib/spec-i18n/dsl/main.rb
+- lib/spec-i18n/example.rb
+- lib/spec-i18n/example/before_and_after_hooks.rb
+- lib/spec-i18n/example/example_group_methods.rb
+- lib/spec-i18n/expectations.rb
+- lib/spec-i18n/expectations/extensions.rb
+- lib/spec-i18n/expectations/extensions/kernel.rb
+- lib/spec-i18n/languages.yml
+- lib/spec-i18n/parser.rb
+- lib/spec-i18n/parser/natural_language.rb
+- lib/spec-i18n/platform.rb
+- lib/spec-i18n/runner.rb
+- lib/spec-i18n/runner/configuration.rb
+- lib/spec-i18n/spec_language.rb
+- spec/spec-i18n/dsl/main_spec.rb
+- spec/spec-i18n/example/before_and_after_hooks_spec.rb
+- spec/spec-i18n/example/example_group_methods_spec.rb
+- spec/spec-i18n/example_spec.rb
+- spec/spec-i18n/expectations/kernel_spec.rb
+- spec/spec-i18n/parser/natural_language_spec.rb
+- spec/spec-i18n/runner/configuration_spec.rb
+- spec/spec-i18n/runner/runner_spec.rb
+- spec/spec-i18n/spec_language_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/tomas-stefano/rspec-i18n
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: The internacionalization gem for Rspec
+test_files: 
+- spec/spec-i18n/dsl/main_spec.rb
+- spec/spec-i18n/example/before_and_after_hooks_spec.rb
+- spec/spec-i18n/example/example_group_methods_spec.rb
+- spec/spec-i18n/example_spec.rb
+- spec/spec-i18n/expectations/kernel_spec.rb
+- spec/spec-i18n/parser/natural_language_spec.rb
+- spec/spec-i18n/runner/configuration_spec.rb
+- spec/spec-i18n/runner/runner_spec.rb
+- spec/spec-i18n/spec_language_spec.rb
+- spec/spec_helper.rb
+- examples/person_spec.rb