ruby-oembed 0.7.6 → 0.8.1

data/lib/oembed/providers.rb

@@ -1,16 +1,23 @@
 require 'rubygems'
-require 'json'
+require 'yaml'
 
 module OEmbed
+  # Allows OEmbed to perform tasks across several, registered, Providers
+  # at once.
   class Providers
     class << self
       @@urls = {}
       @@fallback = []
 
+      # A Hash of all url schemes, where the keys represent schemes supported by
+      # all registered Provider instances and values are an Array of Providers
+      # that support that scheme.
       def urls
         @@urls
       end
 
+      # Given one ore more Provider instances, register their url schemes for
+      # future get calls.
       def register(*providers)
         providers.each do |provider|
           provider.urls.each do |url|
@@ -20,6 +27,8 @@ module OEmbed
         end
       end
 
+      # Given one ore more Provider instances, un-register their url schemes.
+      # Future get calls will not use these Providers.
       def unregister(*providers)
         providers.each do |provider|
           provider.urls.each do |url|
@@ -31,11 +40,25 @@ module OEmbed
         end
       end
 
+      # Register a standard set of common Provider instances, including:
+      # * Flickr
+      # * Hulu
+      # * Qik
+      # * Revision3
+      # * Viddler
+      # * Vimeo
+      # * Youtube
       def register_all
-        register(Youtube, Flickr, Viddler, Qik, Pownce, Revision3, Hulu, Vimeo)
+        register(Youtube, Flickr, Viddler, Qik, Revision3, Hulu, Vimeo)
       end
 
-      # Takes an array of OEmbed::Provider instances or OEmbed::ProviderDiscovery
+      # Unregister all currently-registered Provider instances.
+      def unregister_all
+        @@urls = {}
+        @@fallback = []
+      end
+
+      # Takes an array of Provider instances or 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
@@ -47,16 +70,19 @@ module OEmbed
         @@fallback += providers
       end
 
-      # Returns an array of all registerd fallback providers
+      # Returns an array of all registerd fallback Provider instances.
       def fallback
         @@fallback
       end
 
+      # Returns a Provider instance who's url scheme matches the given url.
       def find(url)
         providers = @@urls[@@urls.keys.detect { |u| u =~ url }]
         Array(providers).first || nil
       end
 
+      # Finds the appropriate Provider for this url and return the raw response.
+      # @deprecated *Note*: This method will be made private in the future.
       def raw(url, options = {})
         provider = find(url)
         if provider
@@ -69,6 +95,8 @@ module OEmbed
         end
       end
 
+      # Finds the appropriate Provider for this url and returns an OEmbed::Response,
+      # using Provider#get.
       def get(url, options = {})
         provider = find(url)
         if provider
@@ -83,38 +111,49 @@ module OEmbed
     end
 
     # Custom providers:
+    
+    # Provider for youtube.com
     Youtube = OEmbed::Provider.new("http://www.youtube.com/oembed")
     Youtube << "http://*.youtube.com/*"
     Youtube << "http://*.youtu.be/*"
 
+    # Provider for flickr.com
     Flickr = OEmbed::Provider.new("http://www.flickr.com/services/oembed/")
     Flickr << "http://*.flickr.com/*"
 
+    # Provider for viddler.com
     Viddler = OEmbed::Provider.new("http://lab.viddler.com/services/oembed/")
     Viddler << "http://*.viddler.com/*"
 
+    # Provider for qik.com
     Qik = OEmbed::Provider.new("http://qik.com/api/oembed.{format}")
     Qik << "http://qik.com/*"
     Qik << "http://qik.com/video/*"
 
+    # Provider for revision3.com
     Revision3 = OEmbed::Provider.new("http://revision3.com/api/oembed/")
     Revision3 << "http://*.revision3.com/*"
 
+    # Provider for hulu.com
     Hulu = OEmbed::Provider.new("http://www.hulu.com/api/oembed.{format}")
     Hulu << "http://www.hulu.com/watch/*"
 
+    # Provider for vimeo.com
     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/*"
+    # pownce.com closed in 2008
+    #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
+    # Provider for oohembed.com, which is a provider agregator. See
+    # OEmbed::Provders::OohEmbed.urls for a full list of supported url schemas.
     OohEmbed = OEmbed::Provider.new("http://oohembed.com/oohembed/", :json)
     OohEmbed << "http://*.5min.com/Video/*" # micro-video host
     OohEmbed << %r{http://(.*?).amazon.(com|co.uk|de|ca|jp)/(.*?)/(gp/product|o/ASIN|obidos/ASIN|dp)/(.*?)} # Online product shopping
     OohEmbed << "http://*.blip.tv/*"
+    OohEmbed << "http://*.clikthrough.com/theater/video/*"
     OohEmbed << "http://*.collegehumor.com/video:*" # Comedic & original videos
     OohEmbed << "http://*.thedailyshow.com/video/*" # Syndicated show
     OohEmbed << "http://*.dailymotion.com/*"
@@ -123,9 +162,12 @@ module OEmbed
     OohEmbed << "http://*.funnyordie.com/videos/*" # Comedy video host
     OohEmbed << "http://video.google.com/videoplay?*" # Video hosting
     OohEmbed << "http://www.hulu.com/watch/*"
+    OohEmbed << "http://*.kinomap.com/*"
     OohEmbed << "http://*.livejournal.com/"
     OohEmbed << "http://*.metacafe.com/watch/*" # Video host
     OohEmbed << "http://*.nfb.ca/film/*"
+    OohEmbed << "http://*.photobucket.com/albums/*"
+    OohEmbed << "http://*.photobucket.com/groups/*"
     OohEmbed << "http://*.phodroid.com/*/*/*" # Photo host
     OohEmbed << "http://qik.com/*"
     OohEmbed << "http://*.revision3.com/*"
@@ -142,35 +184,50 @@ module OEmbed
     OohEmbed << %r{http://yfrog.(com|ru|com.tr|it|fr|co.il|co.uk|com.pl|pl|eu|us)/(.*?)} # image & video hosting
     OohEmbed << "http://*.youtube.com/watch*"
 
-    # A general end point, which then calls other APIs and returns OEmbed info
+    # Provider for embedly.com, which is a provider agregator. See
+    # OEmbed::Provders::OohEmbed.urls for a full list of supported url schemas.
     Embedly = OEmbed::Provider.new("http://api.embed.ly/v1/api/oembed")
-    # An up-to-date version of this json file is available here: (http://api.embed.ly/static/data/embedly_regex.json
-    JSON.parse(File.open(File.dirname(__FILE__) + "/embedly_urls.json", "r").read).each do |url|
+    # Add all known URL regexps for Embedly. To update this list run `rake oembed:update_embedly`
+    YAML.load_file(File.join(File.dirname(__FILE__), "/providers/embedly_urls.yml")).each do |url|
       Embedly << url
     end
     
+    # Provider for polleverywhere.com
     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/*"
 
+    # Provider for my.opera.com
     MyOpera = OEmbed::Provider.new("http://my.opera.com/service/oembed", :json)
     MyOpera << "http://my.opera.com/*"
 
+    # Provider for clearspring.com
     ClearspringWidgets = OEmbed::Provider.new("http://widgets.clearspring.com/widget/v1/oembed/")
     ClearspringWidgets << "http://www.clearspring.com/widgets/*"
 
+    # Provider for nfb.ca
     NFBCanada = OEmbed::Provider.new("http://www.nfb.ca/remote/services/oembed/")
     NFBCanada << "http://*.nfb.ca/film/*"
 
+    # Provider for scribd.com
     Scribd = OEmbed::Provider.new("http://www.scribd.com/services/oembed")
     Scribd << "http://*.scribd.com/*"
 
+    # Provider for movieclips.com
     MovieClips = OEmbed::Provider.new("http://movieclips.com/services/oembed/")
     MovieClips << "http://movieclips.com/watch/*/*/"
 
+    # Provider for 23hq.com
     TwentyThree = OEmbed::Provider.new("http://www.23hq.com/23/oembed")
     TwentyThree << "http://www.23hq.com/*"
-
+    
+    # Provider for clikthrough.com
+    #Clickthrough = OEmbed::Provider.new("http://www.clikthrough.com/services/oembed/")
+    #Clickthrough << "http://*.clikthrough.com/theater/video/*"
+    #
+    ## Provider for kinomap.com
+    #Kinomap = OEmbed::Provider.new("http://www.kinomap.com/oembed")
+    #Kinomap << "http://www.kinomap.com/*"
   end
 end

data/lib/oembed/response/link.rb

@@ -1,6 +1,20 @@
 module OEmbed
   class Response
+    # A fairly generic type of Response where the url of the resource is
+    # the original request_url.
     class Link < self
+      
+      # Returns the request_url
+      def url
+        request_url
+      end
+      
+      private
+      
+      # See {section 2.3.4.1 of the oEmbed spec}[http://oembed.com/#section2.3]
+      def must_override
+        super
+      end
     end
   end
 end

data/lib/oembed/response/photo.rb

@@ -1,9 +1,21 @@
 module OEmbed
   class Response
+    # A Response used for representing static photos.
     class Photo < self
+      # Returns an <img> tag pointing at the appropraite URL.
       def html
         "<img src='" + self.url + "' />"
       end
+      
+      private
+      
+      # See {section 2.3.4.1 of the oEmbed spec}[http://oembed.com/#section2.3]
+      def must_override
+        %w{
+          url width height
+        } + super
+      end
+      
     end
   end
 end

data/lib/oembed/response/rich.rb

@@ -1,6 +1,17 @@
 module OEmbed
   class Response
+    # A Response used for representing rich HTML content that does not fall under
+    # one of the other Response categories.
     class Rich < self
+      
+      private
+      
+      # See {section 2.3.4.1 of the oEmbed spec}[http://oembed.com/#section2.3]
+      def must_override
+        %w{
+          html width height
+        } + super
+      end
     end
   end
 end

data/lib/oembed/response/video.rb

@@ -1,6 +1,16 @@
 module OEmbed
   class Response
+    # A Response used for representing playable videos.
     class Video < self
+      
+      private
+      
+      # See {section 2.3.4.1 of the oEmbed spec}[http://oembed.com/#section2.3]
+      def must_override
+        %w{
+          html width height
+        } + super
+      end
     end
   end
 end

data/lib/oembed/response.rb

@@ -1,10 +1,30 @@
 module OEmbed
+  # Contains oEmbed data about a URL, as returned by an OEmbed::Provider. The data
+  # stored in Response instances can be accessed by either using the field method
+  # _or_ by using the appropriate automatically-defined helper method.
+  # 
+  # For example:
+  #   @response.type #=> 'rich'
+  #   @response.field('width') #=> '500'
+  #   @response.width #=> '500'
   class Response
-    METHODS = [:define_methods!, :provider, :field, :fields]
-    attr_reader :fields, :provider, :format, :url
+    # An Hash of data (probably from a Provider) just as it was parsed.
+    attr_reader :fields
+    
+    # The Provider instance that generated this Response
+    attr_reader :provider
+    
+    # The URL that was sent to the provider, that this Response contains data about.
+    attr_reader :request_url
+    
+    # The name of the format used get this data from the Provider (e.g. 'json').
+    attr_reader :format
 
-    def self.create_for(raw, provider, url, format = :json)
-      fields = OEmbed::Formatters.convert(format, raw)
+    # Create a new Response instance of the correct type given raw
+    # which is data from the provider, about the url, in the given
+    # format that needs to be decoded.
+    def self.create_for(raw, provider, url, format)
+      fields = OEmbed::Formatter.decode(format, raw)
 
       resp_type = case fields['type']
         when 'photo' then OEmbed::Response::Photo
@@ -14,44 +34,72 @@ module OEmbed
         else              self
       end
 
-      resp_type.new(fields, provider, url)
+      resp_type.new(fields, provider, url, format)
     end
 
-    def initialize(fields, provider, url = nil)
+    def initialize(fields, provider, url=nil, format=nil)
       @fields = fields
       @provider = provider
+      @request_url = url
+      @format = format
       define_methods!
     end
 
-    def field(m)
-      @fields[m.to_s]
+    # The String value associated with this key. While you can use helper methods
+    # like Response#version, the field method is helpful if the Provider returns
+    # non-standard values that conflict with Ruby methods.
+    #
+    # For example, if the Provider returns a "clone" value of "true":
+    #   # The following calls the Object#clone method
+    #   @response.clone #=> #<OEmbed::Response:...
+    #
+    #   # The following returns the value given by the Provider
+    #   @response.field(:clone) #=> 'true'
+    def field(key)
+      @fields[key.to_s].to_s
     end
 
+    # Returns true if this is an oEmbed video response.
     def video?
       is_a?(OEmbed::Response::Video)
     end
 
+    # Returns true if this is an oEmbed photo response.
     def photo?
       is_a?(OEmbed::Response::Photo)
     end
 
+    # Returns true if this is an oEmbed link response.
     def link?
       is_a?(OEmbed::Response::Link)
     end
 
+    # Returns true if this is an oEmbed rich response.
     def rich?
       is_a?(OEmbed::Response::Rich)
     end
 
     private
 
+    # An Array of helper methods names define_methods! must be able to override
+    # when is's called. In general, define_methods! tries its best _not_ to override
+    # existing methods, so this Array is important if some other library has
+    # defined a method that uses an oEmbed name. For example: Object#version
+    def must_override
+      %w{
+        type version
+        title author_name author_url provider_name provider_url
+        cache_age thumbnail_url thumbnail_width thumbnail_height
+      }
+    end
+
     def define_methods!
       @fields.keys.each do |key|
-        next if METHODS.include?(key.to_sym) || key[0,2]=="__" || key[-1]==??
+        next if self.respond_to?(key) && !must_override.include?(key.to_s)
         class << self
           self
         end.send(:define_method, key) do
-          @fields[key]
+          field(key)
         end
       end
     end

data/lib/oembed/version.rb

@@ -0,0 +1,18 @@
+module OEmbed
+  class Version
+    MAJOR = 0
+    MINOR = 8
+    PATCH = 1
+    STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
+    
+    class << self
+      # A String representing the current version of the OEmbed gem.
+      def inspect
+        STRING
+      end
+      alias_method :to_s, :inspect
+    end
+  end
+  
+  VERSION = Version::STRING
+end

data/lib/oembed.rb

@@ -2,8 +2,9 @@ $:.unshift File.dirname(__FILE__)
 
 require 'net/http'
 
+require 'oembed/version'
 require 'oembed/errors'
-require 'oembed/formatters'
+require 'oembed/formatter'
 require 'oembed/provider'
 require 'oembed/provider_discovery'
 require 'oembed/providers'

data/lib/tasks/oembed.rake

@@ -0,0 +1,45 @@
+begin
+  require 'json'
+  require 'open-uri'
+
+  namespace :oembed do
+    desc "Update the embedly_urls.yml file using the services api."
+    task :update_embedly do
+      # Details at http://api.embed.ly/docs/service
+      json_uri = URI.parse("http://api.embed.ly/1/services")
+      yaml_path = File.join(File.dirname(__FILE__), "../oembed/providers/embedly_urls.yml")
+    
+      services = JSON.parse(json_uri.read)
+    
+      url_regexps = []
+      services.each do |service|
+        url_regexps += service['regex']
+      end
+      url_regexps.sort!
+    
+      YAML.dump(url_regexps, File.open(yaml_path, 'w'))
+    end
+  
+    # Note: At the moment the list of enpoints in the oohembed-provided JSON file
+    # do NOT match the full listing on their website. Until we sort that out, we'll
+    # continue to use the manually entered list of oohembed URLs
+    desc "Update the list of URLs supported by oohembed via their API"
+    task :update_oohembed do
+      # Details in the Q & A section of http://oohembed.com/
+      json_uri = URI.parse("http://oohembed.com/static/endpoints.json")
+      yaml_path = File.join(File.dirname(__FILE__), "../oembed/providers/oohembed_urls.yml")
+    
+      services = JSON.parse(json_uri.read)
+    
+      url_regexps = []
+      services.each do |service|
+        url_regexps << service['url']
+      end
+      url_regexps.sort!
+    
+      YAML.dump(url_regexps, File.open(yaml_path, 'w'))
+    end
+  end  
+rescue LoadError
+  puts "The oembed rake tasks require JSON. Install it with: gem install json"
+end

data/lib/tasks/rspec.rake

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

data/ruby-oembed.gemspec

@@ -5,55 +5,76 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ruby-oembed}
-  s.version = "0.7.6"
+  s.version = "0.8.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Magnus Holm", "Alex Kessinger", "Aris Bartee", "Marcos Wright Kuhns"]
-  s.date = %q{2010-10-14}
-  s.description = %q{An oEmbed client written in Ruby, letting you easily get embeddable HTML representations of a supported web pages, based on their URLs. See http://oembed.com for more about the protocol.}
+  s.date = %q{2011-02-27}
+  s.description = %q{An oEmbed consumer library written in Ruby, letting you easily get embeddable HTML representations of supported web pages, based on their URLs. See http://oembed.com for more information about the protocol.}
   s.email = %q{arisbartee@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.md"
+     "README.rdoc"
   ]
   s.files = [
     ".gitignore",
      ".rvmrc",
-     "CHANGELOG.md",
+     "CHANGELOG.rdoc",
      "Gemfile",
      "Gemfile.lock",
      "LICENSE",
-     "README.md",
+     "README.rdoc",
      "Rakefile",
-     "VERSION",
      "integration_test/test.rb",
      "integration_test/test_urls.csv",
      "lib/oembed.rb",
-     "lib/oembed/embedly_urls.json",
      "lib/oembed/errors.rb",
-     "lib/oembed/formatters.rb",
+     "lib/oembed/formatter.rb",
+     "lib/oembed/formatter/json.rb",
+     "lib/oembed/formatter/json/backends/activesupportjson.rb",
+     "lib/oembed/formatter/json/backends/jsongem.rb",
+     "lib/oembed/formatter/json/backends/yaml.rb",
+     "lib/oembed/formatter/xml.rb",
+     "lib/oembed/formatter/xml/backends/rexml.rb",
+     "lib/oembed/formatter/xml/backends/xmlsimple.rb",
      "lib/oembed/provider.rb",
      "lib/oembed/provider_discovery.rb",
      "lib/oembed/providers.rb",
+     "lib/oembed/providers/embedly_urls.yml",
+     "lib/oembed/providers/oohembed_urls.yml",
      "lib/oembed/response.rb",
      "lib/oembed/response/link.rb",
      "lib/oembed/response/photo.rb",
      "lib/oembed/response/rich.rb",
      "lib/oembed/response/video.rb",
-     "rails/init.rb",
+     "lib/oembed/version.rb",
+     "lib/tasks/oembed.rake",
+     "lib/tasks/rspec.rake",
      "ruby-oembed.gemspec",
+     "spec/formatter/json/.DS_Store",
+     "spec/formatter/json/jsongem_backend_spec.rb",
+     "spec/formatter/json/yaml_backend_spec.rb",
+     "spec/formatter/xml/rexml_backend_spec.rb",
+     "spec/formatter/xml/xmlsimple_backend_spec.rb",
+     "spec/formatter_spec.rb",
      "spec/provider_spec.rb",
      "spec/providers_spec.rb",
      "spec/response_spec.rb",
      "spec/spec_helper.rb"
   ]
   s.homepage = %q{http://github.com/judofyr/ruby-oembed}
-  s.rdoc_options = ["--charset=UTF-8"]
+  s.licenses = ["MIT"]
+  s.rdoc_options = ["--main", "README.rdoc", "--title", "ruby-oembed-0.8.1", "--inline-source", "--exclude", "tasks", "CHANGELOG.rdoc"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.7}
   s.summary = %q{oEmbed for Ruby}
   s.test_files = [
-    "spec/provider_spec.rb",
+    "spec/formatter/json/jsongem_backend_spec.rb",
+     "spec/formatter/json/yaml_backend_spec.rb",
+     "spec/formatter/xml/rexml_backend_spec.rb",
+     "spec/formatter/xml/xmlsimple_backend_spec.rb",
+     "spec/formatter_spec.rb",
+     "spec/provider_spec.rb",
      "spec/providers_spec.rb",
      "spec/response_spec.rb",
      "spec/spec_helper.rb"
@@ -64,18 +85,18 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<json>, [">= 0"])
-      s.add_runtime_dependency(%q<xml-simple>, [">= 0"])
-      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<json>, [">= 0"])
+      s.add_development_dependency(%q<xml-simple>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 2.0"])
     else
       s.add_dependency(%q<json>, [">= 0"])
       s.add_dependency(%q<xml-simple>, [">= 0"])
-      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 2.0"])
     end
   else
     s.add_dependency(%q<json>, [">= 0"])
     s.add_dependency(%q<xml-simple>, [">= 0"])
-    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 2.0"])
   end
 end
 

data/spec/formatter/json/jsongem_backend_spec.rb

@@ -0,0 +1,34 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe "OEmbed::Formatter::JSON::Backends::JSONGem" do
+  include OEmbedSpecHelper
+
+  before(:all) do
+    lambda {
+      OEmbed::Formatter::JSON.backend = 'JSONGem'
+    }.should raise_error(LoadError)
+    
+    require 'json'
+    
+    lambda {
+      OEmbed::Formatter::JSON.backend = 'JSONGem'
+    }.should_not raise_error
+  end
+
+  it "should support JSON" do
+    proc { OEmbed::Formatter.supported?(:json) }.
+    should_not raise_error(OEmbed::FormatNotSupported)
+  end
+  
+  it "should be using the JSONGem backend" do
+    OEmbed::Formatter::JSON.backend.should == OEmbed::Formatter::JSON::Backends::JSONGem
+  end
+  
+  it "should decode a JSON String" do
+    decoded = OEmbed::Formatter.decode(:json, valid_response(:json))
+    # We need to compare keys & values separately because we don't expect all
+    # non-string values to be recognized correctly.
+    decoded.keys.should == valid_response(:object).keys
+    decoded.values.map{|v|v.to_s}.should == valid_response(:object).values.map{|v|v.to_s}
+  end
+end

data/spec/formatter/json/yaml_backend_spec.rb

@@ -0,0 +1,30 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe "OEmbed::Formatter::JSON::Backends::Yaml" do
+  include OEmbedSpecHelper
+
+  before(:all) do
+    lambda {
+      OEmbed::Formatter::JSON.backend = 'Yaml'
+    }.should_not raise_error
+    
+    (!!defined?(YAML)).should == true
+  end
+
+  it "should support JSON" do
+    proc { OEmbed::Formatter.supported?(:json) }.
+    should_not raise_error(OEmbed::FormatNotSupported)
+  end
+  
+  it "should be using the Yaml backend" do
+    OEmbed::Formatter::JSON.backend.should == OEmbed::Formatter::JSON::Backends::Yaml
+  end
+  
+  it "should decode a JSON String" do
+    decoded = OEmbed::Formatter.decode(:json, valid_response(:json))
+    # We need to compare keys & values separately because we don't expect all
+    # non-string values to be recognized correctly.
+    decoded.keys.should == valid_response(:object).keys
+    decoded.values.map{|v|v.to_s}.should == valid_response(:object).values.map{|v|v.to_s}
+  end
+end