ruby-oembed 0.14.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ce690eea65c79e7df55ec323c59bf8c2ec43c9b94c1f084ad558b70c392cef9
-  data.tar.gz: b964d57ad3902a1dc99911aecc7f7f566a89ce2b6fdaa22ab34763c01a4e8aba
+  metadata.gz: dfcdff2a45ff8d739d78d8b44f0694735d6bb962b01ff6e0fef85e0a089d1d23
+  data.tar.gz: 3fdef0f50c4d9f65a316099e069fde6e50c3dcdd52bb3251fa3c97d300736dbb
 SHA512:
-  metadata.gz: 5e694d02b886ff90fa2d14afcbaefeda99ab258e632d8126e0e2d61c308edb0eb3001cd517ce1342e3eea033d31eeca1a8016068392e406689ffb08c95242c02
-  data.tar.gz: 3aba0c2994ae8fa2b87a172e03dfb4a529eec7ccfabd393b2182a91822bb4856ae2409983d0cb3755a092a191729d0af84c755f14e384a3cd5a2ce9c80b814f6
+  metadata.gz: a6f93f4aa24f1cbf281c94657d2f58749599f1b7628e835475feb61eed2136333736478ce34f82bff209b9557ce70dd6ef1214ddaffdd99ba36fcdd6bb1a3793
+  data.tar.gz: bd3bdbd9a24b06c715498ca90691998d13fb05b13332f698b1f4065cd639d46db9644404328ef4f0d7a74cc46488008f1d36688b89f8b99324df6c6ed4ca48a2

data/.travis.yml

@@ -5,5 +5,8 @@ before_install:
 bundler_args: --without guard
 cache: bundler
 rvm:
-  - 2.4.1
-  - 2.6.5
+  - 2.6.9
+  - 3.0.3
+env:
+  global:
+    - RUN_ALL_TESTS=true

data/CHANGELOG.rdoc

@@ -1,11 +1,34 @@
 = CHANGELOG
 
-== Unreleased (0.14.1)
+== Unreleased (0.16.2)
 
+== 0.16.1 - 13 January 2022
+
+* Fix the "already initialized constant OEmbed::Providers::TikTok" warning; Pull #84 (Christopher Nelson)
+
+== 0.16.0 - 8 January 2022
+
+* Add a built-in TikTok provider.
+* Reduce gem size by excluding test files; Pull #81 (fauno)
+
+== 0.15.0 - 1 January 2021
+
+* *DEPRECATION* When creating an `OEmbed::Provider` instance, specifying the format via positional argument is now deprecated. Please use a named argument instead: `OEmbed::Provider.new(@endpoint_url, format: :json)`
+* *DEPRECATION* Do not use the `new` method for `Instagram`, `FacebookPost`, or `FacebookVideo` providers to set your access token. Instead either use the `OEMBED_FACEBOOK_TOKEN` environment variable or call `Instagram.access_token = @your_token`.
+* Fix Issue #77: Built-in Instagram & Facebook providers are now instances again.
+* Add support for `OEmbed::Provider` instances with `required_query_params` (like access tokens), where the provider will fail to answer until it is fully configured.
+* Add support for Instgram Reels URLs to the built-in OEmbed::Providers::Instagram.
+* Support focused rspec tests for local development (e.g. "fcontext" or "fit")
+* Fix a few typos in documentation & tests; Pull #76 (Inge Jørgensen)
+
+== 0.14.1 - 28 December 2020
+
+* Fix the YouTube provider when given a private video; Issue #79 (Sebastian Schulze)
 
 == 0.14.0 - 5 November 2020
 
-* Add support for Facebook/Instragram access tokens; Pull #75 (Inge Jørgensen)
+* *BREAKING* Built-in providers for Instagram & Facebook are now classes, not instances, and therefore can't manually be registered via `OEmbed::Providers.register(OEmbed::Providers::Instagram)`; See Issue #77
+* Add support for Facebook/Instagram access tokens; Pull #75 (Inge Jørgensen)
 
 == 0.13.1 - 25 May 2020
 

data/README.md

@@ -1,10 +1,10 @@
 # ruby-oembed
 
 [![Gem](https://img.shields.io/gem/v/ruby-oembed.svg)](https://rubygems.org/gems/ruby-oembed)
-[![Travis branch](https://img.shields.io/travis/ruby-oembed/ruby-oembed/master.svg)](https://travis-ci.org/ruby-oembed/ruby-oembed/branches)
+[![Travis CI](https://img.shields.io/travis/com/ruby-oembed/ruby-oembed.svg)](https://app.travis-ci.com/github/ruby-oembed/ruby-oembed)
 [![Code Climate](https://img.shields.io/codeclimate/maintainability/ruby-oembed/ruby-oembed.svg)](https://codeclimate.com/github/ruby-oembed/ruby-oembed)
 [![Coveralls](https://coveralls.io/repos/github/ruby-oembed/ruby-oembed/badge.svg?branch=coveralls)](https://coveralls.io/github/ruby-oembed/ruby-oembed?branch=coveralls)
-![Maintenance](https://img.shields.io/maintenance/yes/2020.svg)
+![Maintenance](https://img.shields.io/maintenance/yes/2022.svg)
 
 
 An oEmbed consumer library written in Ruby, letting you easily get embeddable HTML representations of supported web pages, based on their URLs. See [oembed.com](http://oembed.com) for more about the protocol.
@@ -50,8 +50,8 @@ OEmbed::Providers.register_all
 
 #### Currently supported access tokens
 
-| access_token | environment variable    | Associaed Providers |
-|--------------|-------------------------|---------------------|
+| access_token | environment variable    | Associated Providers |
+|--------------|-------------------------|----------------------|
 | `:facebook`  | `OEMBED_FACEBOOK_TOKEN` | `FacebookPost`, `FacebookVideo`, `Instagram` |
 
 ## Custom Providers
@@ -106,8 +106,6 @@ The following, optional, backends are currently supported:
 
 # Lend a Hand
 
-**Note:** Work is under way on a v1.0 of ruby-oembed. If you'd like to contribute, take a look at [the rubocop branch!](https://github.com/ruby-oembed/ruby-oembed/tree/rubocop)
-
 Code for the ruby-oembed library is [hosted on GitHub](https://github.com/ruby-oembed/ruby-oembed).
 
 ```bash
@@ -127,7 +125,7 @@ If you encounter any bug, feel free to [create an Issue](https://github.com/ruby
 
 We gladly accept pull requests! Just [fork](http://help.github.com/forking/) the library and commit your changes along with relevant tests. Once you're happy with the changes, [send a pull request](http://help.github.com/pull-requests/).
 
-We do our best to [keep our tests green](http://travis-ci.org/ruby-oembed/ruby-oembed)
+We do our best to [keep our tests green](https://app.travis-ci.com/github/ruby-oembed/ruby-oembed)
 
 # Contributors
 

data/lib/oembed/provider.rb

@@ -36,9 +36,15 @@ module OEmbed
     # In actual requests to this Provider, this string will be replaced with a String
     # representing the request format (e.g. "json").
     #
-    # If give, the format should be the name of the default format for all request
+    # The `format:` option should be the name of the default format for all request
     # to this Provider (e.g. 'json'). Defaults to OEmbed::Formatter.default
     #
+    # # @deprecated *Note*: The `positional_format` is deprecated. Please used the named argument instead.
+    #
+    # The `required_query_params:` option should be a Hash
+    # representing query params that will be appended to the endpoint on each request
+    # and the optional name of an environment variable (i.e. ENV) whose value will be used
+    #
     # For example:
     #   # If requests should be sent to:
     #   # "http://my.service.com/oembed?format=#{OEmbed::Formatter.default}"
@@ -46,14 +52,31 @@ module OEmbed
     #
     #   # If requests should be sent to:
     #   # "http://my.service.com/oembed.xml"
-    #   @xml_provider = OEmbed::Provider.new("http://my.service.com/oembed.{format}", :xml)
-    def initialize(endpoint, format = OEmbed::Formatter.default)
+    #   @xml_provider = OEmbed::Provider.new("http://my.service.com/oembed.{format}", format: :xml)
+    #
+    #   # If the endpoint requires an `access_token` be specified:
+    #   @provider_with_auth = OEmbed::Provider.new("http://my.service.com/oembed", required_query_params: { access_token: 'MY_SERVICE_ACCESS_TOKEN' })
+    #   # You can optionally override the value from `ENV['MY_SERVICE_ACCESS_TOKEN']`
+    #   @provider_with_auth.access_token = @my_access_token
+    def initialize(endpoint, positional_format = OEmbed::Formatter.default, format: nil, required_query_params: {})
       endpoint_uri = URI.parse(endpoint.gsub(/[\{\}]/,'')) rescue nil
       raise ArgumentError, "The given endpoint isn't a valid http(s) URI: #{endpoint.to_s}" unless endpoint_uri.is_a?(URI::HTTP)
 
+      @required_query_params = {}
+      required_query_params.each do |param, default_env_var|
+        param = param.to_sym
+        @required_query_params[param] = nil
+        set_required_query_params(param, ENV[default_env_var]) if default_env_var
+
+        # Define a getter and a setter for each required_query_param
+        define_singleton_method("#{param}") { @required_query_params[param] } unless respond_to?("#{param}")
+        define_singleton_method("#{param}=") { |val| set_required_query_params(param, val) } unless respond_to?("#{param}=")
+      end
+      required_query_params_set?(reset_cache: true)
+
       @endpoint = endpoint
       @urls = []
-      @format = format
+      @format = format || positional_format
     end
 
     # Adds the given url scheme to this Provider instance.
@@ -75,6 +98,28 @@ module OEmbed
       @urls << url
     end
 
+    # Given the name of a required_query_param and a value
+    # store that value internally, so that it can be sent along
+    # with requests to this provider's endpoint.
+    # Raises an ArgumentError if the given param is not listed with required_query_params
+    # during instantiation.
+    def set_required_query_params(param, val)
+      raise ArgumentError.new("This provider does NOT have a required_query_param named #{param.inspect}") unless @required_query_params.has_key?(param)
+
+      @required_query_params[param] = val.nil? ? nil : ::CGI.escape(val.to_s)
+
+      required_query_params_set?(reset_cache: true)
+
+      @required_query_params[param]
+    end
+
+    # Returns true if all of this provider's required_query_params have a value
+    def required_query_params_set?(reset_cache: false)
+      return @all_required_query_params_set unless reset_cache || @all_required_query_params_set.nil?
+
+      @all_required_query_params_set = !@required_query_params.values.include?(nil)
+    end
+
     # Send a request to the Provider endpoint to get information about the
     # given url and return the appropriate OEmbed::Response.
     #
@@ -92,7 +137,9 @@ module OEmbed
 
     # Determine whether the given url is supported by this Provider by matching
     # against the Provider's URL schemes.
+    # It will always return false of a provider has required_query_params that are not set.
     def include?(url)
+      return false unless required_query_params_set?
       @urls.empty? || !!@urls.detect{ |u| u =~ url }
     end
 
@@ -100,10 +147,12 @@ module OEmbed
     def build(url, query = {})
       raise OEmbed::NotFound, url unless include?(url)
 
-      query = query.merge({:url => ::CGI.escape(url)})
       query.delete(:timeout)
       query.delete(:max_redirects)
 
+      query = query.merge(@required_query_params)
+      query = query.merge({:url => ::CGI.escape(url)})
+
       # TODO: move this code exclusively into the get method, once build is private.
       this_format = (query[:format] ||= @format.to_s).to_s
 

data/lib/oembed/providers/builtin_providers.rb

@@ -0,0 +1,292 @@
+# This file is used to load all built-in providers.
+# In the short term most of them are specified in this file
+# though we've _started_ moving provider definitions into their own files!
+
+require 'oembed/providers/facebook_post'
+require 'oembed/providers/facebook_video'
+require 'oembed/providers/instagram'
+require 'oembed/providers/tiktok'
+
+module OEmbed
+  class Providers
+    # Provider for youtube.com
+    # http://apiblog.youtube.com/2009/10/oembed-support.html
+    #
+    # Options:
+    # * To get the iframe embed code
+    #     OEmbed::Providers::Youtube.endpoint += "?iframe=1"
+    # * To get the flash/object embed code
+    #     OEmbed::Providers::Youtube.endpoint += "?iframe=0"
+    # * To require https embed code
+    #     OEmbed::Providers::Youtube.endpoint += "?scheme=https"
+    Youtube = OEmbed::Provider.new("https://www.youtube.com/oembed/?scheme=https")
+    Youtube << "http://*.youtube.com/*"
+    Youtube << "https://*.youtube.com/*"
+    Youtube << "http://*.youtu.be/*"
+    Youtube << "https://*.youtu.be/*"
+    add_official_provider(Youtube)
+
+    # Provider for codepen.io
+    CodePen = OEmbed::Provider.new("https://codepen.io/api/oembed")
+    CodePen << "http://codepen.io/*"
+    CodePen << "https://codepen.io/*"
+    add_official_provider(CodePen)
+
+    # Provider for flickr.com
+    Flickr = OEmbed::Provider.new("https://www.flickr.com/services/oembed/")
+    Flickr << "http://*.flickr.com/*"
+    Flickr << "https://*.flickr.com/*"
+    Flickr << "http://flic.kr/*"
+    Flickr << "https://flic.kr/*"
+    add_official_provider(Flickr)
+
+    # Provider for viddler.com
+    # http://developers.viddler.com/documentation/services/oembed/
+    Viddler = OEmbed::Provider.new("http://lab.viddler.com/services/oembed/")
+    Viddler << "http://*.viddler.com/*"
+    add_official_provider(Viddler)
+
+    # Provider for qik.com
+    # http://qik.com/blog/qik-embraces-oembed-for-embedding-videos/
+    Qik = OEmbed::Provider.new("http://qik.com/api/oembed.{format}")
+    Qik << "http://qik.com/*"
+    Qik << "http://qik.com/video/*"
+    add_official_provider(Qik)
+
+    # Provider for revision3.com
+    Revision3 = OEmbed::Provider.new("http://revision3.com/api/oembed/")
+    Revision3 << "http://*.revision3.com/*"
+    add_official_provider(Revision3)
+
+    # Provider for hulu.com
+    Hulu = OEmbed::Provider.new("https://www.hulu.com/api/oembed.{format}")
+    Hulu << "http://www.hulu.com/watch/*"
+    Hulu << "https://www.hulu.com/watch/*"
+    add_official_provider(Hulu)
+
+    # Provider for vimeo.com
+    # https://developer.vimeo.com/apis/oembed
+    Vimeo = OEmbed::Provider.new("https://vimeo.com/api/oembed.{format}")
+    Vimeo << "http://*.vimeo.com/*"
+    Vimeo << "https://*.vimeo.com/*"
+    add_official_provider(Vimeo)
+
+    # Provider for twitter.com
+    # https://dev.twitter.com/rest/reference/get/statuses/oembed
+    Twitter = OEmbed::Provider.new("https://publish.twitter.com/oembed", format: :json)
+    Twitter << "https://*.twitter.com/*/status/*"
+    add_official_provider(Twitter)
+
+    # Provider for vine.co
+    # https://dev.twitter.com/web/vine/oembed
+    Vine = OEmbed::Provider.new("https://vine.co/oembed.{format}")
+    Vine << "http://*.vine.co/v/*"
+    Vine << "https://*.vine.co/v/*"
+    add_official_provider(Vine)
+
+    # Provider for slideshare.net
+    # http://www.slideshare.net/developers/oembed
+    Slideshare = OEmbed::Provider.new("https://www.slideshare.net/api/oembed/2")
+    Slideshare << 'http://*.slideshare.net/*/*'
+    Slideshare << 'https://*.slideshare.net/*/*'
+    Slideshare << 'http://*.slideshare.net/mobile/*/*'
+    Slideshare << 'https://*.slideshare.net/mobile/*/*'
+    add_official_provider(Slideshare)
+
+    # Provider for yfrog
+    # http://code.google.com/p/imageshackapi/wiki/OEMBEDSupport
+    Yfrog = OEmbed::Provider.new("https://www.yfrog.com/api/oembed", format: :json)
+    Yfrog << "http://yfrog.com/*"
+    add_official_provider(Yfrog)
+
+    # Provider for Giphy
+    Giphy = OEmbed::Provider.new("http://giphy.com/services/oembed")
+    Giphy << "http://giphy.com/*"
+    Giphy << "https://giphy.com/*"
+    add_official_provider(Giphy)
+
+    # Provider for imgur.com
+    Imgur = OEmbed::Provider.new("https://api.imgur.com/oembed.{format}")
+    Imgur << "https://*.imgur.com/gallery/*"
+    Imgur << "http://*.imgur.com/gallery/*"
+    add_official_provider(Imgur)
+
+    # Provider for Kickstarter
+    Kickstarter = OEmbed::Provider.new("https://www.kickstarter.com/services/oembed")
+    Kickstarter << "http://www.kickstarter.com/projects/*"
+    Kickstarter << "https://www.kickstarter.com/projects/*"
+    add_official_provider(Kickstarter)
+
+    # provider for mlg-tv
+    # http://tv.majorleaguegaming.com/oembed
+    MlgTv = OEmbed::Provider.new("http://tv.majorleaguegaming.com/oembed")
+    MlgTv << "http://tv.majorleaguegaming.com/video/*"
+    MlgTv << "http://mlg.tv/video/*"
+    add_official_provider(MlgTv)
+
+    # pownce.com closed in 2008
+    #Pownce = OEmbed::Provider.new("http://api.pownce.com/2.1/oembed.{format}")
+    #Pownce << "http://*.pownce.com/*"
+    #add_official_provider(Pownce)
+
+    # 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/*"
+    add_official_provider(PollEverywhere)
+
+    # Provider for my.opera.com
+    # http://my.opera.com/devblog/blog/2008/12/02/embedding-my-opera-content-oembed
+    MyOpera = OEmbed::Provider.new("http://my.opera.com/service/oembed", format: :json)
+    MyOpera << "http://my.opera.com/*"
+    add_official_provider(MyOpera)
+
+    # Provider for clearspring.com
+    ClearspringWidgets = OEmbed::Provider.new("http://widgets.clearspring.com/widget/v1/oembed/")
+    ClearspringWidgets << "http://www.clearspring.com/widgets/*"
+    add_official_provider(ClearspringWidgets)
+
+    # Provider for nfb.ca
+    NFBCanada = OEmbed::Provider.new("http://www.nfb.ca/remote/services/oembed/")
+    NFBCanada << "http://*.nfb.ca/film/*"
+    add_official_provider(NFBCanada)
+
+    # Provider for scribd.com
+    Scribd = OEmbed::Provider.new("https://www.scribd.com/services/oembed")
+    Scribd << "http://*.scribd.com/*"
+    add_official_provider(Scribd)
+
+    # Provider for speakerdeck.com
+    # https://speakerdeck.com/faq#oembed
+    SpeakerDeck = OEmbed::Provider.new("https://speakerdeck.com/oembed.json")
+    SpeakerDeck << "http://speakerdeck.com/*/*"
+    SpeakerDeck << "https://speakerdeck.com/*/*"
+    add_official_provider(SpeakerDeck)
+
+    # Provider for movieclips.com
+    MovieClips = OEmbed::Provider.new("http://movieclips.com/services/oembed/")
+    MovieClips << "http://movieclips.com/watch/*/*/"
+    add_official_provider(MovieClips)
+
+    # Provider for 23hq.com
+    TwentyThree = OEmbed::Provider.new("http://www.23hq.com/23/oembed")
+    TwentyThree << "http://www.23hq.com/*"
+    add_official_provider(TwentyThree)
+
+    # Provider for soundcloud.com
+    # http://developers.soundcloud.com/docs/oembed
+    SoundCloud = OEmbed::Provider.new("https://soundcloud.com/oembed", format: :json)
+    SoundCloud << "http://*.soundcloud.com/*"
+    SoundCloud << "https://*.soundcloud.com/*"
+    add_official_provider(SoundCloud)
+
+    # Provider for spotify.com
+    # https://twitter.com/nicklas2k/status/330094611202723840
+    # http://blog.embed.ly/post/45149936446/oembed-for-spotify
+    Spotify = OEmbed::Provider.new("https://embed.spotify.com/oembed/")
+    Spotify << "http://open.spotify.com/*"
+    Spotify << "https://open.spotify.com/*"
+    Spotify << "http://play.spotify.com/*"
+    Spotify << "https://play.spotify.com/*"
+    Spotify << /^spotify\:(.*?)/
+    add_official_provider(Spotify)
+
+    # Provider for skitch.com
+    # http://skitch.com/oembed/%3C/endpoint
+    Skitch = OEmbed::Provider.new("http://skitch.com/oembed")
+    Skitch << "http://*.skitch.com/*"
+    Skitch << "https://*.skitch.com/*"
+    add_official_provider(Skitch)
+
+    # Provider for TED
+    Ted = OEmbed::Provider.new("https://www.ted.com/talks/oembed.{format}")
+    Ted << "http://*.ted.com/talks/*"
+    Ted << "https://*.ted.com/talks/*"
+    add_official_provider(Ted)
+
+    # Provider for tumblr.com
+    Tumblr = OEmbed::Provider.new("http://www.tumblr.com/oembed/1.0/", format: :json)
+    Tumblr << "http://*.tumblr.com/post/*"
+    Tumblr << "https://*.tumblr.com/post/*"
+    add_official_provider(Tumblr)
+
+    ## Provider for clikthrough.com
+    # http://corporate.clikthrough.com/wp/?p=275
+    #Clickthrough = OEmbed::Provider.new("http://www.clikthrough.com/services/oembed/")
+    #Clickthrough << "http://*.clikthrough.com/theater/video/*"
+    #add_official_provider(Clickthrough)
+
+    ## Provider for kinomap.com
+    # http://www.kinomap.com/#!oEmbed
+    #Kinomap = OEmbed::Provider.new("http://www.kinomap.com/oembed")
+    #Kinomap << "http://www.kinomap.com/*"
+    #add_official_provider(Kinomap)
+
+    # Provider for oohembed.com, which is a provider aggregator. See
+    # OEmbed::Providers::OohEmbed.urls for a full list of supported url schemas.
+    # Embed.ly has taken over the oohembed.com domain and as of July 20 all oohEmbed
+    # request will require you use an API key. For details on the transition see
+    # http://blog.embed.ly/oohembed
+    OohEmbed = OEmbed::Provider.new("http://oohembed.com/oohembed/", format: :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/*"
+    OohEmbed << "http://dotsub.com/view/*"
+    OohEmbed << "http://*.flickr.com/photos/*"
+    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/*"
+    OohEmbed << "http://*.scribd.com/*"
+    OohEmbed << "http://*.slideshare.net/*" # Share presentations online
+    OohEmbed << "http://*.twitpic.com/*" # Picture hosting for Twitter
+    OohEmbed << "http://twitter.com/*/statuses/*" # Mirco-blogging network
+    OohEmbed << "http://*.viddler.com/explore/*"
+    OohEmbed << "http://www.vimeo.com/*"
+    OohEmbed << "http://www.vimeo.com/groups/*/videos/*"
+    OohEmbed << "http://*.wikipedia.org/wiki/*" # Online encyclopedia
+    OohEmbed << "http://*.wordpress.com/*/*/*/*" # Blogging Engine & community
+    OohEmbed << "http://*.xkcd.com/*" # A hilarious stick figure comic
+    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*"
+
+    # Provider for noembed.com, which is a provider aggregator. See
+    # OEmbed::Providers::Noembed.urls for a full list of supported url schemas.
+    # https://noembed.com/#supported-sites
+    Noembed = OEmbed::Provider.new("https://noembed.com/embed")
+    # Add all known URL regexps for Noembed.
+    # To update this list run `rake oembed:update_noembed`
+    YAML.load_file(File.join(File.dirname(__FILE__), "/aggregators/noembed_urls.yml")).each do |url|
+      Noembed << Regexp.new(url)
+    end
+    add_official_provider(Noembed, :aggregators)
+
+    # Provider for Embedly.com, which is a provider aggregator. See
+    # OEmbed::Providers::Embedly.urls for a full list of supported url schemas.
+    # http://embed.ly/docs/endpoints/1/oembed
+    #
+    # You can append your Embed.ly API key to the provider so that all requests are signed
+    #     OEmbed::Providers::Embedly.endpoint += "?key=#{my_embedly_key}"
+    #
+    # If you don't yet have an API key you'll need to sign up here: http://embed.ly/pricing
+    Embedly = OEmbed::Provider.new("http://api.embed.ly/1/oembed")
+    # Add all known URL regexps for Embedly. To update this list run `rake oembed:update_embedly`
+    YAML.load_file(File.join(File.dirname(__FILE__), "/aggregators/embedly_urls.yml")).each do |url|
+      Embedly << url
+    end
+    add_official_provider(Embedly, :aggregators)
+  end
+end

data/lib/oembed/providers/facebook_post.rb

@@ -1,25 +1,35 @@
 module OEmbed
   class Providers
     # Provider for Facebook posts
-    class FacebookPost < OEmbed::Provider
-      def initialize(access_token:)
-        super("https://graph.facebook.com/v8.0/oembed_post?access_token=#{access_token}", :json)
-        register_urls!
-      end
+    # See https://developers.facebook.com/docs/plugins/oembed
+    # See https://developers.facebook.com/docs/graph-api/reference/v8.0/oembed-post
+    FacebookPost = OEmbed::Provider.new(
+      "https://graph.facebook.com/v8.0/oembed_post",
+      required_query_params: { access_token: 'OEMBED_FACEBOOK_TOKEN' },
+      format: :json
+    )
+    FacebookPost << 'https://www.facebook.com/*/posts/*'
+    FacebookPost << 'https://www.facebook.com/*/activity/*'
+    FacebookPost << 'https://www.facebook.com/photo*'
+    FacebookPost << 'https://www.facebook.com/*/photo*'
+    FacebookPost << 'https://www.facebook.com/media*'
+    FacebookPost << 'https://www.facebook.com/questions*'
+    FacebookPost << 'https://www.facebook.com/notes*'
 
-      private
+    # Note: even though FacebookPost is automatically registered as an official provider
+    # it will NOT resolve any URLs unless its access_token is set
+    # either via the OEMBED_FACEBOOK_TOKEN environment variable
+    # or by calling `OEmbed::Providers::FacebookPost.access_token = @your_token`
+    add_official_provider(FacebookPost, nil, access_token: {name: :facebook, method: :access_token})
 
-      def register_urls!
-        ['https://www.facebook.com/*/posts/*',
-         'https://www.facebook.com/*/activity/*',
-         'https://www.facebook.com/photo*',
-         'https://www.facebook.com/photos*',
-         'https://www.facebook.com/*/photos*',
-         'https://www.facebook.com/permalink*',
-         'https://www.facebook.com/media*',
-         'https://www.facebook.com/questions*',
-         'https://www.facebook.com/notes*'].each { |u| self << u }
-      end
+    # Respond to the `new` method to maintain backwards compatibility with v0.14.0
+    # See also:
+    # * https://github.com/ruby-oembed/ruby-oembed/pull/75
+    # * https://github.com/ruby-oembed/ruby-oembed/issues/77#issuecomment-727024682
+    # @deprecated *Note*: This method will be be removed in the future.
+    def FacebookPost.new(access_token:)
+      self.access_token = access_token
+      self
     end
   end
 end

data/lib/oembed/providers/facebook_video.rb

@@ -1,18 +1,30 @@
 module OEmbed
   class Providers
     # Provider for Facebook videos
-    class FacebookVideo < OEmbed::Provider
-      def initialize(access_token:)
-        super("https://graph.facebook.com/v8.0/oembed_video?access_token=#{access_token}", :json)
-        register_urls!
-      end
+    # See https://developers.facebook.com/docs/plugins/oembed
+    # See https://developers.facebook.com/docs/graph-api/reference/v8.0/oembed-video
+    FacebookVideo = OEmbed::Provider.new(
+      "https://graph.facebook.com/v8.0/oembed_video",
+      required_query_params: { access_token: 'OEMBED_FACEBOOK_TOKEN' },
+      format: :json
+    )
+    FacebookVideo << 'https://www.facebook.com/*/videos/*'
+    FacebookVideo << 'https://www.facebook.com/video*'
 
-      private
+    # Note: even though FacebookVideo is automatically registered as an official provider
+    # it will NOT resolve any URLs unless its access_token is set
+    # either via the OEMBED_FACEBOOK_TOKEN environment variable
+    # or by calling `OEmbed::Providers::FacebookVideo.access_token = @your_token`
+    add_official_provider(FacebookVideo, nil, access_token: {name: :facebook, method: :access_token})
 
-      def register_urls!
-        ['https://www.facebook.com/*/videos/*',
-         'https://www.facebook.com/video*'].each { |u| self << u }
-      end
+    # Respond to the `new` method to maintain backwards compatibility with v0.14.0
+    # See also:
+    # * https://github.com/ruby-oembed/ruby-oembed/pull/75
+    # * https://github.com/ruby-oembed/ruby-oembed/issues/77#issuecomment-727024682
+    # @deprecated *Note*: This method will be be removed in the future.
+    def FacebookVideo.new(access_token:)
+      self.access_token = access_token
+      self
     end
   end
 end