re_captcha 0.0.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4ff6ffb0b40900669efac36740ebcfcc1f9055e2
+  data.tar.gz: bda9557db4b3f23a9fd930b81742222a7450eaeb
+SHA512:
+  metadata.gz: c8610eff65a759829a7cda08b0e941924d5e11b8ca1c0c053cdf6439f1a97f83e901a47572a356709cb85e00e7edd81d4a4d2ab2bebb46a4241c0414399d7fa1
+  data.tar.gz: a792fa3709ae8f52fee267e214a04311ef4fd2d6c33d0d491a85a938ce01291e3246aa64ea61ef3e329431e4d4802144e3e734b6c3aa25b032c17b8c4fbeb32b

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rubocop.yml

@@ -0,0 +1,76 @@
+
+AllCops:
+  RunRailsCops: true
+
+LineLength:
+  Max: 120
+
+Style/AlignParameters:
+  Enabled: false
+
+Style/Encoding:
+  EnforcedStyle: 'when_needed'
+
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+
+Style/Blocks:
+  Enabled: false
+
+Style/TrailingComma:
+  Enabled: false
+
+Style/SingleSpaceBeforeFirstArg:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Metrics/ParameterLists:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/AccessorMethodName:
+  Enabled: false
+
+Rails/ActionFilter:
+  Enabled: false
+
+Metrics/BlockNesting:
+  Enabled: false
+
+DotPosition:
+  EnforcedStyle: leading
+
+PredicateName:
+  NamePrefixBlacklist:
+    - is_
+
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+Style/CollectionMethods:
+  # Mapping from undesired method to desired_method
+  # e.g. to use `detect` over `find`:
+  #
+  # CollectionMethods:
+  #   PreferredMethods:
+  #     find: detect
+  PreferredMethods:
+    collect: 'map'
+    collect!: 'map!'
+    inject: 'reduce'
+    reduce: false
+    find: 'detect'
+    find_all: 'select'

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+* 0.0.1
+
+- First release

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rest-client'
+
+group :development do
+  gem 'rake'
+end

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 David Jeusette
+
+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.md

@@ -0,0 +1,86 @@
+# ReCaptcha
+
+Gem to easily use reCaptcha
+
+Run tests with ``` rake ```
+
+Run console with preloaded library with ``` rake console ```
+
+## Getting started
+
+You first need to configure the gem.
+
+```
+ReCaptcha.configure do |config|
+  config.private_key = "secret key"
+  config.public_key  = "site key"
+end
+
+```
+
+Other options are:
+- api_endpoint (default: https://www.google.com/recaptcha/)
+- skipped_env (default: ['test', 'cucumber'])
+- language_table: the table to map locale with language code
+- deny_on_error: if the Google reCaptcha API can't be accessed, deny the verification (default: false)
+
+The default language table is the following:
+
+```
+{
+  'en-US' => 'en',
+  'fr-FR' => 'fr',
+  'es-ES' => 'es',
+  'pt-PT' => 'pt-PT',
+  'it-IT' => 'it',
+  'en-GB' => 'en-GB',
+  'de-DE' => 'de',
+  'pt-BR' => 'pt-BR',
+  'en-EU' => 'en-GB',
+  'es-LA' => 'es-419',
+  'zh-CN' => 'zh-CN',
+}
+```
+
+## Display
+
+To access the helpers in the views, make sure to include them in a Helper class
+such as ApplicationHelper (Rails)
+
+```
+module ApplicationHelper
+  include ReCaptcha::Helper
+end
+```
+
+Then include the script tag using this helper method in your view:
+```
+recaptcha_script(language: nil)
+```
+language is one of the locale defined in the language table.
+
+You can now add the reCaptcha box in your forms:
+```
+recaptcha_tags(options = {})
+```
+
+The options are the following:
+- theme: 'light'
+- type: 'image'
+- size: 'normal'
+- tab_index: 0
+- callback: nil
+- expired_callback: nil
+
+Check the reCaptcha doc for the available values (https://developers.google.com/recaptcha/docs/display).
+
+## Verification
+
+Assuming that your application uses Rails, verify the reCaptcha response using the method below:
+```
+recaptcha_valid?(response, remote_ip: nil, model: nil, message: nil)
+```
+
+This method can be called like this in a controller: ```ReCaptcha.client.recaptcha_valid?(...)```
+
+The response should be retrieved with ```params.fetch(:"g-recaptcha-response", "")```.  Optional args model and message allow to add an error with the given message on the :base attr of the provided model.

data/Rakefile

@@ -0,0 +1,15 @@
+require 'rspec/core/rake_task'
+
+desc 'Open an irb session with ReCaptcha preloaded'
+task :console do
+  exec 'irb -I lib -r re_captcha'
+end
+
+desc 'Run the test suite'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = FileList['spec/**/*_spec.rb']
+  t.rspec_opts = %w(--color --format doc)
+end
+
+task default: :spec
+task test: :spec

data/lib/re_captcha/api.rb

@@ -0,0 +1,30 @@
+require 'rest-client'
+
+module ReCaptcha
+  module API
+    def post(path, params, options: {}, end_point: api_endpoint)
+      http_request do
+        uri      = URI(end_point).merge(path).to_s
+        resource = RestClient::Resource.new(uri, options.merge(default_options))
+        response = resource.post params.merge(default_params)
+        JSON.parse response
+      end
+    end
+
+    private
+
+    def default_params
+      { secret: private_key }
+    end
+
+    def default_options
+      { read_timeout: 3, open_timeout: 3 }
+    end
+
+    def http_request(&block)
+      block.call
+    rescue RestClient::RequestTimeout, RestClient::ExceptionWithResponse, RestClient::RequestFailed
+      { 'success' => !deny_on_error }
+    end
+  end
+end

data/lib/re_captcha/application.rb

@@ -0,0 +1,40 @@
+require 're_captcha/api'
+require 're_captcha/secure_token_builder'
+
+module ReCaptcha
+  module Application
+    include API
+
+    def recaptcha_valid?(response, remote_ip: nil, model: nil, message: nil)
+      return true if should_skip_verification?
+      params = generate_verification_params(response, remote_ip)
+      verification = verify_recaptcha(params)
+      valid = verification['success']
+      add_error_on_model(model, message) unless valid
+      valid
+    end
+
+    def secure_token
+      secure_token_builder = SecureTokenBuilder.new(private_key)
+      secure_token_builder.build
+    end
+
+    private
+
+    def verify_recaptcha(params)
+      post 'api/siteverify', params, options: { verify_ssl: false }
+    end
+
+    def generate_verification_params(response, remote_ip)
+      { response: response, secret: private_key, remoteip: remote_ip }
+    end
+
+    def should_skip_verification?
+      skipped_env.include? env
+    end
+
+    def add_error_on_model(model, message)
+      model.errors.add :base, message if model && message
+    end
+  end
+end

data/lib/re_captcha/client.rb

@@ -0,0 +1,22 @@
+require 'forwardable'
+require 're_captcha/application'
+require 're_captcha/exceptions'
+
+module ReCaptcha
+  class Client
+    extend Forwardable
+    include Application
+
+    attr_reader :env
+
+    def initialize(configuration)
+      @configuration = configuration
+      @env           = ENV['RACK_ENV'] || ENV['RAILS_ENV'] || 'development'
+      raise ConfigurationError.new('Invalid configuration') unless configuration.valid?
+    end
+
+    def_delegators :@configuration, :api_endpoint,
+      :public_key, :private_key, :skipped_env, :language_code,
+      :deny_on_error
+  end
+end

data/lib/re_captcha/configurable.rb

@@ -0,0 +1,13 @@
+require 're_captcha/configuration'
+
+module ReCaptcha
+  module Configurable
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration) if block_given?
+    end
+  end
+end

data/lib/re_captcha/configuration.rb

@@ -0,0 +1,39 @@
+module ReCaptcha
+  class Configuration
+    API_END_POINT = 'https://www.google.com/recaptcha/'
+    SKIPPED_ENVIRONMENTS = %w(test cucumber)
+    LANGUAGE_TABLE = {
+      'en-US' => 'en',
+      'fr-FR' => 'fr',
+      'es-ES' => 'es',
+      'pt-PT' => 'pt-PT',
+      'it-IT' => 'it',
+      'en-GB' => 'en-GB',
+      'de-DE' => 'de',
+      'pt-BR' => 'pt-BR',
+      'en-EU' => 'en-GB',
+      'es-LA' => 'es-419',
+      'zh-CN' => 'zh-CN',
+    }
+
+    attr_accessor :api_endpoint, :public_key,
+      :private_key, :skipped_env, :language_table, :deny_on_error
+
+    def initialize
+      @api_endpoint   = API_END_POINT
+      @skipped_env    = SKIPPED_ENVIRONMENTS
+      @public_key     = ENV['RECAPTCHA_PUBLIC_KEY']
+      @private_key    = ENV['RECAPTCHA_PRIVATE_KEY']
+      @language_table = LANGUAGE_TABLE
+      @deny_on_error  = false
+    end
+
+    def language_code(locale)
+      @language_table[locale] || 'en'
+    end
+
+    def valid?
+      !private_key.nil? && !public_key.nil?
+    end
+  end
+end

data/lib/re_captcha/exceptions.rb

@@ -0,0 +1,3 @@
+module ReCaptcha
+  class ConfigurationError < StandardError; end
+end

data/lib/re_captcha/helper.rb

@@ -0,0 +1,31 @@
+module ReCaptcha
+  module Helper
+    def recaptcha_tags(options = {})
+      html = ''
+      html << %(<div class="g-recaptcha" data-sitekey="#{ReCaptcha.client.public_key}" )
+      html << %(data-stoken="#{ReCaptcha.client.secure_token}" #{tag_attributes(options)}></div>\n)
+      html.respond_to?(:html_safe) ? html.html_safe : html
+    end
+
+    def recaptcha_script(language: nil)
+      html = ''
+      html << %(<script src="#{ReCaptcha.client.api_endpoint}api.js#{language_query(language)}" async defer></script>\n)
+      html.respond_to?(:html_safe) ? html.html_safe : html
+    end
+
+    private
+
+    def tag_attributes(theme: 'light', type: 'image', size: 'normal',
+      tab_index: 0, callback: nil, expired_callback: nil)
+      attributes = ''
+      attributes << %(data-theme="#{theme}" data-type="#{type}" data-size="#{size}" data-tabindex="#{tab_index}" )
+      attributes << %(data-callback="#{callback}" ) if callback
+      attributes << %(data-expired-callback="#{expired_callback}") if expired_callback
+      attributes.respond_to?(:html_safe) ? attributes.html_safe : attributes
+    end
+
+    def language_query(language)
+      "?hl=#{ReCaptcha.client.language_code(language)}" if language
+    end
+  end
+end

data/lib/re_captcha/secure_token_builder.rb

@@ -0,0 +1,45 @@
+require 'json'
+require 'securerandom'
+require 'openssl'
+require 'base64'
+
+module ReCaptcha
+  class SecureTokenBuilder
+    def initialize(private_key)
+      @private_key = private_key
+    end
+
+    def build
+      json_token = generate_json_token
+      private_key_digest = digest_key @private_key
+      cipher = prepare_cipher private_key_digest
+      encode_token json_token, cipher
+    end
+
+    private
+
+    def encode_token(token, cipher)
+      encrypted_token = cipher.update(token) << cipher.final
+      strip_padding Base64.urlsafe_encode64(encrypted_token)
+    end
+
+    def digest_key(key)
+      Digest::SHA1.digest(key)[0...16]
+    end
+
+    def prepare_cipher(key)
+      cipher = OpenSSL::Cipher::AES128.new(:ECB)
+      cipher.encrypt
+      cipher.key = key
+      cipher
+    end
+
+    def generate_json_token
+      { session_id: SecureRandom.uuid, ts_ms: (Time.now.to_f * 1000).to_i }.to_json
+    end
+
+    def strip_padding(string)
+      string.gsub(/\=+\Z/, '')
+    end
+  end
+end

data/lib/re_captcha/version.rb

@@ -0,0 +1,3 @@
+module ReCaptcha
+  VERSION = '0.0.6'.freeze
+end

data/lib/re_captcha.rb

@@ -0,0 +1,15 @@
+require 're_captcha/configurable'
+require 're_captcha/client'
+require 're_captcha/helper'
+
+module ReCaptcha
+  extend Configurable
+
+  MUTEX = Mutex.new
+
+  def self.client
+    MUTEX.synchronize do
+      @client ||= ReCaptcha::Client.new(configuration)
+    end
+  end
+end

data/re_captcha.gemspec

@@ -0,0 +1,21 @@
+require File.expand_path('../lib/re_captcha/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.add_development_dependency 'rspec', '~> 3.0'
+  gem.add_development_dependency 'bundler', '~> 1.7'
+  gem.add_development_dependency 'rake', '~> 10.0'
+  gem.add_development_dependency 'webmock', '~> 1.21'
+
+  gem.name = 're_captcha'
+  gem.summary = 'reCaptcha helpers'
+  gem.description = 'Google reCaptcha helpers and verifier'
+  gem.version = ReCaptcha::VERSION.dup
+  gem.authors = ['David Jeusette']
+  gem.email = ['david@textmaster.com']
+  gem.homepage = 'https://github.com/textmaster/re_captcha'
+  gem.require_paths = ['lib']
+  gem.license = 'MIT'
+
+  gem.files = `git ls-files`.split("\n")
+  gem.test_files = `git ls-files -- spec/*`.split("\n")
+end

data/spec/re_captcha/client_spec.rb

@@ -0,0 +1,225 @@
+require 'spec_helper'
+
+describe ReCaptcha::Client do
+
+  describe '#new' do
+    it 'should not accept no parameters' do
+      expect { described_class.new }.to raise_error ArgumentError
+    end
+
+    context 'with an invalid configuration' do
+      let(:configuration) { instance_double('ReCaptcha::Configuration', valid?: false) }
+
+      it 'should raise a ReCaptcha::ConfigurationError error' do
+        expect { described_class.new(configuration) }.to raise_error ReCaptcha::ConfigurationError
+      end
+    end
+
+    context 'with a valid configuration' do
+      let(:configuration) { instance_double('ReCaptcha::Configuration', valid?: true) }
+      let(:instance) { described_class.new(configuration) }
+
+      it 'should accept (configuration) as parameter' do
+        expect(described_class).to receive(:new).with(configuration).and_return(instance)
+        expect { described_class.new(configuration) }.to_not raise_error
+      end
+
+      it 'should return a proper instance' do
+        expect { described_class.new(configuration) }.to_not raise_error
+      end
+    end
+  end
+
+  describe 'instance' do
+    before(:all) do
+      ReCaptcha.configure do |config|
+        config.public_key = 'foo'
+        config.private_key = 'bar'
+        config.skipped_env = ['my-test']
+      end
+    end
+
+    let(:configuration) { ReCaptcha.configuration }
+    let(:instance) { ReCaptcha.client }
+
+    it { expect(instance).to respond_to(:env) }
+    it { expect(instance).to respond_to(:private_key) }
+    it { expect(instance).to respond_to(:public_key) }
+    it { expect(instance).to respond_to(:api_endpoint) }
+    it { expect(instance).to respond_to(:skipped_env) }
+    it { expect(instance).to respond_to(:recaptcha_valid?) }
+    it { expect(instance).to respond_to(:secure_token) }
+
+    describe '#private_key' do
+      subject(:private_key) { instance.private_key }
+
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:private_key)
+        instance.private_key
+      end
+
+      it 'returns the correct private key' do
+        expect(subject).to eq('bar')
+      end
+    end
+
+    describe '#public_key' do
+      subject(:public_key) { instance.public_key }
+
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:public_key)
+        instance.public_key
+      end
+
+      it 'returns the correct public key' do
+        expect(subject).to eq('foo')
+      end
+    end
+
+    describe '#api_endpoint' do
+      subject(:api_endpoint) { instance.api_endpoint }
+
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:api_endpoint)
+        instance.api_endpoint
+      end
+
+      it 'returns the correct api_endpoint' do
+        expect(subject).to eq('https://www.google.com/recaptcha/')
+      end
+    end
+
+    describe '#skipped_env' do
+      subject(:skipped_env) { instance.skipped_env }
+
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:skipped_env)
+        instance.skipped_env
+      end
+
+      it 'returns the correct skipped_env' do
+        expect(subject).to be_a(Array)
+        expect(subject).to eq(['my-test'])
+      end
+    end
+
+    describe '#deny_on_error' do
+      subject(:deny_on_error) { instance.deny_on_error }
+
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:deny_on_error)
+        instance.deny_on_error
+      end
+
+      it 'returns the correct value' do
+        expect(subject).to be_a(FalseClass)
+        expect(subject).to eq(false)
+      end
+    end
+
+    describe '#language_code' do
+      it 'delegates to configuration' do
+        expect(configuration).to receive(:language_code)
+        instance.language_code 'zh-CN'
+      end
+    end
+
+    describe '#recaptcha_valid?' do
+      context 'with a correct response' do
+
+        before(:all) do
+          body = { 'remoteip' => '', 'response' => 'correct response', 'secret' => 'bar' }
+          stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify')
+            .with(body: body)
+            .to_return(status: 200, body: { success: true }.to_json)
+        end
+
+        let(:response) { 'correct response' }
+
+        it 'returns true' do
+          expect(instance.recaptcha_valid?(response)).to eq(true)
+        end
+      end
+
+      context 'with an incorrect response' do
+
+        before(:all) do
+          body = { 'remoteip' => '', 'response' => 'incorrect response', 'secret' => 'bar' }
+          stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify')
+            .with(body: body)
+            .to_return(status: 200, body: { success: false }.to_json)
+        end
+
+        let(:response) { 'incorrect response' }
+
+        it 'returns false' do
+          expect(instance.recaptcha_valid?(response)).to eq(false)
+        end
+      end
+
+      context 'in a skipped environment' do
+
+        it 'always returns true' do
+          allow(instance).to receive(:env) { 'my-test' }
+          expect(instance.recaptcha_valid?('foo')).to eq(true)
+        end
+      end
+
+      context 'when the request timeouts' do
+        before(:all) do
+          stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify').to_timeout
+        end
+
+        it 'returns true' do
+          expect(instance.recaptcha_valid?('foo')).to eq(true)
+        end
+      end
+
+      context 'when Google responds with a 40X error' do
+        before(:all) do
+          stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify')
+            .to_return(status: [401, 'Unauthorized'])
+        end
+
+        it 'returns true' do
+          expect(instance.recaptcha_valid?('foo')).to eq(true)
+        end
+      end
+
+      context 'when Google responds with a 50X error' do
+        before(:all) do
+          stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify')
+            .to_return(status: [500, 'Internal Server Error'])
+        end
+
+        it 'returns true' do
+          expect(instance.recaptcha_valid?('foo')).to eq(true)
+        end
+      end
+
+      context 'with deny on error activated' do
+        context 'when Google responds with a 50X error' do
+          before(:all) do
+            stub_request(:post, 'https://www.google.com/recaptcha/api/siteverify')
+              .to_return(status: [500, 'Internal Server Error'])
+          end
+
+          it 'returns false' do
+            allow(instance).to receive(:deny_on_error) { true }
+            expect(instance.recaptcha_valid?('foo')).to eq(false)
+          end
+        end
+      end
+    end
+
+    describe '#secure_token' do
+      let(:secure_token_builder) { instance_double("ReCaptcha::SecureTokenBuilder") }
+
+      it 'delegates to SecureTokenBuilder' do
+        ReCaptcha::SecureTokenBuilder.stub(:new).and_return(secure_token_builder)
+        expect(secure_token_builder).to receive(:build)
+        instance.secure_token
+      end
+    end
+  end
+end

data/spec/re_captcha/configuration_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe ReCaptcha::Configuration do
+  let(:instance) { described_class.new }
+
+  describe 'instance' do
+    it { expect(instance).to respond_to(:api_endpoint) }
+    it { expect(instance).to respond_to(:public_key) }
+    it { expect(instance).to respond_to(:private_key) }
+    it { expect(instance).to respond_to(:skipped_env) }
+    it { expect(instance).to respond_to(:language_code) }
+    it { expect(instance).to respond_to(:deny_on_error) }
+
+    describe '#language_code' do
+      context 'when the language table contains the locale' do
+        it 'should return the correct language code' do
+          expect(instance.language_code('zh-CN')).to eq('zh-CN')
+        end
+      end
+
+      context 'when the language table does not contain the locale' do
+        it 'should return "en"' do
+          expect(instance.language_code('foo')).to eq('en')
+        end
+      end
+    end
+
+    describe '#valid?' do
+      context 'when private and public keys are given' do
+        it 'should return true' do
+          allow(instance).to receive(:private_key) { 'foo' }
+          allow(instance).to receive(:public_key) { 'bar' }
+          expect(instance.valid?).to eq(true)
+        end
+      end
+
+      context 'when the private or public key is missing' do
+        it 'should return false' do
+          allow(instance).to receive(:public_key) { 'bar' }
+          allow(instance).to receive(:private_key) { nil }
+          expect(instance.valid?).to eq(false)
+        end
+      end
+    end
+  end
+end

data/spec/re_captcha/helper_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+
+describe ReCaptcha::Helper do
+  let(:dummy_class) { Class.new { include ReCaptcha::Helper } }
+
+  before(:all) do
+    ReCaptcha.configure do |config|
+      config.private_key = 'foo'
+      config.public_key = 'bar'
+    end
+  end
+
+  subject { dummy_class.new }
+
+  it { expect(subject).to respond_to(:recaptcha_tags) }
+  it { expect(subject).to respond_to(:recaptcha_script) }
+
+  describe '#recaptcha_tags' do
+    context 'with options' do
+      it 'should return an html tag' do
+        expect(subject.recaptcha_tags(theme: 'dark')).to be_a(String)
+        expect(subject.recaptcha_tags(theme: 'dark')).to match(/data-theme="dark"/)
+      end
+    end
+
+    context 'without options' do
+      it 'should return an html tag' do
+        expect(subject.recaptcha_tags).to be_a(String)
+        expect(subject.recaptcha_tags).to match(/data-theme="light"/)
+      end
+    end
+  end
+
+  describe '#recaptcha_script' do
+    context 'without locale' do
+      it 'should return an html tag without language code' do
+        expect(subject.recaptcha_script).to be_a(String)
+        expect(subject.recaptcha_script).to match(/api.js\" async defer>/)
+      end
+    end
+
+    context 'with a known locale' do
+      it 'should return an html tag with the right language code' do
+        expect(subject.recaptcha_script(language: 'zh-CN')).to be_a(String)
+        expect(subject.recaptcha_script(language: 'zh-CN')).to match(/api.js\?hl=zh-CN\" async defer>/)
+      end
+    end
+
+    context 'with an unknown locale' do
+      it 'should return an html tag with the "en" language code' do
+        expect(subject.recaptcha_script(language: 'foo-BAR')).to be_a(String)
+        expect(subject.recaptcha_script(language: 'foo-BAR')).to match(/api.js\?hl=en\" async defer>/)
+      end
+    end
+  end
+end

data/spec/re_captcha/secure_token_builder_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe ReCaptcha::SecureTokenBuilder do
+  let(:key) { 'my secret key' }
+  let(:instance) { described_class.new(key)}
+
+  describe 'instance' do
+    it { expect(instance).to respond_to(:build) }
+
+    describe '#build' do
+      it 'builds a secure token' do
+        expect(instance.build).to be_a(String)
+        expect(instance.build).not_to be_empty
+      end
+    end
+  end
+end

data/spec/re_captcha_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe ReCaptcha do
+  it { expect(described_class).to respond_to(:client) }
+  it { expect(described_class).to respond_to(:configuration) }
+  it { expect(described_class).to respond_to(:configure) }
+
+  describe '.configure' do
+    let(:configuration) { instance_double('ReCaptcha::Configuration') }
+
+    it 'yields configuration' do
+      expect(described_class).to receive(:configure).and_yield(configuration)
+      expect { |b| described_class.configure(&b) }.to yield_with_args(configuration)
+    end
+  end
+
+  describe '.configuration' do
+    let(:configuration) { instance_double('ReCaptcha::Configuration') }
+
+    it 'returns the configuration' do
+      expect(described_class).to receive(:configuration).and_return(configuration)
+      described_class.configuration
+    end
+  end
+
+  describe '.client' do
+    let(:client) { instance_double('ReCaptcha::Client') }
+
+    it 'returns the client instance' do
+      expect(described_class).to receive(:client).and_return(client)
+      described_class.client
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require 're_captcha'
+require 'webmock/rspec'
+require 'json'

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: re_captcha
+version: !ruby/object:Gem::Version
+  version: 0.0.6
+platform: ruby
+authors:
+- David Jeusette
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+description: Google reCaptcha helpers and verifier
+email:
+- david@textmaster.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/re_captcha.rb
+- lib/re_captcha/api.rb
+- lib/re_captcha/application.rb
+- lib/re_captcha/client.rb
+- lib/re_captcha/configurable.rb
+- lib/re_captcha/configuration.rb
+- lib/re_captcha/exceptions.rb
+- lib/re_captcha/helper.rb
+- lib/re_captcha/secure_token_builder.rb
+- lib/re_captcha/version.rb
+- re_captcha.gemspec
+- spec/re_captcha/client_spec.rb
+- spec/re_captcha/configuration_spec.rb
+- spec/re_captcha/helper_spec.rb
+- spec/re_captcha/secure_token_builder_spec.rb
+- spec/re_captcha_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/textmaster/re_captcha
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: reCaptcha helpers
+test_files:
+- spec/re_captcha/client_spec.rb
+- spec/re_captcha/configuration_spec.rb
+- spec/re_captcha/helper_spec.rb
+- spec/re_captcha/secure_token_builder_spec.rb
+- spec/re_captcha_spec.rb
+- spec/spec_helper.rb