earl 1.0.0 → 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bfb59215c79763794ebf311cff3e939a0be46e4557abf8bbd8c358693b12e1ee
+  data.tar.gz: 550ea900108a04f4d12935bcd7fa398b95c886f59847c2492a7d90b96495f042
+SHA512:
+  metadata.gz: 16102c9eee3ff031411da1aacd80371a7474ea3ff5b70dad9a77ad83efe63a943db7b845e8b461a4c44de7685e8933c903a2c2511c41df00f69759cd06ece54c
+  data.tar.gz: 3b724772932a18d2de4f589959c28968fa9cc93cf158bca8ac4360166ae3b04877e8bb6dc09338329da94fbbccee4891819598f1e0a4a642d858d13362f9219f

data/.github/workflows/ruby-tests.yml

@@ -0,0 +1,32 @@
+name: Ruby Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.3
+        bundler-cache: true
+
+    - name: Install dependencies
+      run: bundle install
+
+    - name: Run tests
+      run: bundle exec rspec
+
+    - name: Run rubocop
+      run: bundle exec rubocop

data/.gitignore

@@ -1,6 +1,22 @@
-*.sw?
-.DS_Store
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
 coverage
-rdoc
+doc/
+lib/bundler/man
 pkg
-.rvmrc
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rubocop.yml

@@ -0,0 +1,35 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  NewCops: disable
+  SuggestExtensions: false
+  TargetRubyVersion: 3.0
+
+Layout/LineLength:
+  Max: 199
+
+Metrics/BlockLength:
+  Max: 63
+
+Metrics/ClassLength:
+  Max: 200
+
+Metrics/CyclomaticComplexity:
+  Max: 8
+
+Metrics/MethodLength:
+  Max: 20
+
+Style/ClassVars:
+  Exclude:
+    - 'lib/earl/scraper.rb'
+
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+
+Style/ClassAndModuleChildren:
+  EnforcedStyleForClasses: compact
+
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent

data/.rubocop_todo.yml

@@ -0,0 +1,22 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2025-07-29 10:15:32 UTC using RuboCop version 1.79.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 7
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: AllowSafeAssignment.
+Lint/AssignmentInCondition:
+  Exclude:
+    - 'lib/earl/earl.rb'
+    - 'lib/earl/scraper.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods.
+# AllowedMethods: enums
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - 'spec/unit/earl/scraper_spec.rb'

data/.ruby-gemset

@@ -0,0 +1 @@
+earl

data/.ruby-version

@@ -0,0 +1 @@
+3.3.3

data/Gemfile

@@ -1,4 +1,16 @@
-source :rubygems
+# frozen_string_literal: true
 
-# Specify your gem's dependencies in earl.gemspec
-gemspec
+source 'https://rubygems.org'
+
+# Specify gem dependencies in earl.gemspec
+gemspec
+
+# development dependencies
+gem 'bundler', '>= 2.2.33'
+gem 'guard-rspec'
+gem 'guard-rubocop'
+gem 'rake'
+gem 'rspec'
+gem 'rubocop', require: false
+gem 'vcr'
+gem 'webmock'

data/Guardfile

@@ -1,10 +1,15 @@
+# frozen_string_literal: true
+
 # A sample Guardfile
 # More info at https://github.com/guard/guard#readme
 
-guard 'rspec', :version => 2, :all_on_start => false, :all_after_pass => false do
+guard :rspec, cmd: 'bundle exec rspec' do
   watch(%r{^spec/.+_spec\.rb$})
-  watch('spec/spec_helper.rb')  { "spec" }
-  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/unit/#{m[1]}_spec.rb" }
-
+  watch('spec/spec_helper.rb') { 'spec' }
+  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
 end
 
+guard :rubocop, cli: ['--display-cop-names'] do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop(?:_todo)?\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE

@@ -1,4 +1,6 @@
-Copyright (c) 2009 T.J. VanSlyke
+Copyright (c) 2009 T.J. VanSlyke, 2012-2025 Paul Gallagher
+
+MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/{README.rdoc → README.md}

@@ -1,20 +1,20 @@
-= Earl {<img src="https://secure.travis-ci.org/evendis/earl.png" />}[http://travis-ci.org/evendis/earl]
+# Earl
 
 Earl wants to help you scrape all the relevant metadata for your favorite web pages so you can be as cool as
 Facebook when displaying user-submitted link content. Earl returns details like titles, descriptions, content type,
 associated feeds, and OEmbed definitions if available.
 
-Earl is based on an original source project called _earl_ by {teejayvanslyke}[https://github.com/teejayvanslyke/earl] (but never released as a gem).
-The revamp was done by {Paul Gallagher}[https://github.com/tardate], and master source is currently
-available at https://github.com/evendis/earl.
+Earl is based on an original source project called _earl_ by [teejayvanslyke](https://github.com/teejayvanslyke/earl) (but never released as a gem).
+The revamp was done by [Paul Gallagher](https://github.com/tardate), and master source is currently
+available at <https://github.com/evendis/earl>.
 
-The Earl gem is officially named _earl_. Big thanks go to {jeremyruppel}[https://github.com/jeremyruppel] who
+The Earl gem is officially named _earl_. Big thanks go to [jeremyruppel](https://github.com/jeremyruppel) who
 contributed the ownership of the _earl_ gem name. The original _earl_ gem had a somewhat similar purpose - it is now defunct, but still available up to version 0.3.0 via rubgems. Any _earl_ gem with version 1.0.0 or higher is the new gem release (and is in no way backwardly compatible with
 earlier versions).
 
-== The Earl Cookbook
+## The Earl Cookbook
 
-=== How do instantiate Earl?
+### How do instantiate Earl?
 
 Pass any url-like string to Earl:
 
@@ -23,8 +23,7 @@ Pass any url-like string to Earl:
     # or using the []= convenience method:
     my_earl_instance = Earl['https://github.com/evendis/earl']
 
-
-=== How do I inspect details of the page?
+### How do I inspect details of the page?
 
     earl = Earl['https://github.com/evendis/earl']
     earl.title
@@ -34,31 +33,39 @@ Pass any url-like string to Earl:
     earl.image
     => "https://a248.e.akamai.net/assets.github.com/images/modules/header/logov7@4x.png?1340935010"
 
-=== How do I get oembed details for a link?
+### How do I get oembed details for a link?
 
 Earl will get oembed details for a link if they are available.
 
-    earl = Earl['http://www.youtube.com/watch?v=g3DCEcSlfhw']
+    earl = Earl['https://www.youtube.com/watch?v=hNSkCqMUMQA']
     earl.oembed
-    => {"provider_url"=>"http://www.youtube.com/", "thumbnail_url"=>"http://i4.ytimg.com/vi/g3DCEcSlfhw/hqdefault.jpg", "title"=>"'Virtuosos of Guitar 2008' festival, Moscow. Marcin Dylla", "html"=>"<iframe width=\"420\" height=\"315\" src=\"http://www.youtube.com/embed/g3DCEcSlfhw?fs=1&feature=oembed\" frameborder=\"0\" allowfullscreen></iframe>", "author_name"=>"guitarmagnet", "height"=>315, "thumbnail_width"=>480, "width"=>420, "version"=>"1.0", "author_url"=>"http://www.youtube.com/user/guitarmagnet", "provider_name"=>"YouTube", "type"=>"video", "thumbnail_height"=>360}
+    => {:title=>"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi",
+        :author_name=>"RubyKaigi",
+        :author_url=>"https://www.youtube.com/@rubykaigi4884",
+        :type=>"video",
+        :height=>113,
+        :width=>200,
+        :version=>"1.0",
+        :provider_name=>"YouTube",
+        :provider_url=>"https://www.youtube.com/",
+        :thumbnail_height=>360,
+        :thumbnail_width=>480,
+        :thumbnail_url=>"https://i.ytimg.com/vi/hNSkCqMUMQA/hqdefault.jpg",
+        :html=>
+        "<iframe width=\"200\" height=\"113\" src=\"https://www.youtube.com/embed/hNSkCqMUMQA?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen title=\"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi\"></iframe>"}
     # to get the embed code:
     earl.oembed_html
-    => "<iframe width=\"420\" height=\"315\" src=\"http://www.youtube.com/embed/g3DCEcSlfhw?fs=1&feature=oembed\" frameborder=\"0\" allowfullscreen></iframe>"
+    => "<iframe width=\"200\" height=\"113\" src=\"https://www.youtube.com/embed/hNSkCqMUMQA?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen title=\"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi\"></iframe>"
 
-=== How do I customise the oembed link?
+### How do I customise the oembed link?
 
 Supported oembed parameters may be provided with to `Earl.new` or to the `oembed` call:
 
-    earl = Earl.new('http://www.youtube.com/watch?v=g3DCEcSlfhw', {:oembed => {:maxwidth => "200", :maxheight => "320"}})
-    earl.oembed_html
-    => <iframe width="200" height="150" src="http://www.youtube.com/embed/g3DCEcSlfhw?fs=1&feature=oembed" frameborder="0" allowfullscreen></iframe>
-    earl = Earl.new('http://www.youtube.com/watch?v=g3DCEcSlfhw')
-    earl.oembed({:maxwidth => "100", :maxheight => "120"})
+    earl = Earl.new('https://www.youtube.com/watch?v=hNSkCqMUMQA', { oembed: { maxwidth: '200', maxheight: '320' }})
     earl.oembed_html
-    => <iframe width="100" height="75" src="http://www.youtube.com/embed/g3DCEcSlfhw?fs=1&feature=oembed" frameborder="0" allowfullscreen></iframe>
-
+    => "<iframe width=\"200\" height=\"113\" src=\"https://www.youtube.com/embed/hNSkCqMUMQA?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen title=\"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi\"></iframe>"
 
-=== How do I inspect what attributes are available for a page?
+### How do I inspect what attributes are available for a page?
 
 To see all of the attributes a URL provides, simply ask:
 
@@ -66,8 +73,7 @@ To see all of the attributes a URL provides, simply ask:
     earl.attributes
     => [:title, :image, :description, :rss_feed, :atom_feed, :content_type, :base_url, :charset, :content_encoding, :headers, :feed]
 
-
-=== How can I extend Earl to scrape additional page details?
+### How can I extend Earl to scrape additional page details?
 
 Need to scrape additional page details currently supported by Earl?  Implement your own scraper:
 
@@ -87,24 +93,23 @@ Your new attribute is now available for use:
     Earl['http://www.quotationspage.com/qotd.html'].qotd
     => "Love is a snowmobile racing across the tundra and then suddenly it flips over, pinning you underneath. At night, the ice weasels come."
 
-
-=== How do I install it for normal use?
+### How do I install it for normal use?
 
 If using bundler, add gem 'earl' your application's Gemfile and run `bundle`.
 
 Or install it from the command-line:
 
-    $ gem install earl
+    gem install earl
 
-=== How do I install it for gem development?
+### How do I install it for gem development?
 
 To work on enhancements of fix bugs in Earl, fork and clone the github repository.
-If you are using bundler (recommended), run <tt>bundle</tt> to install development dependencies:
+If you are using bundler (recommended), run `bundle` to install development dependencies:
 
-    $ gem install bundler
-    $ bundle
+    gem install bundler
+    bundle
 
-=== How do I run the tests?
+### How do I run the tests?
 
 Once development dependencies are installed, all unit tests are run with just:
 
@@ -112,25 +117,18 @@ Once development dependencies are installed, all unit tests are run with just:
     # or..
     $ rake spec
 
-Unit tests exclude a set of integration tests that actually hit the network (therefore not 'nice' to run all the time,
-and also subject to failures due to network availability or changes in the services accessed). To run integration tests:
-
-    $ rake spec:integration
-
-To run all tests (unit and integration):
-
-    $ rake spec:all
-
+VCR is used to record integration tests. To re-record sessions, delete the corresponding cassette in
+[spec/fixtures/cassettes](./spec/fixtures/cassettes/).
 
-=== How do I automatically run tests when I modify files?
+### How do I automatically run tests when I modify files?
 
 Guard is installed as part of the development dependencies. Start a guard process in a terminal window:
 
-    $ bundle exec guard
+    bundle exec guard
 
 It will run all the tests to start with by default. Then whenever you change a file, the associated tests will execute in this terminal window.
 
-== Contributing to Earl
+## Contributing to Earl
 
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
@@ -140,6 +138,6 @@ It will run all the tests to start with by default. Then whenever you change a f
 * Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
 * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 
-== Copyright
+## Copyright
 
-See LICENSE for details.
+See [LICENSE](./LICENSE) for details.

data/Rakefile

@@ -1,38 +1,13 @@
-#!/usr/bin/env rake
-require "bundler/gem_tasks"
+# frozen_string_literal: true
 
-require 'rspec'
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
-desc "Run only unit test examples"
-RSpec::Core::RakeTask.new do |t|
-  t.rspec_opts = ["-c", "-f progress"]
-  t.pattern = 'spec/unit/**/*_spec.rb'
-end
-
-desc "Run only integration test examples"
-RSpec::Core::RakeTask.new(:'spec:integration') do |t|
-  t.rspec_opts = ["-c", "-f progress"]
-  t.pattern = 'spec/integration/**/*_spec.rb'
-end
-
-desc "Run all test examples including integration tests"
-RSpec::Core::RakeTask.new(:'spec:all') do |t|
-  t.rspec_opts = ["-c", "-f progress"]
-  t.pattern = 'spec/**/*_spec.rb'
-end
-
-task :default => :spec
+RSpec::Core::RakeTask.new(:spec)
 
-require 'rdoc/task'
-RDoc::Task.new do |rdoc|
-  rdoc.main = "README.rdoc"
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "earl"
-  rdoc.rdoc_files.include('README*', 'lib/**/*.rb')
-end
+task default: :spec
 
-desc "Open an irb session preloaded with this library"
+desc 'Open an irb session preloaded with this library'
 task :console do
-  sh "irb -rubygems -I lib -r earl.rb"
-end
+  sh 'irb -I lib -r earl.rb'
+end

data/earl.gemspec

@@ -1,27 +1,26 @@
-# -*- encoding: utf-8 -*-
-require File.expand_path('../lib/earl/version', __FILE__)
+# frozen_string_literal: true
+
+require 'English'
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'earl/version'
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["teejayvanslyke", "Paul Gallagher"]
-  gem.email         = ["tj@elctech.com", "gallagher.paul@gmail.com"]
-  gem.description   = %q{URL metadata API}
-  gem.summary       = %q{URL metadata API for scraping titles, descriptions, images, and videos from URL's}
-  gem.homepage      = "https://github.com/evendis/earl"
+  gem.authors       = ['teejayvanslyke', 'Paul Gallagher']
+  gem.email         = ['tj@elctech.com', 'gallagher.paul@gmail.com']
+  gem.description   = 'URL metadata API'
+  gem.summary       = 'URL metadata API for scraping titles, descriptions, images, and videos from URLs'
+  gem.homepage      = 'https://github.com/evendis/earl'
 
-  gem.files         = `git ls-files`.split($\)
-  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split($OUTPUT_RECORD_SEPARATOR)
+  gem.executables   = gem.files.grep(%r{^bin/}).map { |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
-  gem.name          = "earl"
-  gem.require_paths = ["lib"]
+  gem.name          = 'earl'
+  gem.require_paths = ['lib']
   gem.version       = Earl::VERSION
+  gem.license       = 'MIT'
 
-  gem.add_runtime_dependency(%q<nokogiri>, [">= 1.4.4"])
-  gem.add_runtime_dependency(%q<oembedr>, [">= 1.0.0"])
-  gem.add_development_dependency(%q<bundler>, ["> 1.1.0"])
-  gem.add_development_dependency(%q<rake>, ["~> 0.9.2.2"])
-  gem.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
-  gem.add_development_dependency(%q<rdoc>, ["~> 3.11"])
-  gem.add_development_dependency(%q<guard-rspec>, ["~> 1.2.0"])
-  gem.add_development_dependency(%q<rb-fsevent>, ["~> 0.9.1"])
-
+  gem.required_ruby_version = '>= 3.0'
+  gem.add_runtime_dependency 'nokogiri', '~> 1.18'
+  gem.add_runtime_dependency 'ruby-oembed', '~> 0.18.1'
 end

data/lib/earl/earl.rb

@@ -1,11 +1,11 @@
-require 'open-uri'
-require 'oembedr'
+# frozen_string_literal: true
 
+# Earl is a class that represents a URL and provides methods to fetch metadata about the page
 class Earl
+  attr_accessor :url, :options
+  attr_writer :oembed
 
-  attr_accessor :url, :options, :oembed
-
-  def initialize(url, options={})
+  def initialize(url, options = {})
     @url = url
     @options = options
   end
@@ -19,7 +19,7 @@ class Earl
   end
 
   def uri_response
-    @uri_response ||= open(uri)
+    @uri_response ||= uri.open
   end
 
   # Returns
@@ -36,22 +36,22 @@ class Earl
     when :headers
       uri_response_attribute(:meta)
     else
-      uri_response && uri_response.respond_to?(name) && uri_response.send(name)
+      uri_response.respond_to?(name) && uri_response.send(name)
     end
   end
   protected :uri_response_attribute
 
   def uri_response_attributes
-    [:content_type,:base_url,:charset,:content_encoding,:headers]
+    %i[content_type base_url charset content_encoding headers]
   end
   protected :uri_response_attributes
 
   def scraper
-    @scraper ||= Scraper.for(url,self)
+    @scraper ||= Scraper.for(url, self)
   end
 
   def response
-    scraper && scraper.response
+    scraper&.response
   end
 
   # Returns a hash of link meta data, including:
@@ -60,23 +60,28 @@ class Earl
   def metadata
     data = oembed || {}
     attributes.each do |attribute|
-      if attribute_value = self.send(attribute)
+      if attribute_value = send(attribute)
         data[attribute] ||= attribute_value
       end
     end
     data
   end
 
+  def respond_to_missing?(name, include_private)
+    uri_response_attributes.include?(name) || scraper&.attribute?(name) || super
+  end
+
   # Dispatch missing methods if a match for:
   # - uri_response_attributes
   # - scraper attributes
   def method_missing(method, *args)
     if uri_response_attributes.include?(method)
-      return uri_response_attribute(method)
-    elsif scraper && scraper.has_attribute?(method)
-      return scraper.attribute(method)
+      uri_response_attribute(method)
+    elsif scraper&.attribute?(method)
+      scraper.attribute(method)
+    else
+      super
     end
-    super
   end
 
   # Returns a full array of attributes available for the link
@@ -86,52 +91,66 @@ class Earl
 
   # Returns the options to be used for oembed
   def oembed_options
-    { :maxwidth => "560", :maxheight => "315" }.merge(options[:oembed]||{})
-  end
-
-  # Returns the oembed meta data hash for the URL (or nil if not defined/available) e.g.
-  # For http://www.youtube.com/watch?v=g3DCEcSlfhw:
-  #   {
-  #     "provider_url"=>"http://www.youtube.com/",
-  #     "thumbnail_url"=>"http://i4.ytimg.com/vi/g3DCEcSlfhw/hqdefault.jpg",
-  #     "title"=>"'Virtuosos of Guitar 2008' festival, Moscow. Marcin Dylla",
-  #     "html"=>"<iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/g3DCEcSlfhw?fs=1&feature=oembed\" frameborder=\"0\" allowfullscreen></iframe>",
-  #     "author_name"=>"guitarmagnet",
-  #     "height"=>344,
-  #     "thumbnail_width"=>480,
-  #     "width"=>459,
-  #     "version"=>"1.0",
-  #     "author_url"=>"http://www.youtube.com/user/guitarmagnet",
-  #     "provider_name"=>"YouTube",
-  #     "type"=>"video",
-  #     "thumbnail_height"=>360
-  #   }
+    { maxwidth: '560', maxheight: '315' }.merge(options[:oembed] || {})
+  end
+
+  # Returns the oembed meta data hash for the URL (or nil if not defined/available)
+  # e.g. for https://www.youtube.com/watch?v=hNSkCqMUMQA:
+  # {
+  #   :title=>"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi",
+  #   :author_name=>"RubyKaigi",
+  #   :author_url=>"https://www.youtube.com/@rubykaigi4884",
+  #   :type=>"video",
+  #   :height=>113,
+  #   :width=>200,
+  #   :version=>"1.0",
+  #   :provider_name=>"YouTube",
+  #   :provider_url=>"https://www.youtube.com/",
+  #   :thumbnail_height=>360,
+  #   :thumbnail_width=>480,
+  #   :thumbnail_url=>"https://i.ytimg.com/vi/hNSkCqMUMQA/hqdefault.jpg",
+  #   :html=> "<iframe width=\"200\" height=\"113\" src=\"https://www.youtube.com/embed/hNSkCqMUMQA?feature=oembed\" \
+  #     frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" \
+  #     referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen \
+  #     title=\"[JA][Keynote] Ruby Taught Me About Encoding Under the Hood / Mari Imaizumi @ima1zumi\"></iframe>"
+  # }
   #
   # +options+ defines a custom oembed options hash and will cause a re-fetch of the oembed metadata
-  def oembed(options=nil)
+  def oembed(options = nil)
     if options # use custom options, refetch oembed metadata
       @options[:oembed] = options
       @oembed = nil
     end
-    begin
-      @oembed ||= if h = Oembedr.fetch(base_url, :params => oembed_options).body
+    @oembed ||= begin
+      h = fetch_oembed(base_url).fields
+      if h
         h.keys.each do |key| # symbolize_keys!
-          h[(key.to_sym rescue key) || key] = h.delete(key)
+          new_key = begin
+            key.to_sym
+          rescue StandardError
+            key
+          end
+          h[new_key] = h.delete(key)
         end
         h
       end
-    rescue
+    rescue StandardError
+      nil
     end
-    @oembed
   end
 
+  def fetch_oembed(base_url)
+    OEmbed::Providers.get(base_url)
+  end
+  protected :fetch_oembed
+
   # Returns the oembed code for the url (or nil if not defined/available)
   def oembed_html
     oembed && oembed[:html]
   end
 
   # Returns true if there is an ATOM or RSS feed associated with this URL.
-  def has_feed?
+  def feed?
     !feed.nil?
   end
 
@@ -147,12 +166,7 @@ class Earl
     end
   end
 
-  class << self
-
-    def [](url)
-      new(url)
-    end
-
+  def self.[](url)
+    new(url)
   end
-
 end