pummel 0.3.0

data/vendor/ruby-oembed/lib/oembed/formatters.rb

@@ -0,0 +1,29 @@
+module OEmbed
+  class Formatters
+    FORMATS = Hash.new { |_, format| raise OEmbed::FormatNotSupported, format }
+
+    # Load XML
+    begin
+      require 'xmlsimple'
+      FORMATS[:xml] = proc { |r| XmlSimple.xml_in(r, 'ForceArray' => false)}
+    rescue LoadError
+    end
+
+    # Load JSON
+    begin
+      require 'json'
+      FORMATS[:json] = proc { |r| ::JSON.load(r) }
+    rescue LoadError
+    end
+
+    DEFAULT = FORMATS.keys.first
+
+    def self.verify?(type)
+      FORMATS[type] && type
+    end
+
+    def self.convert(type, value)
+      FORMATS[type].call(value)
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/provider.rb

@@ -0,0 +1,80 @@
+module OEmbed
+  class Provider
+    attr_accessor :format, :name, :url, :urls, :endpoint
+
+    def initialize(endpoint, format = OEmbed::Formatters::DEFAULT)
+      @endpoint = endpoint
+      @urls = []
+      # Try to use the best available format
+      @format = OEmbed::Formatters.verify?(format)
+    end
+
+    def <<(url)
+      if url.is_a? Regexp
+        @urls << url
+        OEmbed::Providers.urls[url] = self
+        return
+      end
+      full, scheme, domain, path = *url.match(%r{([^:]*)://?([^/?]*)(.*)})
+      domain = Regexp.escape(domain).gsub("\\*", "(.*?)").gsub("(.*?)\\.", "([^\\.]+\\.)?")
+      path = Regexp.escape(path).gsub("\\*", "(.*?)")
+      url_regex = Regexp.new("^#{Regexp.escape(scheme)}://#{domain}#{path}")
+      @urls << url_regex
+      OEmbed::Providers.urls[url_regex] = self
+    end
+
+    def build(url, options = {})
+      raise OEmbed::NotFound, url unless include?(url)
+      query = options.merge({:url => url})
+      endpoint = @endpoint.clone
+
+      if format_in_url?
+        format = endpoint["{format}"] = (query[:format] || @format).to_s
+        query.delete(:format)
+      else
+        format = query[:format] ||= @format
+      end
+
+      query_string = "?" + query.inject("") do |memo, (key, value)|
+        "#{key}=#{value}&#{memo}"
+      end.chop
+
+      URI.parse(endpoint + query_string).instance_eval do
+        @format = format; def format; @format; end
+        self
+      end
+    end
+
+    def raw(url, options = {})
+      uri = build(url, options)
+
+      res = Net::HTTP.start(uri.host, uri.port) do |http|
+        http.get(uri.request_uri)
+      end
+
+      case res
+      when Net::HTTPNotImplemented
+        raise OEmbed::UnknownFormat, uri.format
+      when Net::HTTPNotFound
+        raise OEmbed::NotFound, url
+      when Net::HTTPOK
+        res.body
+      else
+        raise OEmbed::UnknownResponse, res.code
+      end
+    end
+
+    def get(url, options = {})
+      options[:format] ||= @format if @format
+      OEmbed::Response.create_for(raw(url, options), self, url, options[:format])
+    end
+
+    def format_in_url?
+      @endpoint.include?("{format}")
+    end
+
+    def include?(url)
+      @urls.empty? || !!@urls.detect{ |u| u =~ url }
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/provider_discovery.rb

@@ -0,0 +1,55 @@
+module OEmbed
+  class ProviderDiscovery
+    class << self
+    def raw(url, options = {})
+      provider = discover_provider(url, options)
+      provider.raw(url, options)
+    end
+
+    def get(url, options = {})
+      provider = discover_provider(url, options)
+      provider.get(url, options)
+    end
+
+    def discover_provider(url, options = {})
+      uri = URI.parse(url)
+
+      res = Net::HTTP.start(uri.host, uri.port) do |http|
+        http.get(uri.request_uri)
+      end
+
+      case res
+      when Net::HTTPNotFound
+        raise OEmbed::NotFound, url
+      when Net::HTTPOK
+        format = options[:format]
+
+        if format.nil? || format == :json
+          provider_endpoint ||= /<link.*href=['"]*([^\s'"]+)['"]*.*application\/json\+oembed.*>/.match(res.body)
+          provider_endpoint ||= /<link.*application\/json\+oembed.*href=['"]*([^\s'"]+)['"]*.*>/.match(res.body)
+          format ||= :json if provider_endpoint
+        end
+        if format.nil? || format == :xml
+          provider_endpoint ||= /<link.*href=['"]*([^\s'"]+)['"]*.*application\/xml\+oembed.*>/.match(res.body)
+          provider_endpoint ||= /<link.*application\/xml\+oembed.*href=['"]*([^\s'"]+)['"]*.*>/.match(res.body)
+          format ||= :xml if provider_endpoint
+        end
+
+        begin
+          provider_endpoint = URI.parse(provider_endpoint && provider_endpoint[1])
+          provider_endpoint.query = nil
+          provider_endpoint = provider_endpoint.to_s
+        rescue URI::Error
+          raise OEmbed::NotFound, url
+        end
+
+
+        Provider.new(provider_endpoint, format || OEmbed::Formatters::DEFAULT)
+      else
+        raise OEmbed::UnknownResponse, res.code
+      end
+    end
+
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/providers.rb

@@ -0,0 +1,146 @@
+module OEmbed
+  class Providers
+    class << self
+      @@urls = {}
+      @@fallback = []
+
+      def urls
+        @@urls
+      end
+
+      def register(*providers)
+        providers.each do |provider|
+          provider.urls.each do |url|
+            @@urls[url] = provider
+          end
+        end
+      end
+
+      def unregister(*providers)
+        providers.each do |provider|
+          provider.urls.each do |url|
+            @@urls.delete(url)
+          end
+        end
+      end
+
+      def register_all
+        register(Flickr, Viddler, Qik, Pownce, Revision3, Hulu, Vimeo)
+      end
+
+      # Takes an array of OEmbed::Provider instances or OEmbed::ProviderDiscovery
+      # Use this method to register fallback providers.
+      # When the raw or get methods are called, if the URL doesn't match
+      # any of the registerd url patters the fallback providers
+      # will be called (in order) with the URL.
+      #
+      # A common example:
+      #  OEmbed::Providers.register_fallback(OEmbed::ProviderDiscovery, OEmbed::Providers::OohEmbed)
+      def register_fallback(*providers)
+        @@fallback += providers
+      end
+
+      # Returns an array of all registerd fallback providers
+      def fallback
+        @@fallback
+      end
+
+      def find(url)
+        @@urls[@@urls.keys.detect { |u| u =~ url }] || false
+      end
+
+      def raw(url, options = {})
+        provider = find(url)
+        if provider
+          provider.raw(url, options)
+        else
+          fallback.each do |p|
+            return p.raw(url, options) rescue OEmbed::Error
+          end
+          raise(OEmbed::NotFound)
+        end
+      end
+
+      def get(url, options = {})
+        provider = find(url)
+        if provider
+          provider.get(url, options)
+        else
+          fallback.each do |p|
+            return p.get(url, options) rescue OEmbed::Error
+          end
+          raise(OEmbed::NotFound)
+        end
+      end
+    end
+
+    # Custom providers:
+    Youtube = OEmbed::Provider.new("http://www.youtube.com/oembed/")
+    Youtube << "http://*.youtube.com/*"
+
+    Flickr = OEmbed::Provider.new("http://www.flickr.com/services/oembed/")
+    Flickr << "http://*.flickr.com/*"
+
+    Viddler = OEmbed::Provider.new("http://lab.viddler.com/services/oembed/")
+    Viddler << "http://*.viddler.com/*"
+
+    Qik = OEmbed::Provider.new("http://qik.com/api/oembed.{format}")
+    Qik << "http://qik.com/*"
+    Qik << "http://qik.com/video/*"
+
+    Revision3 = OEmbed::Provider.new("http://revision3.com/api/oembed/")
+    Revision3 << "http://*.revision3.com/*"
+
+    Hulu = OEmbed::Provider.new("http://www.hulu.com/api/oembed.{format}")
+    Hulu << "http://www.hulu.com/watch/*"
+
+    Vimeo = OEmbed::Provider.new("http://www.vimeo.com/api/oembed.{format}")
+    Vimeo << "http://*.vimeo.com/*"
+    Vimeo << "http://*.vimeo.com/groups/*/videos/*"
+
+    Pownce = OEmbed::Provider.new("http://api.pownce.com/2.1/oembed.{format}")
+    Pownce << "http://*.pownce.com/*"
+
+    # A general end point, which then calls other APIs and returns OEmbed info
+    OohEmbed = OEmbed::Provider.new("http://oohembed.com/oohembed/", :json)
+    OohEmbed << %r{http://yfrog.(com|ru|com.tr|it|fr|co.il|co.uk|com.pl|pl|eu|us)/(.*?)} # image & video hosting
+    OohEmbed << "http://*.xkcd.com/*" # A hilarious stick figure comic
+    OohEmbed << "http://*.wordpress.com/*/*/*/*" # Blogging Engine & community
+    OohEmbed << "http://*.wikipedia.org/wiki/*" # Online encyclopedia
+    OohEmbed << "http://*.twitpic.com/*" # Picture hosting for Twitter
+    OohEmbed << "http://twitter.com/*/statuses/*" # Mirco-blogging network
+    OohEmbed << "http://*.slideshare.net/*" # Share presentations online
+    OohEmbed << "http://*.phodroid.com/*/*/*" # Photo host
+    OohEmbed << "http://*.metacafe.com/watch/*" # Video host
+    OohEmbed << "http://video.google.com/videoplay?*" # Video hosting
+    OohEmbed << "http://*.funnyordie.com/videos/*" # Comedy video host
+    OohEmbed << "http://*.thedailyshow.com/video/*" # Syndicated show
+    OohEmbed << "http://*.collegehumor.com/video:*" # Comedic & original videos
+    OohEmbed << %r{http://(.*?).amazon.(com|co.uk|de|ca|jp)/(.*?)/(gp/product|o/ASIN|obidos/ASIN|dp)/(.*?)} # Online product shopping
+    OohEmbed << "http://*.5min.com/Video/*" # micro-video host
+
+    PollEverywhere = OEmbed::Provider.new("http://www.polleverywhere.com/services/oembed/")
+    PollEverywhere << "http://www.polleverywhere.com/polls/*"
+    PollEverywhere << "http://www.polleverywhere.com/multiple_choice_polls/*"
+    PollEverywhere << "http://www.polleverywhere.com/free_text_polls/*"
+
+    MyOpera = OEmbed::Provider.new("http://my.opera.com/service/oembed", :json)
+    MyOpera << "http://my.opera.com/*"
+
+    ClearspringWidgets = OEmbed::Provider.new("http://widgets.clearspring.com/widget/v1/oembed/")
+    ClearspringWidgets << "http://www.clearspring.com/widgets/*"
+
+    NFBCanada = OEmbed::Provider.new("http://www.nfb.ca/remote/services/oembed/")
+    NFBCanada << "http://*.nfb.ca/film/*"
+
+    Scribd = OEmbed::Provider.new("http://www.scribd.com/services/oembed")
+    Scribd << "http://*.scribd.com/*"
+
+    MovieClips = OEmbed::Provider.new("http://movieclips.com/services/oembed/")
+    MovieClips << "http://movieclips.com/watch/*/*/"
+
+    TwentyThree = OEmbed::Provider.new("http://www.23hq.com/23/oembed")
+    TwentyThree << "http://www.23hq.com/*"
+
+  end
+end

data/vendor/ruby-oembed/lib/oembed/response.rb

@@ -0,0 +1,59 @@
+module OEmbed
+  class Response
+    METHODS = [:define_methods!, :provider, :field, :fields]
+    attr_reader :fields, :provider, :format, :url
+
+    def self.create_for(raw, provider, url, format = :json)
+      fields = OEmbed::Formatters.convert(format, raw)
+
+      resp_type = case fields['type']
+        when 'photo' then OEmbed::Response::Photo
+        when 'video' then OEmbed::Response::Video
+        when 'link'  then OEmbed::Response::Link
+        when 'rich'  then OEmbed::Response::Rich
+        else              self
+      end
+
+      resp_type.new(fields, provider, url)
+    end
+
+    def initialize(fields, provider, url)
+      @fields = fields
+      @provider = provider
+      define_methods!
+    end
+
+    def field(m)
+      @fields[m.to_s]
+    end
+
+    def video?
+      is_a?(OEmbed::Response::Video)
+    end
+
+    def photo?
+      is_a?(OEmbed::Response::Photo)
+    end
+
+    def link?
+      is_a?(OEmbed::Response::Link)
+    end
+
+    def rich?
+      is_a?(OEmbed::Response::Rich)
+    end
+
+    private
+
+    def define_methods!
+      @fields.keys.each do |key|
+        next if METHODS.include?(key.to_sym) || key[0,2]=="__" || key[-1]==??
+        class << self
+          self
+        end.send(:define_method, key) do
+          @fields[key]
+        end
+      end
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/response/link.rb

@@ -0,0 +1,6 @@
+module OEmbed
+  class Response
+    class Link < self
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/response/photo.rb

@@ -0,0 +1,9 @@
+module OEmbed
+  class Response
+    class Photo < self
+      def html
+        "<img src='" + self.url + "' />"
+      end
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/response/rich.rb

@@ -0,0 +1,6 @@
+module OEmbed
+  class Response
+    class Rich < self
+    end
+  end
+end

data/vendor/ruby-oembed/lib/oembed/response/video.rb

@@ -0,0 +1,6 @@
+module OEmbed
+  class Response
+    class Video < self
+    end
+  end
+end

data/vendor/ruby-oembed/spec/provider_spec.rb

@@ -0,0 +1,175 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe OEmbed::Provider do
+  include OEmbedSpecHelper
+
+  before(:all) do
+    @default = OEmbed::Formatters::DEFAULT
+    @flickr = OEmbed::Provider.new("http://www.flickr.com/services/oembed/")
+    @qik = OEmbed::Provider.new("http://qik.com/api/oembed.{format}", :xml)
+    @viddler = OEmbed::Provider.new("http://lab.viddler.com/services/oembed/", :json)
+
+    @flickr << "http://*.flickr.com/*"
+    @qik << "http://qik.com/video/*"
+    @qik << "http://qik.com/*"
+    @viddler << "http://*.viddler.com/*"
+  end
+
+  it "should by default use OEmbed::Formatters::DEFAULT" do
+    @flickr.format.should == @default
+  end
+
+  it "should allow xml" do
+    @qik.format.should == :xml
+  end
+
+  it "should allow json" do
+    @viddler.format.should == :json
+  end
+
+  it "should not allow random formats" do
+    proc { OEmbed::Provider.new("http://www.hulu.com/api/oembed.{format}", :yml) }.
+    should raise_error(OEmbed::FormatNotSupported)
+  end
+
+  it "should add URL schemes" do
+    @flickr.urls.should == [%r{^http://([^\.]+\.)?flickr\.com/(.*?)}]
+    @qik.urls.should == [%r{^http://qik\.com/video/(.*?)},
+                         %r{^http://qik\.com/(.*?)}]
+  end
+
+  it "should match URLs" do
+    @flickr.include?(example_url(:flickr)).should be_true
+    @qik.include?(example_url(:qik)).should be_true
+  end
+
+  it "should detect if the format is in the URL" do
+    @flickr.format_in_url?.should be_false
+    @qik.format_in_url?.should be_true
+  end
+
+  it "should raise error if the URL is invalid" do
+    proc{ @flickr.build(example_url(:fake)) }.should raise_error(OEmbed::NotFound)
+    proc{ @qik.build(example_url(:fake)) }.should raise_error(OEmbed::NotFound)
+  end
+
+  describe "#build" do
+    it "should return a proper URL" do
+      uri = @flickr.build(example_url(:flickr))
+      uri.host.should == "www.flickr.com"
+      uri.path.should == "/services/oembed/"
+      uri.query.include?("format=#{@flickr.format}").should be_true
+      uri.query.include?("url=http://flickr.com/photos/bees/2362225867/").should be_true
+
+      uri = @qik.build(example_url(:qik))
+      uri.host.should == "qik.com"
+      uri.path.should == "/api/oembed.xml"
+      uri.query.should == "url=http://qik.com/video/49565"
+    end
+
+    it "should accept parameters" do
+      uri = @flickr.build(example_url(:flickr),
+        :maxwidth => 600,
+        :maxheight => 200,
+        :format => :xml,
+        :another => "test")
+
+      uri.query.include?("maxwidth=600").should be_true
+      uri.query.include?("maxheight=200").should be_true
+      uri.query.include?("format=xml").should be_true
+      uri.query.include?("another=test").should be_true
+    end
+
+    it "should build correctly when format is in the endpoint URL" do
+      uri = @qik.build(example_url(:qik), :format => :json)
+      uri.path.should == "/api/oembed.json"
+    end
+  end
+
+  describe "#raw" do
+    it "should return the body on 200" do
+      res = Net::HTTPOK.new("1.1", 200, "OK").instance_eval do
+        @body = "raw content"
+        @read = true
+        self
+      end
+      Net::HTTP.stub!(:start).and_return(res)
+
+      @flickr.raw(example_url(:flickr)).should == "raw content"
+    end
+
+    it "should raise error on 501" do
+      res = Net::HTTPNotImplemented.new("1.1", 501, "Not Implemented")
+      Net::HTTP.stub!(:start).and_return(res)
+
+      proc do
+        @flickr.raw(example_url(:flickr))
+      end.should raise_error(OEmbed::UnknownFormat)
+    end
+
+    it "should raise error on 404" do
+      res = Net::HTTPNotFound.new("1.1", 404, "Not Found")
+      Net::HTTP.stub!(:start).and_return(res)
+
+      proc do
+        @flickr.raw(example_url(:flickr))
+      end.should raise_error(OEmbed::NotFound)
+    end
+
+    it "should raise error on all other responses" do
+      Net::HTTPResponse::CODE_TO_OBJ.delete_if do |code, res|
+        ["200", "404", "501"].include?(code)
+      end.each do |code, res|
+        r = res.new("1.1", code, "Message")
+        Net::HTTP.stub!(:start).and_return(r)
+
+        proc do
+          @flickr.raw(example_url(:flickr))
+        end.should raise_error(OEmbed::UnknownResponse)
+      end
+    end
+  end
+
+  describe "#get" do
+    it "should send the specified format" do
+      @flickr.should_receive(:raw).
+        with(example_url(:flickr), {:format=>:json}).
+        and_return(valid_response(:json))
+      @flickr.get(example_url(:flickr), :format=>:json)
+
+      @flickr.should_receive(:raw).
+        with(example_url(:flickr), {:format=>:xml}).
+        and_return(valid_response(:xml))
+      @flickr.get(example_url(:flickr), :format=>:xml)
+
+      lambda do
+        @flickr.should_receive(:raw).
+          with(example_url(:flickr), {:format=>:yml}).
+          and_return(valid_response(:json))
+        @flickr.get(example_url(:flickr), :format=>:yml)
+      end.should raise_error(OEmbed::FormatNotSupported)
+    end
+
+    it "should send the provider's format if none is specified" do
+      @flickr.should_receive(:raw).
+        with(example_url(:flickr), :format => @default).
+        and_return(valid_response(@default))
+      @flickr.get(example_url(:flickr))
+
+      @qik.should_receive(:raw).
+        with(example_url(:qik), :format=>:xml).
+        and_return(valid_response(:xml))
+      @qik.get(example_url(:qik))
+
+      @viddler.should_receive(:raw).
+        with(example_url(:viddler), :format=>:json).
+        and_return(valid_response(:json))
+      @viddler.get(example_url(:viddler))
+    end
+
+    it "should return OEmbed::Response" do
+      @flickr.stub!(:raw).and_return(valid_response(@default))
+      @flickr.get(example_url(:flickr)).is_a?(OEmbed::Response).should be_true
+    end
+  end
+end