rain_captcha 0.0.1

data/LICENSE.md

@@ -0,0 +1,21 @@
+Copyright (c) 2013 Jay Strybis
+
+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,44 @@
+# RainCaptcha
+
+A simple Ruby wrapper for the [RainCaptcha](http://raincaptcha.driversworld.us/) HTTP API.
+
+## Installation
+    gem install rain_captcha
+
+## Configuration
+### Use HTTPS
+```ruby
+RainCaptcha.configure do |config|
+  config.use_ssl = true
+end
+
+RainCaptcha.url("unique_identifier")
+=> "https://raincaptcha.driversworld.us/captcha/?key=unique_identifier"
+```
+
+## Examples
+### Get a Captcha image url
+```ruby
+RainCaptcha.url("unique_identifier")
+=> "http://raincaptcha.driversworld.us/captcha/?key=unique_identifier"
+```
+
+### Verify a user response
+```ruby
+RainCaptcha.verify("unique_identifier", "correct_response")
+=> true
+
+RainCaptcha.verify("unique_identifier", "incorrect_response")
+=> false
+```
+
+### RainCaptcha service not available
+```ruby
+RainCaptcha.verify("unique_identifier", "correct_response")
+=> Net::HTTPFatalError
+```
+## Copyright
+Copyright (c) 2013 Jay Strybis.
+See [LICENSE][] for details.
+
+[license]: LICENSE.md

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task default: :test
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end

data/lib/rain_captcha.rb

@@ -0,0 +1,35 @@
+require 'net/http'
+require 'rain_captcha/configuration'
+
+module RainCaptcha
+  extend Configuration
+
+  class << self
+    def url(identifier)
+      uri = URI(endpoint)
+      params = { key: identifier }
+      uri.query = URI.encode_www_form(params)
+      uri.to_s
+    end
+
+    def verify_url(identifier, answer)
+      verify_uri(identifier, answer).to_s
+    end
+
+    def verify_uri(identifier, answer)
+      uri = URI("#{endpoint}test/")
+      params = { key: identifier, code: answer }
+      uri.query = URI.encode_www_form(params)
+      uri
+    end
+
+    def verify(identifier, answer)
+      response = Net::HTTP.get_response(verify_uri(identifier, answer))
+      if response.is_a? Net::HTTPSuccess
+        response.body == "true"
+      else
+        response.value
+      end
+    end
+  end
+end

data/lib/rain_captcha/configuration.rb

@@ -0,0 +1,27 @@
+module RainCaptcha
+  module Configuration
+    attr_accessor :use_ssl
+
+    RAINCAPTCHA_URL = 'raincaptcha.driversworld.us/captcha/'
+
+    def self.extended(base)
+      base.reset
+    end
+
+    def configure
+      yield self
+    end
+
+    def protocol
+      self.use_ssl ? "https" : "http"
+    end
+
+    def endpoint
+      "#{self.protocol}://#{RAINCAPTCHA_URL}"
+    end
+
+    def reset
+      self.use_ssl = false
+    end
+  end
+end

data/lib/rain_captcha/version.rb

@@ -0,0 +1,4 @@
+module RainCaptcha
+  VERSION = "0.0.1" unless defined?(RainCaptcha::VERSION)
+end
+

data/rain_captcha.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rain_captcha/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = 'rain_captcha'
+  spec.version     = RainCaptcha::VERSION
+  spec.licenses    = ['MIT']
+  spec.authors     = ['Jay Strybis']
+  spec.email       = ['jay.strybis@gmail.com']
+  spec.homepage    = 'https://github.com/unreal/rain_captcha'
+  spec.summary     = %q{Rails plugin for RainCaptcha service}
+  spec.description = %q{Anti-spam protection for your website}
+
+  spec.files = %w(LICENSE.md rain_captcha.gemspec Rakefile README.md)
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.test_files = Dir.glob("test/**/*")
+
+  spec.require_paths = ['lib']
+  spec.required_rubygems_version = '>= 1.3.6'
+
+  spec.add_development_dependency 'bundler', '~> 1.0'
+  spec.add_development_dependency 'test-unit', '~> 2.5'
+  spec.add_development_dependency 'webmock', '~> 1.11'
+end
+

data/test/rain_captcha/configuration_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+
+class Foo
+  extend RainCaptcha::Configuration
+end
+
+class ConfigurationTest < Test::Unit::TestCase
+
+  def setup
+    Foo.reset
+  end
+
+  def test_protocol
+    assert_equal "http", Foo.protocol
+  end
+
+  def test_protocol_while_using_ssl
+    Foo.use_ssl = true
+    assert_equal "https", Foo.protocol
+  end
+
+  def test_endpoint
+    assert_equal 'http://raincaptcha.driversworld.us/captcha/', Foo.endpoint
+  end
+
+  def test_configure_user_ssl
+    Foo.configure do |c|
+      c.use_ssl = true
+    end
+
+    assert_equal 'https://raincaptcha.driversworld.us/captcha/', Foo.endpoint
+  end
+
+end

data/test/rain_captcha_test.rb

@@ -0,0 +1,41 @@
+require 'test_helper'
+require 'webmock/test_unit'
+
+class RainCaptchaTest < Test::Unit::TestCase
+
+  def test_url
+    assert_equal "http://raincaptcha.driversworld.us/captcha/?key=example_org%3A127.0.0.1", RainCaptcha.url("example_org:127.0.0.1")
+    assert_equal "http://raincaptcha.driversworld.us/captcha/?key=username%40example.org", RainCaptcha.url("username@example.org")
+  end
+
+  def test_verify_url
+    assert_equal "http://raincaptcha.driversworld.us/captcha/test/?key=example_org%3A127.0.0.1&code=abcde", RainCaptcha.verify_url("example_org:127.0.0.1","abcde")
+    assert_equal "http://raincaptcha.driversworld.us/captcha/test/?key=username%40example.org&code=fghij", RainCaptcha.verify_url("username@example.org","fghij")
+  end
+
+  def test_verify_uri_returns_a_uri
+    assert RainCaptcha.verify_uri("foo","bar").is_a? URI
+  end
+
+  def test_verify_true
+    stub_request(:get, "http://raincaptcha.driversworld.us/captcha/test/?code=bar&key=foo").
+      to_return(:status => 200, :body => "true")
+    assert RainCaptcha.verify("foo","bar")
+  end
+
+  def test_verify_false
+    stub_request(:get, "http://raincaptcha.driversworld.us/captcha/test/?code=bar&key=foo").
+      to_return(:status => 200, :body => "false")
+    assert !RainCaptcha.verify("foo","bar")
+  end
+
+  def test_verify_unsuccesful
+    stub_request(:get, "http://raincaptcha.driversworld.us/captcha/test/?code=bar&key=foo").
+      to_return(:status => 500)
+
+    assert_raise Net::HTTPFatalError do
+      RainCaptcha.verify("foo","bar")
+    end
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'test/unit'
+
+require 'rain_captcha'

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: rain_captcha
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Jay Strybis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.11'
+description: Anti-spam protection for your website
+email:
+- jay.strybis@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- rain_captcha.gemspec
+- Rakefile
+- README.md
+- lib/rain_captcha/configuration.rb
+- lib/rain_captcha/version.rb
+- lib/rain_captcha.rb
+- test/rain_captcha/configuration_test.rb
+- test/rain_captcha_test.rb
+- test/test_helper.rb
+homepage: https://github.com/unreal/rain_captcha
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Rails plugin for RainCaptcha service
+test_files:
+- test/rain_captcha/configuration_test.rb
+- test/rain_captcha_test.rb
+- test/test_helper.rb
+has_rdoc: