imgur_url 0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.autotest
+.rspec

data/.rvmrc

@@ -0,0 +1,3 @@
+rvm_install_on_use_flag=1
+rvm_gemset_create_on_use_flag=1
+rvm 1.9.3@imgur_url

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - jruby-19mode
+  - jruby-20mode

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,33 @@
+Ruby gem for dealing with [imgur](http://imgur.com) image URLs.
+
+[![Build Status](https://secure.travis-ci.org/6/imgur_url.png?branch=master)](http://travis-ci.org/6/imgur_url)
+
+
+#### Example usage
+```ruby
+i = ImgurUrl::Image.new("http://imgur.com/dhuY8")
+i.id
+# => "dhuY8"
+i.url
+# => "http://i.imgur.com/dhuY8.jpg"
+i.url(:small)
+# => "http://i.imgur.com/dhuY8s.jpg"
+i.download_url
+# => "http://imgur.com/download/dhuY8"
+i.permalink_url
+# => "http://imgur.com/dhuY8"
+```
+
+#### Recognized input URL formats
+- `http://imgur.com/{image_id}`
+- `http://i.imgur.com/{image_id}.jpg`
+- `http://imgur.com/download/{image_id}`
+- `http://imgur.com/gallery/{image_id}`
+
+#### Supported `url` sizes
+- `:original` (default)
+- `:huge`
+- `:large`
+- `:medium`
+- `:thumb`
+- `:small`

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/imgur_url.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'imgur_url/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "imgur_url"
+  gem.authors       = ["Peter Graham"]
+  gem.version       = ImgurUrl::VERSION
+  gem.summary       = %q{Parse imgur URLs}
+  gem.description   = %q{Parse imgur.com image URLs.}
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.homepage = 'http://github.com/6/imgur_url'
+
+  gem.add_dependency "andand"
+  gem.add_dependency "activesupport"
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "rspec"
+  gem.add_development_dependency 'rspec-nc'
+end

data/lib/imgur_url/exception.rb

@@ -0,0 +1,10 @@
+module ImgurUrl
+  class Exception < StandardError
+  end
+
+  class InvalidUrl < ImgurUrl::Exception
+  end
+
+  class InvalidSize < ImgurUrl::Exception
+  end
+end

data/lib/imgur_url/image.rb

@@ -0,0 +1,39 @@
+module ImgurUrl
+  class Image
+    SIZES = {
+      :small => 's',
+      :thumb => 't',
+      :medium => 'm',
+      :large => 'l',
+      :huge => 'h',
+      :original => '',
+    }
+
+    ALBUM_PATH = "a"
+
+    def initialize(url)
+      @original_url = url
+      unless id.present? && id != ALBUM_PATH
+        raise InvalidUrl
+      end
+    end
+
+    def id
+      @id ||= @original_url.match(%r{imgur\.com/(?:(?:gallery|download)/)?([^.#?/]+)}).andand[1]
+    end
+
+    def url(size = :original)
+      raise InvalidSize  unless SIZES[size]
+      @direct_urls ||= {}
+      @direct_urls[size] ||= "http://i.imgur.com/#{id}#{SIZES[size]}.jpg"
+    end
+
+    def permalink_url
+      @permalink_url ||= "http://imgur.com/#{id}"
+    end
+
+    def download_url
+      @download_url ||= "http://imgur.com/download/#{id}"
+    end
+  end
+end

data/lib/imgur_url/version.rb

@@ -0,0 +1,3 @@
+module ImgurUrl
+  VERSION = "0.1"
+end

data/lib/imgur_url.rb

@@ -0,0 +1,5 @@
+require 'andand'
+require 'active_support/core_ext/string'
+files = []
+files.concat(Dir[File.join(File.dirname(__FILE__), 'imgur_url','**', '*.rb')])
+files.each { |f| require f }

data/spec/lib/image_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+module ImgurUrl
+  describe Image do
+    shared_examples "with a valid imgur image URL" do
+      subject { described_class.new(url) }
+
+      its(:id) { should == "dhuY8" }
+      its(:permalink_url) { should == "http://imgur.com/dhuY8" }
+      its(:download_url) { should == "http://imgur.com/download/dhuY8" }
+      its(:url) { should == "http://i.imgur.com/dhuY8.jpg" }
+
+      describe "#url" do
+        it "returns the direct URL for the given size" do
+          subject.url(:original).should == "http://i.imgur.com/dhuY8.jpg"
+          subject.url(:huge).should == "http://i.imgur.com/dhuY8h.jpg"
+          subject.url(:large).should == "http://i.imgur.com/dhuY8l.jpg"
+          subject.url(:medium).should == "http://i.imgur.com/dhuY8m.jpg"
+          subject.url(:thumb).should == "http://i.imgur.com/dhuY8t.jpg"
+          subject.url(:small).should == "http://i.imgur.com/dhuY8s.jpg"
+        end
+
+        context "with an invalid size parameter" do
+          it "raises an InvalidSize exception" do
+            expect { subject.url(:invalid) }.to raise_error(ImgurUrl::InvalidSize)
+          end
+        end
+      end
+    end
+
+    context "a default permalink URL" do
+      let(:url) { "http://imgur.com/dhuY8" }
+      it_behaves_like "with a valid imgur image URL"
+    end
+
+    context "a default permalink URL with query params" do
+      let(:url) { "http://imgur.com/dhuY8?tags" }
+      it_behaves_like "with a valid imgur image URL"
+    end
+
+    context "a direct URL" do
+      let(:url) { "http://i.imgur.com/dhuY8.jpg" }
+      it_behaves_like "with a valid imgur image URL"
+    end
+
+    context "a gallery URL" do
+      let(:url) { "http://imgur.com/gallery/dhuY8" }
+      it_behaves_like "with a valid imgur image URL"
+    end
+
+    context "a download URL" do
+      let(:url) { "http://imgur.com/download/dhuY8" }
+      it_behaves_like "with a valid imgur image URL"
+    end
+
+    shared_examples "with an invalid URL" do
+      it "raises an InvalidUrl error on initialization" do
+        expect { described_class.new(url) }.to raise_error(ImgurUrl::InvalidUrl)
+      end
+    end
+
+    context "with an imgur album URL" do
+      let(:url) { "http://imgur.com/a/CrSqu" }
+      it_behaves_like "with an invalid URL"
+    end
+
+    context "with a non-imgur URL" do
+      let(:url) { "http://google.com" }
+      it_behaves_like "with an invalid URL"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+ENV['RACK_ENV'] = 'test'
+Dir["./spec/support/**/*.rb"].sort.each {|f| require f}
+require './lib/imgur_url'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: imgur_url
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Peter Graham
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: andand
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-nc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Parse imgur.com image URLs.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rvmrc
+- .travis.yml
+- Gemfile
+- README.md
+- Rakefile
+- imgur_url.gemspec
+- lib/imgur_url.rb
+- lib/imgur_url/exception.rb
+- lib/imgur_url/image.rb
+- lib/imgur_url/version.rb
+- spec/lib/image_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/6/imgur_url
+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.25
+signing_key: 
+specification_version: 3
+summary: Parse imgur URLs
+test_files:
+- spec/lib/image_spec.rb
+- spec/spec_helper.rb