Class: OEmbed::ProviderDiscovery

Inherits:
Object
  • Object
show all
Defined in:
lib/oembed/provider_discovery.rb

Overview

Uses oEmbed Discover to generate a new Provider instance about a URL for which a Provider didn’t previously exist.

Class Method Summary collapse

Class Method Details

.discover_provider(url, options = {}) ⇒ Object

Returns a new Provider instance based on information from oEmbed discovery performed on the given url.

The options Hash recognizes the following keys:

:format

If given only discover endpoints for the given format. If not format is given, use the first available format found.



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/oembed/provider_discovery.rb', line 27

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::HTTPSuccess
    format = options[:format]

    if format.nil? || format == :json
      provider_endpoint ||= /<link.*href=['"]*([^\s'"]+)['"]*.*application\/json\+oembed.*>/.match(res.body)[1] rescue nil
      provider_endpoint ||= /<link.*application\/json\+oembed.*href=['"]*([^\s'"]+)['"]*.*>/.match(res.body)[1] rescue nil
      format ||= :json if provider_endpoint
    end
    if format.nil? || format == :xml
      # {The specification}[http://oembed.com/#section4] says XML discovery should have
      # type="text/xml+oembed" but some providers use type="application/xml+oembed"
      provider_endpoint ||= /<link.*href=['"]*([^\s'"]+)['"]*.*(application|text)\/xml\+oembed.*>/.match(res.body)[1] rescue nil
      provider_endpoint ||= /<link.*(application|text)\/xml\+oembed.*href=['"]*([^\s'"]+)['"]*.*>/.match(res.body)[2] rescue nil
      format ||= :xml if provider_endpoint
    end

    begin
      provider_endpoint = URI.parse(provider_endpoint)
      provider_endpoint.query = nil
      provider_endpoint = provider_endpoint.to_s
    rescue URI::Error
      raise OEmbed::NotFound, url
    end

    Provider.new(provider_endpoint, format || OEmbed::Formatter.default)
  else
    raise OEmbed::UnknownResponse, res.code
  end
end

.get(url, query = {}) ⇒ Object

Discover the Provider for the given url, then call Provider#get on that provider. The query parameter will be passed to both discover_provider and Provider#get



17
18
19
20
 
# File 'lib/oembed/provider_discovery.rb', line 17

def get(url, query={})
  provider = discover_provider(url, query)
  provider.get(url, query)
end

.raw(url, query = {}) ⇒ Object

Deprecated.

Note: This method will be made private in the future.

Discover the Provider for the given url, then call Provider#raw on that provider. The query parameter will be passed to both discover_provider and Provider#raw



10
11
12
13
 
# File 'lib/oembed/provider_discovery.rb', line 10

def raw(url, query={})
  provider = discover_provider(url, query)
  provider.raw(url, options)
end