has_face 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use @has_face --create

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,133 @@
+# Has face
+An Active model validator to validate that images contain faces by
+using the face.com API. The validator works by uploading images to
+face.com and then checking to see if any faces were tagged in the photo.
+It has been tested with carrierwave attachments but will work with any
+attachment type that correctly responds to a `path` method.
+
+## Requirements
+- Rails 3.0 or greater
+- An account for accessing the face.com API (They are free at the moment)
+
+## Installation
+Add has_face to your Gemfile and then bundle
+
+``` ruby
+gem 'has_face'
+```
+
+Once installed run the generator to create an initializer
+
+``` ruby
+rails g has_face:install
+```
+
+Then open up `config/initializers/has_face.rb` and enter your face.com
+API details.
+
+``` ruby
+# config/initializers/has_face.rb
+HasFace.configure do |config|
+  config.api_key                  = 'your face.com API key'
+  config.api_secret               = 'your face.com API secret'
+  config.skip_validation_on_error = false
+end
+```
+
+## Usage
+
+Simply add a validation to the image you want to ensure has faces:
+
+``` ruby
+class User < ActiveRecord::Base
+  validates :avatar, :has_face => true
+end
+```
+
+The `allow_nil` and `allow_blank` options are supported:
+
+``` ruby
+class User < ActiveRecord::Base
+  validates :avatar, :has_face => true, :allow_blank => true
+end
+```
+
+## i18n
+
+Error messages generated are i18n safe. To alter the error message shown
+add this to your `config/locale/en.yml`
+
+``` ruby
+en:
+  activerecord:
+    errors:
+      messages:
+        no_face: "We couldn't see a face in your photo, try taking another one."
+```
+
+
+## Error Handling
+
+By default has_face will raise either a `HasFace::FaceAPIError` or
+`HasFace::HTTPRequestError` on failure. You will need to catch these
+errors and then take the appropriate action in your application like so:
+
+``` ruby
+begin
+  @user = User.create(params[:user])
+rescue HasFace::FaceAPIError, HasFace::HTTPRequestError => e
+  # Perform some sort of action.
+end
+```
+
+If you would like to skip valdiation when a HTTP or API error occurs
+then simply turn on the `skip_validation_on_error` configuration option:
+
+``` ruby
+HasFace.configure do |config|
+  config.skip_validation_on_error = true
+end
+```
+
+If an error does occur then it will be logged as a warning in the log
+for your applications current environment.
+
+## Testing has_face
+
+To speed up your test suite, you can disable face validations by setting the
+`enable_validation` config value to false, this is usally best done in
+your test config.
+
+``` ruby
+HasFace.enable_validation = false
+```
+
+Has Face supplies a matcher which you can use in your tests, to
+enable it, include the matchers module in your rspec config.
+
+``` ruby
+RSpec.configure do |config|
+  config.include HasFace::Test::Matchers
+end
+```
+
+
+Once included he matcher can be used:
+
+``` ruby
+context 'validations' do
+  it { should validate_has_face_for :avatar }
+end
+```
+
+The options `allow_blank` and `allow_nil` can also be passed to the matcher:
+
+``` ruby
+it { should validate_has_face_for :avatar, :allow_blank => true }
+```
+
+### Contributing
+
+Fork on GitHub and after you’ve committed tested patches, send a pull request.
+
+To get tests running simply run `bundle install` and then `rspec spec`

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/has_face.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "has_face/version"
+
+Gem::Specification.new do |s|
+  s.name        = "has_face"
+  s.version     = HasFace::VERSION
+  s.authors     = ["Mario Visic"]
+  s.email       = ["mario@mariovisic.com"]
+  s.homepage    = "https://github.com/mariovisic/has_face"
+  s.summary     = "Easily validate if an image contains faces"
+  s.description = "An Active Model validator that uses the face.com API to ensures an image contains a face"
+
+  s.rubyforge_project = "has_face"
+
+  s.add_dependency 'rails', '>= 3.0'
+  s.add_dependency 'rest-client'
+
+  s.add_development_dependency 'rspec',    '>= 2.0'
+  s.add_development_dependency 'rr',       '>= 1.0'
+  s.add_development_dependency 'vcr',      '>= 1.0'
+  s.add_development_dependency 'fakeweb',  '>= 1.0'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/generators/has_face/install_generator.rb

@@ -0,0 +1,15 @@
+module HasFace
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Copy HasFace default files"
+      source_root File.expand_path('../templates', __FILE__)
+      class_option :template_engine
+
+      def copy_initializers
+        copy_file 'has_face.rb', 'config/initializers/has_face.rb'
+      end
+
+    end
+  end
+end
+

data/lib/generators/has_face/templates/has_face.rb

@@ -0,0 +1,5 @@
+HasFace.configure do |config|
+  config.api_key                  = 'your face.com API key'
+  config.api_secret               = 'your face.com API secret'
+  config.skip_validation_on_error = false
+end

data/lib/has_face/configuration.rb

@@ -0,0 +1,17 @@
+module HasFace
+  class Configuration
+
+    @enable_validation        = true
+    @skip_validation_on_error = false
+    @detect_url               = "http://api.face.com/faces/detect.json"
+
+    class << self
+      attr_accessor :enable_validation
+      attr_accessor :detect_url
+      attr_accessor :api_key
+      attr_accessor :api_secret
+      attr_accessor :skip_validation_on_error
+    end
+
+  end
+end

data/lib/has_face/locales/en.yml

@@ -0,0 +1,5 @@
+en:
+  activerecord:
+    errors:
+      messages:
+        no_face: "We couldn't see a face in your photo, try taking another one."

data/lib/has_face/test/matchers.rb

@@ -0,0 +1,56 @@
+module HasFace
+  module Test
+    module Matchers
+
+      class ValidateHasFaceFor
+
+        def initialize(expected, options)
+          @expected = expected
+          @options  = options
+        end
+
+        def matches?(actual)
+          @actual = actual
+
+          @actual.class.validators.any? do |validator|
+            validator.is_a?(HasFace::Validator) && \
+              validator.attributes.include?(@expected) && \
+              has_correct_allow_blank(validator) && \
+              has_correct_allow_nil(validator)
+          end
+
+        end
+
+        def failure_message
+          "expected #{@actual.class.to_s} to validate has face for #{@expected.inspect} #{with_options_message}"
+        end
+
+        def negative_failure_message
+          "expected #{@actual.class.to_s} not to validate has face for #{@expected.inspect} #{with_options_message}"
+        end
+
+        def has_correct_allow_blank(validator)
+          return true if @options[:allow_blank].nil?
+          validator.instance_variable_get('@allow_blank') == @options[:allow_blank]
+        end
+
+        def has_correct_allow_nil(validator)
+          return true if @options[:allow_nil].nil?
+          validator.instance_variable_get('@allow_nil') == @options[:allow_nil]
+        end
+
+        def with_options_message
+          if @options.present?
+            "with options #{@options.inspect}"
+          end
+        end
+
+      end
+
+      def validate_has_face_for(expected, options = {})
+        ValidateHasFaceFor.new(expected, options)
+      end
+
+    end
+  end
+end

data/lib/has_face/validator.rb

@@ -0,0 +1,74 @@
+require 'rest_client'
+
+module HasFace
+  class Validator < ActiveModel::EachValidator
+
+    def initialize(options)
+      @allow_nil, @allow_blank = options.delete(:allow_nil), options.delete(:allow_blank)
+      super
+    end
+
+    def validate_each(record, attr_name, value)
+
+      # Skip validation if globally turned off
+      return if HasFace.enable_validation == false
+
+      image      = record.send(attr_name)
+      image_path = image.try(:path) if image.respond_to?(:path)
+
+      # Skip validation if our image is nil/blank and allow nil/blank is on
+      return if (@allow_nil && image.nil?) || (@allow_blank && image.blank?)
+
+      # Add an error if the url is blank
+      return record.errors.add(attr_name, :no_face) if image_path.blank?
+
+      # Get an parse the JSON response
+      params   = { :api_key => HasFace.api_key, :api_secret => HasFace.api_secret, :image => File.new(image_path, 'rb') }
+
+      begin
+        response = RestClient.post(HasFace.detect_url, params)
+      rescue RestClient::Exception => error
+        return handle_request_error(error)
+      end
+
+      json_response = JSON.parse(response.body)
+
+      # Error handling for failed responses
+      return handle_api_error(json_response) unless json_response['status'] == 'success'
+
+
+      # Add errors if no tags are present
+      tags = json_response.try(:[], 'photos').try(:first).try(:[], 'tags') || []
+      record.errors.add(attr_name, :no_face) if tags.blank?
+
+    end
+
+    protected
+
+    def handle_api_error(response)
+      error_message = "face.com API Error: \"#{response['error_message']}\" Code: #{response['error_code']}"
+
+      if HasFace.skip_validation_on_error
+        Rails.logger.warn error_message if Rails.logger.present?
+        true
+      else
+        raise FaceAPIError.new error_message
+      end
+    end
+
+    def handle_request_error(error)
+      error_message = "has_face HTTP Request Error: \"#{error.message}\""
+
+      if HasFace.skip_validation_on_error
+        Rails.logger.warn error_message if Rails.logger.present?
+        true
+      else
+        raise HTTPRequestError.new error_message
+      end
+    end
+
+  end
+end
+
+# Compatibility with ActiveModel validates method which matches option keys to their validator class
+ActiveModel::Validations::HasFaceValidator = HasFace::Validator

data/lib/has_face/version.rb

@@ -0,0 +1,3 @@
+module HasFace
+  VERSION = "0.0.1"
+end

data/lib/has_face.rb

@@ -0,0 +1,30 @@
+require 'has_face/configuration'
+require 'has_face/validator'
+require 'has_face/version'
+require 'has_face/test/matchers'
+
+module HasFace
+
+  # Error classes
+  class FaceAPIError < StandardError; end
+  class HTTPRequestError < StandardError; end
+
+  # Add load paths straight to I18n, so engines and application can overwrite it.
+  require 'i18n'
+  I18n.load_path << File.expand_path('../has_face/locales/en.yml', __FILE__)
+
+  class << self
+
+    configs = [ :api_key, :api_secret, :enable_validation, :detect_url, :skip_validation_on_error ]
+
+    configs.each do |config|
+      delegate config, "#{config}=", :to => HasFace::Configuration
+    end
+
+    def configure
+      yield self
+    end
+
+  end
+
+end

data/spec/has_face/test/matchers_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe HasFace::Test::Matchers do
+
+  context 'a user without face valdiation' do
+
+    subject { UserWithoutFaceValidation.new }
+
+    it { should_not validate_has_face_for :avatar }
+
+  end
+
+  context 'a user with face validation' do
+
+    subject { UserWithFaceValidation.new }
+
+    it { should validate_has_face_for :avatar }
+
+  end
+
+  context 'a user with face validation and allow blank' do
+
+    subject { UserWithAllowBlank.new }
+
+    it { should validate_has_face_for     :avatar, :allow_blank => true }
+    it { should_not validate_has_face_for :avatar, :allow_blank => false }
+
+  end
+
+  context 'a user with face validation and allow nil' do
+
+    subject { UserWithAllowNil.new }
+
+    it { should validate_has_face_for     :avatar, :allow_nil => true }
+    it { should_not validate_has_face_for :avatar, :allow_nil => false }
+
+  end
+
+end

data/spec/has_face/validator_spec.rb

@@ -0,0 +1,211 @@
+require 'spec_helper'
+
+describe HasFace::Validator do
+
+  let(:user)   { User.new(:avatar => avatar) }
+  let(:avatar) { Avatar.new }
+
+  context 'when validation is globally turned on' do
+
+    context 'when the image is a valid face' do
+
+      before :each do
+        avatar.path = VALID_IMAGE_PATH
+      end
+
+      it 'should be valid' do
+        VCR.use_cassette('valid image') do
+          user.should be_valid
+        end
+      end
+
+    end
+
+    context 'when the image is not a valid face' do
+
+      before :each do
+        avatar.path = INVALID_IMAGE_PATH
+      end
+
+      it 'should not be valid' do
+        VCR.use_cassette('invalid image') do
+          user.should_not be_valid
+        end
+      end
+
+      it 'should have an error on the image field' do
+        VCR.use_cassette('invalid image') do
+          user.valid?
+          user.errors[:avatar].should == [ "We couldn't see a face in your photo, try taking another one." ]
+        end
+      end
+
+    end
+
+  end
+
+  context 'when face validation is globally turned off' do
+
+    before :each do
+      stub(HasFace).enable_validation { false }
+      avatar.path = INVALID_IMAGE_PATH
+    end
+
+    it 'should be valid' do
+      user.should be_valid
+    end
+
+  end
+
+  context 'handling a failure response from the face.com API' do
+
+    let(:logger) { Logger.new(nil) }
+
+    before :each do
+      stub(HasFace).api_key { 'invalid api key' }
+      stub(Rails).logger    { logger }
+      avatar.path = INVALID_IMAGE_PATH
+    end
+
+    context 'when skipping validation on errors is enabled' do
+
+      before :each do
+        stub(HasFace).skip_validation_on_error { true }
+        avatar.path = INVALID_IMAGE_PATH
+      end
+
+      it 'should skip validation' do
+        VCR.use_cassette('invalid api key') do
+          user.should be_valid
+        end
+      end
+
+      it 'should log a warning' do
+        VCR.use_cassette('invalid api key') do
+          mock(logger).warn 'face.com API Error: "API_KEY_DOES_NOT_EXIST - invalid api key" Code: 201'
+          user.valid?
+        end
+      end
+
+    end
+
+    context 'when skipping validation on errors is disabled' do
+
+      it 'should raise an api error' do
+        VCR.use_cassette('invalid api key') do
+          expect { user.valid? }.to raise_error HasFace::FaceAPIError, 'face.com API Error: "API_KEY_DOES_NOT_EXIST - invalid api key" Code: 201'
+        end
+      end
+
+    end
+
+  end
+
+  context 'handling http request errors' do
+
+    let(:logger) { Logger.new(nil) }
+
+    before :each do
+      stub(HasFace).detect_url { 'http://face.com/invalid/lookup/url' }
+      stub(Rails).logger       { logger }
+      avatar.path = INVALID_IMAGE_PATH
+    end
+
+    context 'when skipping validation on errors is enabled' do
+
+      before :each do
+        stub(HasFace).skip_validation_on_error { true }
+      end
+
+      it 'should skip validation' do
+        VCR.use_cassette('invalid detect url') do
+          user.should be_valid
+        end
+      end
+
+      it 'should log a warning' do
+        VCR.use_cassette('invalid detect url') do
+          mock(logger).warn 'has_face HTTP Request Error: "404 Resource Not Found"'
+          user.valid?
+        end
+      end
+
+    end
+
+    context 'when skipping validation on errors is disabled' do
+
+      it 'should raise an api error' do
+        VCR.use_cassette('invalid detect url') do
+          expect { user.valid? }.to raise_error HasFace::HTTPRequestError, 'has_face HTTP Request Error: "404 Resource Not Found"'
+        end
+      end
+
+    end
+
+  end
+
+  context 'allowing blank' do
+
+    context 'when allow blank is true' do
+
+      let(:user) { UserWithAllowBlank.new }
+
+      before :each do
+        stub(user).avatar { "" }
+      end
+
+      it 'should be valid with a blank avatar' do
+        user.should be_valid
+      end
+
+    end
+
+    context 'when allow blank is not true' do
+
+      let(:user) { UserWithoutAllowBlank.new }
+
+      before :each do
+        stub(user).avatar { "" }
+      end
+
+      it 'should not be valid' do
+        user.should_not be_valid
+      end
+
+    end
+
+  end
+
+  context 'allowing nil' do
+
+    context 'when allow nil is true' do
+
+      let(:user) { UserWithAllowNil.new }
+
+      before :each do
+        stub(user).avatar { nil }
+      end
+
+      it 'should be valid with a nil avatar' do
+        user.should be_valid
+      end
+
+    end
+
+    context 'when allow nil is not true' do
+
+      let(:user) { UserWithoutAllowNil.new }
+
+      before :each do
+        stub(user).avatar { nil }
+      end
+
+      it 'should not be valid' do
+        user.should_not be_valid
+      end
+
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,32 @@
+require 'rspec'
+require 'vcr'
+
+require 'rails'
+require 'active_model'
+require 'active_model/validations'
+require 'active_record'
+require 'lib/has_face'
+
+Dir["spec/support/**/*.rb"].each {|f| require f}
+
+VALID_IMAGE_PATH   = 'spec/support/assets/hit.jpg'
+INVALID_IMAGE_PATH = 'spec/support/assets/miss.jpg'
+
+VCR.config do |c|
+  c.cassette_library_dir = 'spec/support/vcr_cassettes'
+  c.stub_with :fakeweb
+  c.default_cassette_options = { :record => :once }
+end
+
+RSpec.configure do |config|
+
+  config.mock_with :rr
+  config.include HasFace::Test::Matchers
+
+  config.before :all do
+    # Put your api details here for tesing. This is only required if VCR is not being used
+    # HasFace.api_key    = 'api_key'    if HasFace.api_key.blank?
+    # HasFace.api_secret = 'api_secret' if HasFace.api_secret.blank?
+  end
+
+end

data/spec/support/models/avatar.rb

@@ -0,0 +1,5 @@
+class Avatar < ActiveRecord::Base
+
+  belongs_to :user
+
+end

data/spec/support/models/base_user.rb

@@ -0,0 +1,7 @@
+class BaseUser < ActiveRecord::Base
+
+  has_one :avatar
+
+end
+
+class UserWithoutFaceValidation < BaseUser; end

data/spec/support/models/user.rb

@@ -0,0 +1,9 @@
+class User < BaseUser
+
+  validates :avatar, :has_face => true
+
+end
+
+class UserWithFaceValidation < User; end
+class UserWithoutAllowBlank < User; end
+class UserWithoutAllowNil < User; end

data/spec/support/models/user_with_allow_blank.rb

@@ -0,0 +1,3 @@
+class UserWithAllowBlank < BaseUser
+  validates :avatar, :has_face => true, :allow_blank => true
+end

data/spec/support/models/user_with_allow_nil.rb

@@ -0,0 +1,3 @@
+class UserWithAllowNil < BaseUser
+  validates :avatar, :has_face => true, :allow_nil => true
+end

data/spec/support/schema_setup.rb

@@ -0,0 +1,17 @@
+ActiveRecord::Base.establish_connection({:adapter => 'sqlite3', :database => ':memory:'})
+ActiveRecord::Migration.verbose = false
+
+ActiveRecord::Schema.define(:version => 1) do
+
+  create_table :avatars, :force => true do |t|
+    t.string   :url
+    t.string   :path
+    t.integer  :user_id
+  end
+
+  create_table :base_users, :force => true do |t|
+    t.string   :full_name
+  end
+
+end
+

data/spec/support/vcr_cassettes/invalid_api_key.yml

@@ -0,0 +1,38 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :post
+    uri: http://api.face.com:80/faces/detect.json
+    body: 
+    headers: 
+      accept: 
+      - "*/*; q=0.5, application/xml"
+      content-type: 
+      - multipart/form-data; boundary=666980
+      accept-encoding: 
+      - gzip, deflate
+      content-length: 
+      - "69159"
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - "application/json; Charset: utf-8"
+      server: 
+      - Apache/2.2.16 (Debian) mod_ssl/2.2.16 OpenSSL/0.9.8o
+      date: 
+      - Sun, 10 Jul 2011 14:43:22 GMT
+      content-length: 
+      - "115"
+      content-encoding: 
+      - gzip
+      vary: 
+      - Accept-Encoding
+    body: !binary |
+      H4sIAAAAAAAAA6pWKi5JLCktVrJSSkvMzCktSlXSUUotKsovik/OT0lVsjIy
+      MIQJ5KYWFyemA8WUHAM8471dI+Nd/F2D4/38Q+JdIzyDQxR0FTLzyhJzMlMU
+      EgsyFbJTK5VqAQAAAP//AwApem9UYAAAAA==
+
+    http_version: "1.1"

data/spec/support/vcr_cassettes/invalid_detect_url.yml

@@ -0,0 +1,41 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :post
+    uri: http://face.com:80/invalid/lookup/url
+    body: 
+    headers: 
+      accept: 
+      - "*/*; q=0.5, application/xml"
+      content-type: 
+      - multipart/form-data; boundary=104496
+      accept-encoding: 
+      - gzip, deflate
+      content-length: 
+      - "69176"
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 404
+      message: Not Found
+    headers: 
+      content-type: 
+      - text/html; charset=iso-8859-1
+      server: 
+      - Apache/2.2.16 (Debian) mod_ssl/2.2.16 OpenSSL/0.9.8o
+      date: 
+      - Sun, 10 Jul 2011 14:43:50 GMT
+      content-length: 
+      - "261"
+      content-encoding: 
+      - gzip
+      vary: 
+      - Accept-Encoding
+    body: !binary |
+      H4sIAAAAAAAAA01QwWrDMAy95yu0nrbDrDSU0YExbE3KClkblvSw03BjjYQ5
+      cWY7Hfv7OSmFXQTvSe9JT/wmPWyq9yKDl+o1h+L4nO82sLhH3GXVFjGt0ksn
+      YTFitl+IiDe+04I3JFUAvvWaxCpewd542JqxVxwvZMRxHuIno34n3VL8mwko
+      4oOoGgJL3yM5TwqObzlg25+lbhVqY77GAUer4Uc66IP2c9KC6cE3rQNH9kyW
+      cRwmdxuKVMqSc+JpkHVDmLCELR/gNqVTK/s76Iz6cE5f+cNAfVnmGLNHtjZQ
+      znYgwxpZE6tNB4WxHtYxx6txyDSnCfdPX4j+AIuMg79AAQAA
+
+    http_version: "1.1"

data/spec/support/vcr_cassettes/invalid_image.yml

@@ -0,0 +1,42 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :post
+    uri: http://api.face.com:80/faces/detect.json
+    body: 
+    headers: 
+      accept: 
+      - "*/*; q=0.5, application/xml"
+      content-type: 
+      - multipart/form-data; boundary=976464
+      accept-encoding: 
+      - gzip, deflate
+      content-length: 
+      - "69176"
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - "application/json; Charset: utf-8"
+      server: 
+      - Apache/2.2.16 (Debian) mod_ssl/2.2.16 OpenSSL/0.9.8o
+      date: 
+      - Sun, 10 Jul 2011 14:40:56 GMT
+      content-length: 
+      - "298"
+      content-encoding: 
+      - gzip
+      vary: 
+      - Accept-Encoding
+    body: !binary |
+      H4sIAAAAAAAAA0yPMW/DIBCF/4p1a93A4YANU6cOXTuWKML4sIns2ApYrRTl
+      v5cMlbrdO733vbs7bNOa1wTm6w77bQYDU86bscyy4Dwd/LpY5rb4um/z6oZk
+      WWeZsMxbporlbzgWk2Xasl5ybEPrnRCkO98o2ZLjh8tGI9SwxaE0vL+pTkgc
+      nHKofB8a0QsZjtj2FDoiFZqzQKU8celJD10I3MtGe8fdQEEWqi6s7zjkCcxR
+      8homiuOUwSheRHbj85/T41RDyi7vRUHavaeUSm5PbiQw5d1E5Rqs4UaLi9d4
+      HQtNa13DHJdYaJI/cTdKlM85LnTO9FPW8Llf6wp59bHPleCIFUrTcINt9VIS
+      HP5nSkGDvEHssH08fgEAAP//AwD3K/WfbwEAAA==
+
+    http_version: "1.1"

data/spec/support/vcr_cassettes/valid_image.yml

@@ -0,0 +1,49 @@
+--- 
+- !ruby/struct:VCR::HTTPInteraction 
+  request: !ruby/struct:VCR::Request 
+    method: :post
+    uri: http://api.face.com:80/faces/detect.json
+    body: 
+    headers: 
+      accept: 
+      - "*/*; q=0.5, application/xml"
+      content-type: 
+      - multipart/form-data; boundary=591191
+      accept-encoding: 
+      - gzip, deflate
+      content-length: 
+      - "78189"
+  response: !ruby/struct:VCR::Response 
+    status: !ruby/struct:VCR::ResponseStatus 
+      code: 200
+      message: OK
+    headers: 
+      content-type: 
+      - "application/json; Charset: utf-8"
+      server: 
+      - Apache/2.2.16 (Debian) mod_ssl/2.2.16 OpenSSL/0.9.8o
+      date: 
+      - Sun, 10 Jul 2011 14:40:50 GMT
+      content-length: 
+      - "608"
+      content-encoding: 
+      - gzip
+      vary: 
+      - Accept-Encoding
+    body: !binary |
+      H4sIAAAAAAAAA6xTPY/cIBD9Kyva7GEwBn9UaZIiUqRISRefLBZjmwjbKwO5
+      u5z2v2ew13vaa9KkMsy8eW/eMH5F52H2s0PVz1cUFosqNHh/ruqkTjqpNFbz
+      WCfybB7C2c6ydXVS1EleJ7ROGCTqJFsjYj9nJG1FrrJSdCpvVSuEYqLEv866
+      R0d0Ni0ofP5Y8EyddNnmqcxPMqPtSVJxSqmCIi151qQUCjXhCkBF1xHFWakk
+      ka3ueKFYCVxPpvUDqkRGjmjQph88qrICLl72mx+/qv349PVb8x8kG15gnjZZ
+      holoSEOghUWruZ/MH3myGlV+CRrUh0W7YbYgPQVrjyiYNrbzeES9uQWtPOk4
+      bCBR89SZZdSQ66R1QDHKKUh7u4KfXi/NW/HVeSowKd+8swzncFV68npB1St6
+      RtXa8hG9wGRi25cj0i+6sbrzOwCKihXABKb8Clg2xhUhOOZiQ3CcpYAY5+CH
+      OxKB2UbCU5zfEHediBSzdMdwfgPdSYldilNcMsBMs9N7kmHBNisMF7FRuVyb
+      2KYS71e2LaAGM+3nF/kEBnIMDMtsYbYPKS7KuJBewSiL1YD0fjGn4LWLmnH9
+      4/e3tAEOKD7v/lytnmKyiH30emo3mztylPY9Mo+Oeyud28h36PrE77CcANaN
+      xpqp/xc2o5fL5fECy+W89AG4kQtKaecAGJzsVwvBxe2icWFHaaaVNytL8G/N
+      aHyUJCRmnfaNN6NuvH6GMPoepuOBksOXYA8pofRAecVIRfPDB6jYfoG9BgQY
+      JYzSguaXy18AAAD//wMArlodeVkEAAA=
+
+    http_version: "1.1"

metadata

@@ -0,0 +1,198 @@
+--- !ruby/object:Gem::Specification 
+name: has_face
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mario Visic
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-11 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rr
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: vcr
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 1
+        - 0
+        version: "1.0"
+  type: :development
+  version_requirements: *id006
+description: An Active Model validator that uses the face.com API to ensures an image contains a face
+email: 
+- mario@mariovisic.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rvmrc
+- Gemfile
+- README.md
+- Rakefile
+- has_face.gemspec
+- lib/generators/has_face/install_generator.rb
+- lib/generators/has_face/templates/has_face.rb
+- lib/has_face.rb
+- lib/has_face/configuration.rb
+- lib/has_face/locales/en.yml
+- lib/has_face/test/matchers.rb
+- lib/has_face/validator.rb
+- lib/has_face/version.rb
+- spec/has_face/test/matchers_spec.rb
+- spec/has_face/validator_spec.rb
+- spec/spec_helper.rb
+- spec/support/assets/hit.jpg
+- spec/support/assets/miss.jpg
+- spec/support/models/avatar.rb
+- spec/support/models/base_user.rb
+- spec/support/models/user.rb
+- spec/support/models/user_with_allow_blank.rb
+- spec/support/models/user_with_allow_nil.rb
+- spec/support/schema_setup.rb
+- spec/support/vcr_cassettes/invalid_api_key.yml
+- spec/support/vcr_cassettes/invalid_detect_url.yml
+- spec/support/vcr_cassettes/invalid_image.yml
+- spec/support/vcr_cassettes/valid_image.yml
+has_rdoc: true
+homepage: https://github.com/mariovisic/has_face
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: has_face
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Easily validate if an image contains faces
+test_files: 
+- spec/has_face/test/matchers_spec.rb
+- spec/has_face/validator_spec.rb
+- spec/spec_helper.rb
+- spec/support/assets/hit.jpg
+- spec/support/assets/miss.jpg
+- spec/support/models/avatar.rb
+- spec/support/models/base_user.rb
+- spec/support/models/user.rb
+- spec/support/models/user_with_allow_blank.rb
+- spec/support/models/user_with_allow_nil.rb
+- spec/support/schema_setup.rb
+- spec/support/vcr_cassettes/invalid_api_key.yml
+- spec/support/vcr_cassettes/invalid_detect_url.yml
+- spec/support/vcr_cassettes/invalid_image.yml
+- spec/support/vcr_cassettes/valid_image.yml