aspecta 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+.rvmrc
+Gemfile.lock
+pkg/*
+uploads

data/Gemfile

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

data/README.md

@@ -0,0 +1,72 @@
+# aspecta
+
+``aspect`` is small add-on for the awesome
+[carrierwave](http://github.com/jnicklas/carrierwave) gem. ``aspecta``
+adds image dimensions validator to your ActiveRecords models.
+
+## Usage
+
+In your Gemfile:
+
+    gem "aspecta"
+
+Run:
+
+    bundle install
+
+Add validator to your model:
+
+    class User < ActiveRecord::Base
+      mount_uploader :avatar, AvatarUploader
+
+      validates :avatar, :dimensions => {
+        :height => { :minimum => 100, :maximum => 200 }
+        :width => { :minimum => 100, :maximum => 200 }
+      }
+    end
+
+Profit!
+
+## I18n
+
+Add following translations to your i18n setup:
+
+    en:
+      errors:
+        messages:
+          image_is_too_narrow: "image is too narrow, minimum is %{size} pixels"
+          image_is_too_wide: "image is too wide, maximum is %{size} pixels"
+          image_is_too_short: "image is too short, minimum is %{size} pixels"
+          image_is_too_tall: "image is too tall, maximum is %{size} pixels"
+
+## Contributing
+
+Contributing is easy:
+
+* fork & commit,
+* submit issues.
+
+Thank you!
+
+## License
+
+Copyright (c) 2011 Filip Tepper
+
+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/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList["test/*_test.rb"]
+  t.verbose = true
+end
+
+task :default => [:test]

data/aspecta.gemspec

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+$:.push File.expand_path("../lib", __FILE__)
+require "aspecta/version"
+
+Gem::Specification.new do |s|
+  s.name        = "aspecta"
+  s.version     = Aspecta::VERSION
+  s.authors     = ["Filip Tepper"]
+  s.email       = ["filip@tepper.pl"]
+  s.homepage    = "http://github.com/filiptepper/aspecta"
+  s.summary     = %q{image dimensions ActiveRecord validator for carrierwave gem}
+  s.description = %q{image dimensions ActiveRecord validator for carrierwave gem}
+
+  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"]
+
+  s.add_development_dependency "activemodel"
+  s.add_development_dependency "carrierwave"
+  s.add_dependency "fastimage"
+end

data/lib/aspecta.rb

@@ -0,0 +1,49 @@
+require "aspecta/version"
+require "fastimage"
+
+class DimensionsValidator < ActiveModel::EachValidator
+  DIMENSIONS = [:width, :height]
+  ATTRIBUTES = { :minimum => :>=, :maximum => :<= }
+  MESSAGES = {
+    :width => {
+      :minimum => :image_is_too_narrow,
+      :maximum => :image_is_too_wide
+    },
+    :height => {
+      :minimum => :image_is_too_short,
+      :maximum => :image_is_too_tall
+    }
+  }
+
+  def validate_each(record, attribute, value)
+    return if value.file.nil?
+
+    if options.empty?
+      raise ArgumentError, "Specify the :width and / or :height option"
+    end
+
+    DIMENSIONS.each do |dimension|
+      unless options[dimension].nil?
+        if (ATTRIBUTES.keys & options[dimension].keys).empty?
+          raise ArgumentError,
+            "Specify the :minimum and / or :maximum option for :#{dimension}"
+        end
+      end
+    end
+
+    dimensions = FastImage.size value.path
+
+    DIMENSIONS.each_with_index do |dimension, index|
+      next if options[dimension].nil?
+
+      options[dimension].each do |measure, size|
+        unless dimensions[index].send(ATTRIBUTES[measure], size)
+             record.errors.add(attribute,
+              MESSAGES[dimension][measure],
+              :size => size
+            )
+        end
+      end
+    end
+  end
+end

data/lib/aspecta/version.rb

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

data/test/aspect_test.rb

@@ -0,0 +1,140 @@
+# encoding: utf-8
+
+require "test_helper"
+
+class AspectaTest < Test::Unit::TestCase
+
+  # ===========
+  # = helpers =
+  # ===========
+
+  def fixture(file)
+    File.open(File.dirname(__FILE__) + "/fixtures/#{file}.png")
+  end
+
+  # ===========
+  # = general =
+  # ===========
+
+  def test_skips_empty_uploader
+    user = UserWithInvalidValidation.new
+
+    assert user.valid?
+  end
+
+  def test_requires_width_or_height_option
+    user = UserWithInvalidValidation.new
+    user.avatar = fixture "200x200"
+
+    exception = assert_raise ArgumentError do
+      user.valid?
+    end
+
+    assert_equal "Specify the :width and / or :height option",
+      exception.message
+  end
+
+  def test_requires_minimum_or_maximum_for_height_option
+    user = UserWithInvalidValitionHeightOptions.new
+    user.avatar = fixture "200x200"
+
+    exception = assert_raise ArgumentError do
+      user.valid?
+    end
+
+    assert_equal "Specify the :minimum and / or :maximum option for :height",
+      exception.message
+  end
+
+  def test_requires_minimum_or_maximum_for_width_option
+    user = UserWithInvalidValitionWidthOptions.new
+    user.avatar = fixture "200x200"
+
+    exception = assert_raise ArgumentError do
+      user.valid?
+    end
+
+    assert_equal "Specify the :minimum and / or :maximum option for :width",
+      exception.message
+  end
+
+  # =================
+  # = minimum width =
+  # =================
+
+  def test_valid_minimum_width
+    user = UserMinimumWidth200.new
+
+    user.avatar = fixture "200x200"
+    assert user.valid?
+  end
+
+  def test_invalid_minimum_width
+    user = UserMinimumWidth200.new
+
+    user.avatar = fixture "199x199"
+    assert ! user.valid?
+    assert user.errors[:avatar].
+      include?("image is too narrow, minimum is 200 pixels")
+  end
+
+  # ==================
+  # = minimum height =
+  # ==================
+
+  def test_valid_minimum_height
+    user = UserMinimumHeight200.new
+
+    user.avatar = fixture "200x200"
+    assert user.valid?
+  end
+
+  def test_invalid_minimum_height
+    user = UserMinimumHeight200.new
+
+    user.avatar = fixture "199x199"
+    assert ! user.valid?
+    assert user.errors[:avatar].
+      include?("image is too short, minimum is 200 pixels")
+  end
+
+  # =================
+  # = maximum width =
+  # =================
+
+  def test_valid_maximum_width
+    user = UserMaximumWidth200.new
+
+    user.avatar = fixture "200x200"
+    assert user.valid?
+  end
+
+  def test_invalid_maximum_width
+    user = UserMaximumWidth200.new
+
+    user.avatar = fixture "201x201"
+    assert ! user.valid?
+    assert user.errors[:avatar].
+      include?("image is too wide, maximum is 200 pixels")
+  end
+
+  # ==================
+  # = maximum height =
+  # ==================
+
+  def test_valid_maximum_height
+    user = UserMaximumHeight200.new
+
+    user.avatar = fixture "200x200"
+    assert user.valid?
+  end
+
+  def test_invalid_maximum_height
+    user = UserMaximumHeight200.new
+
+    user.avatar = fixture "201x201"
+    assert ! user.valid?
+    assert user.errors[:avatar].
+      include?("image is too tall, maximum is 200 pixels")
+  end
+end

data/test/lib/avatar_uploader.rb

@@ -0,0 +1,4 @@
+class AvatarUploader < CarrierWave::Uploader::Base
+  storage :file
+  root ""
+end

data/test/lib/user.rb

@@ -0,0 +1,50 @@
+require "lib/avatar_uploader"
+
+class User
+  include ActiveModel::Validations
+  extend CarrierWave::Mount
+
+  mount_uploader :avatar, AvatarUploader
+end
+
+class UserWithInvalidValidation < User
+  validates :avatar, :dimensions => true
+end
+
+class UserWithInvalidValitionHeightOptions < User
+  validates :avatar, :dimensions => {
+    :height => {},
+    :width => { :minimum => 200, :maximum => 200 }
+  }
+end
+
+class UserWithInvalidValitionWidthOptions < User
+  validates :avatar, :dimensions => {
+    :width => {},
+    :height => { :minimum => 200, :maximum => 200 }
+  }
+end
+
+class UserMinimumWidth200 < User
+  validates :avatar, :dimensions => {
+    :width => { :minimum => 200 }
+  }
+end
+
+class UserMinimumHeight200 < User
+  validates :avatar, :dimensions => {
+    :height => { :minimum => 200 }
+  }
+end
+
+class UserMaximumWidth200 < User
+  validates :avatar, :dimensions => {
+    :width => { :maximum => 200 }
+  }
+end
+
+class UserMaximumHeight200 < User
+  validates :avatar, :dimensions => {
+    :height => { :maximum => 200 }
+  }
+end

data/test/locale/en.yml

@@ -0,0 +1,7 @@
+en:
+  errors:
+    messages:
+      image_is_too_narrow: "image is too narrow, minimum is %{size} pixels"
+      image_is_too_wide: "image is too wide, maximum is %{size} pixels"
+      image_is_too_short: "image is too short, minimum is %{size} pixels"
+      image_is_too_tall: "image is too tall, maximum is %{size} pixels"

data/test/test_helper.rb

@@ -0,0 +1,14 @@
+$:.push File.dirname(__FILE__)
+
+require "test/unit"
+
+require "active_model"
+require "carrierwave"
+require "carrierwave/orm/activerecord"
+require "i18n"
+
+require "aspecta"
+
+require "lib/user"
+
+I18n.load_path << File.dirname(__FILE__) + "/locale/en.yml"

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: aspecta
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Filip Tepper
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-08-23 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: &2243656820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2243656820
+- !ruby/object:Gem::Dependency
+  name: carrierwave
+  requirement: &2243656400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2243656400
+- !ruby/object:Gem::Dependency
+  name: fastimage
+  requirement: &2243655980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2243655980
+description: image dimensions ActiveRecord validator for carrierwave gem
+email:
+- filip@tepper.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- aspecta.gemspec
+- lib/aspecta.rb
+- lib/aspecta/version.rb
+- test/aspect_test.rb
+- test/fixtures/199x199.png
+- test/fixtures/200x200.png
+- test/fixtures/201x201.png
+- test/lib/avatar_uploader.rb
+- test/lib/user.rb
+- test/locale/en.yml
+- test/test_helper.rb
+homepage: http://github.com/filiptepper/aspecta
+licenses: []
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: image dimensions ActiveRecord validator for carrierwave gem
+test_files:
+- test/aspect_test.rb
+- test/fixtures/199x199.png
+- test/fixtures/200x200.png
+- test/fixtures/201x201.png
+- test/lib/avatar_uploader.rb
+- test/lib/user.rb
+- test/locale/en.yml
+- test/test_helper.rb