votd 3.0.2 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d29237ca3f2e6078e0bfea778aabe4881b69fe4c71626faa4bf6faa845d68077
-  data.tar.gz: 62bb616cc7ac61f2a7dff356b564fe5922c8b0c595631bc9df0365bb583860e5
+  metadata.gz: 33707db5963490790f5e1eaf429834d53f7658ee179844f2ca46f47bfa62e4e1
+  data.tar.gz: 0be40cbe72ae2e360d50667ea336ce85ecf051725ac16251cbe9ac111ec32f73
 SHA512:
-  metadata.gz: 18ba480318c6d9e04ae7aa4f83641a6f8c28cf2e4621779f4bf049c5e1fb6027a155240dad3073e454870c604d6acbdd98b5b065a98e21fc4e28b84ecc2c493c
-  data.tar.gz: 2fecf83462199f131a1d521a865e51b93717084c05ddee5a3d2b3b764df3262d7cb22f66a87e452c1a2948d63bb6a1ce787cf39a4da7aa769a281cd1efb8cdda
+  metadata.gz: 5072c11ffa7c8cfa42d798d132912f84412f534557e28681c5a22573543b2a4e2533b09121f5d48c92c245ab128b208aa91e46bc5662f96f8173bf9c7ebc9ac8
+  data.tar.gz: 9b0320cd4b8baea0f6670922ccec324b028d587cb90a355d62def18d4e52262ebb39f84f1a5f17810ba2b731e588bffca502db8631d5f0175f0d6667cbc0079c

data/CHANGELOG.md

@@ -1,6 +1,27 @@
 Changelog
 =========
 
+4.0.0
+-----
+*March 4, 2026*
+
+* Upgrade Ruby from 2.6.5 (EOL) to 3.4.8; require >= 3.3
+* Fix BibleGateway and NetBible API endpoints (http → https)
+* Add `Votd::OurManna` provider — free, no-auth JSON API from ourmanna.com (NIV)
+* **Breaking:** Replace stub CLI with Thor-based CLI. The `votd` command now
+  requires a subcommand: `votd verse` (with `--provider`, `--translation`,
+  `--format` options), `votd version`, `votd help`.
+* Deprecate `Votd::ESVBible` — the gnpcb.org endpoint has been shut down.
+  `ESVBible.new` now raises `Votd::VotdError` with a message directing users
+  to `Votd::BibleGateway.new(:esv)` as a replacement.
+* **Breaking:** Providers now raise `Votd::FetchError` on any failure instead
+  of silently falling back to defaults. Original exception preserved as `#cause`.
+* Add `Votd.logger` and `Votd.on_error` callback for error observability
+* Add YARD documentation to all public classes and methods
+* Modernize gemspec: explicit file list, bounded dependencies, RubyGems metadata
+* Move gem executable from `bin/` to `exe/` (Bundler convention)
+* Add GitHub Actions CI and release workflows with OIDC trusted publishing
+
 3.0.1
 -----
 *November 27, 2019*

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012-2014 Christopher Clarke, Stephen Clarke
+Copyright (c) 2012-2026 Stephen Clarke
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,7 +1,6 @@
 # VotD - (Bible) Verse of the Day
 
-[![Build Status](https://secure.travis-ci.org/doctorbh/votd.png?branch=master)](http://travis-ci.org/Sevenview/votd)
-[![Code Climate](https://codeclimate.com/github/sevenview/votd.png)](https://codeclimate.com/github/sevenview/votd)
+[![Ruby](https://github.com/sevenview/votd/actions/workflows/ruby.yml/badge.svg)](https://github.com/sevenview/votd/actions/workflows/ruby.yml)
 
 VotD (Verse of the Day) is a Ruby Gem that wraps various web services that generate
 daily Bible Verses.
@@ -9,9 +8,9 @@ daily Bible Verses.
 
 Currently the gem supports three VotD web services:
 
-* [Bible Gateway](http://www.biblegateway.com) - Multiple Translations
-* [Bible.org](http://labs.bible.org) - NETBible Translation
-* [ESV Bible Web Service](http://www.esvapi.org/) - ESV Translation
+* [Bible Gateway](https://www.biblegateway.com) - Multiple Translations
+* [Bible.org](https://labs.bible.org) - NETBible Translation
+* [Our Manna](https://ourmanna.com) - NIV Translation
 
 If you are able to contribute modules for any of these, please see our [CONTRIBUTING](https://github.com/Sevenview/votd/blob/master/CONTRIBUTING.md) file. Let us know before you begin work in case someone else has a module in-progress.
 
@@ -99,16 +98,19 @@ the day:
     votd = Votd::NetBible.new
 ```
 
-## Votd::ESVBible
+## Votd::OurManna
 
-To use the ESV Bible Web Service, which generates a English Standard Version 
-verse of the day:
+To use the Our Manna service, which generates an NIV verse of the day:
 
 ```ruby
     require 'votd'
-    votd = Votd::BibleGateway.new
+    votd = Votd::OurManna.new
 ```
 
+## Votd::ESVBible
+
+`Votd::ESVBible` is no longer supported — the upstream endpoint has been shut down. Use `Votd::BibleGateway.new(:esv)` instead.
+
 ### Outputting HTML
 
 You can use the built-in formatted HTML:
@@ -163,7 +165,17 @@ This returns the custom formatted text, or you can call the `.to_text` method
 when ready, and your custom text will be output.
 
 ## Command Line
-For command-line usage see [here](https://github.com/Sevenview/votd/wiki/Shell-Tool)
+
+```bash
+votd verse                              # BibleGateway NIV (default)
+votd verse -p netbible                  # NetBible provider
+votd verse -p ourmanna                  # OurManna provider
+votd verse --translation kjv            # BibleGateway with KJV
+votd verse -f html                      # HTML output
+votd verse -f json                      # JSON output
+votd verse --help                       # Show options
+votd version                            # Show gem version
+```
 
 ## Documentation
 
@@ -196,16 +208,6 @@ See our [CHANGELOG](https://github.com/Sevenview/votd/blob/master/CHANGELOG.md)
 
 See our [TODO](https://github.com/Sevenview/votd/blob/master/TODO.md) file.
 
-## Authors
-
-Christopher Clarke <chris@seven7.ca>
-
-Stephen Clarke <steve@sevenview.ca>
-
-[Sebastian Hirsch](https://github.com/SebastianHirsch) (ESV)
-
-## Copyright
-
-(The MIT License)
+## License
 
-&copy; 2012-2019 Christopher Clarke, Stephen Clarke. See [LICENSE](https://github.com/Sevenview/votd/blob/master/LICENSE) for details.
+MIT — see [LICENSE](https://github.com/Sevenview/votd/blob/master/LICENSE) for details.

data/exe/votd

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "votd"
+require "votd/cli"
+
+Votd::CLI.start(ARGV)

data/lib/votd/base.rb

@@ -1,10 +1,10 @@
-require 'votd/helper/text'
+# frozen_string_literal: true
 
 module Votd
   # This is the base class that all Votd lookup modules inherit from.
-  # It provides default values for the Votd in the event of lookup failure.
   # Child classes should override the {#get_votd} method to implement their
-  # specific lookup function.
+  # specific lookup function. Errors during fetch are raised as {FetchError}
+  # and reported via {Votd.logger} and {Votd.on_error}.
   class Base
     # @example
     #   votd.text  # "For by grace you are saved through faith..."
@@ -62,18 +62,15 @@ module Votd
     # is provided
     DEFAULT_BIBLE_VERSION_NAME = "King James Version"
 
+    # The default link to use if none is provided by the VotD service
     DEFAULT_LINK = "https://www.biblegateway.com/passage/?search=John+3%3A16&version=KJV"
 
     # Initializes the class and retrieves the verse of the day.
     # @return [Base]
     def initialize
-      @text        = ""
-      @reference   = ""
-      @copyright   = nil
-      @date        = Date.today
+      @date = Date.today
       @custom_html = nil
       @custom_text = nil
-      @link        = nil
       get_votd
     end
 
@@ -90,11 +87,14 @@ module Votd
     #
     # @return [String] the VotD formatted as HTML
     def to_html
-      default_html =  "<p class=\"votd-text\">#{@text}</p>\n"
-      default_html << "<p>\n"
-      default_html << "<span class=\"votd-reference\"><strong>#{@reference}</strong></span>\n"
-      default_html << "<span class=\"votd-version\"><em>(#{@version})</em></span>\n"
-      default_html << "</p>\n"
+      default_html = [
+        %(<p class="votd-text">#{@text}</p>),
+        "<p>",
+        %(<span class="votd-reference"><strong>#{@reference}</strong></span>),
+        %(<span class="votd-version"><em>(#{@version})</em></span>),
+        "</p>",
+        ""
+      ].join("\n")
       @custom_html ||= default_html
     end
 
@@ -114,7 +114,7 @@ module Votd
     # @yield [votd] the VotD itself
     # @yieldparam [Base] votd the VotD itself
     # @yieldreturn [String] the VotD formatted as custom HTML
-    # @raise {VotdError} when called without block format
+    # @raise [VotdError] when called without block format
     def custom_html
       if block_given?
         @custom_html = yield(self)
@@ -149,7 +149,7 @@ module Votd
     # @yield [votd] the VotD itself
     # @yieldparam [Base] votd the VotD itself
     # @yieldreturn [String] the VotD formatted as custom text
-    # @raise {VotdError} when called without block format
+    # @raise [VotdError] when called without block format
     def custom_text
       if block_given?
         @custom_text = yield(self)
@@ -158,22 +158,37 @@ module Votd
       end
     end
 
-    protected
+    private
+
     # Gets the VotD. For {Votd::Base} this will return default values and can be
     # used in the event of an exception thrown when getting data from live web
-    # services in subclasses of {Votd::Base}
+    # services in subclasses of {Votd::Base}.
+    # Subclasses override this to fetch from their respective APIs.
+    # @return [void]
     def get_votd
       set_defaults
     end
 
+    # Sets all attributes to their default values.
+    # @return [void]
     def set_defaults
-      @text         = DEFAULT_BIBLE_TEXT
-      @reference    = DEFAULT_BIBLE_REFERENCE
-      @version      = DEFAULT_BIBLE_VERSION
+      @text = DEFAULT_BIBLE_TEXT
+      @reference = DEFAULT_BIBLE_REFERENCE
+      @version = DEFAULT_BIBLE_VERSION
       @version_name = DEFAULT_BIBLE_VERSION_NAME
-      @link         = DEFAULT_LINK
-      @copyright    = nil
+      @link = DEFAULT_LINK
+      @copyright = nil
     end
 
+    # Logs the error, invokes the on_error callback, and raises a FetchError.
+    # @param error [Exception] the original exception
+    # @param message [String] a human-readable description of the failure
+    # @raise [FetchError]
+    def report_and_raise(error, message)
+      wrapped = FetchError.new("#{message}: #{error.message}")
+      Votd.logger&.error("#{self.class.name} - #{error.class}: #{error.message}")
+      Votd.on_error_callback&.call(self.class, wrapped)
+      raise wrapped
+    end
   end
 end

data/lib/votd/bible_gateway.rb

@@ -1,52 +1,62 @@
-require 'feedjira'
-require 'votd/helper/text'
+# frozen_string_literal: true
+
+require "feedjira"
 
 module Votd
   # Retrieves a Verse of the Day from biblegateway.com using a variety
   # of translations.
   #
-  # Default translation is NIV (New International Version)
+  # Default translation is NIV (New International Version).
   #
-  # docs: http://www.biblegateway.com/usage/votd/docs/
+  # @example Fetch the default (NIV) verse of the day
+  #   votd = Votd::BibleGateway.new
+  #   votd.text       # => "For God so loved the world..."
+  #   votd.reference  # => "John 3:16"
   #
-  # version list: http://www.biblegateway.com/usage/linking/versionslist.php
-
+  # @example Fetch the KJV verse of the day
+  #   votd = Votd::BibleGateway.new(:kjv)
+  #
+  # @see https://www.biblegateway.com/usage/votd/docs/ BibleGateway VotD docs
+  # @see https://www.biblegateway.com/usage/linking/versionslist.php Version list
   class BibleGateway < Votd::Base
-  # These are the English translations that are copyright-approved for Bible
-  # Gateway VotD as of November 2019.
-  BIBLE_VERSIONS = {
-      amp:      { name: 'Amplified Bible',                     id: 45 },
-      asv:      { name: 'American Standard Version',           id: 8 },
-      ceb:      { name: 'Common English Bible',                id: 105 },
-      darby:    { name: 'Darby Translation',                   id: 16 },
-      esv:      { name: 'English Standard Version',            id: 47 },
-      esvu:     { name: 'English Standard Version Anglicised', id: 166 },
-      gw:       { name: "God's Word Translation",              id: 158 },
-      hcsb:     { name: 'Holman Christian Standard Bible',     id: 77 },
-      kjv:      { name: 'King James Version',                  id: 9 },
-      leb:      { name: 'Lexham English Bible',                id: 165 },
-      nasb:     { name: 'New American Standard Bible',         id: 49 },
-      nirv:     { name: "New International Reader's Version",  id: 76 },
-      niv:      { name: 'New International Version',           id: 31 },
-      nivuk:    { name: 'New International Version - UK',      id: 64 },
-      nlt:      { name: 'New Living Translation',              id: 51 },
-      nlv:      { name: 'New Life Version',                    id: 74 },
-      phillips: { name: 'J.B. Phillips New Testament',         id: 164 },
-      we:       { name: 'Worldwide English (New Testament)',   id: 73 },
-      wyc:      { name: 'Wycliffe Bible',                      id: 53 },
-      ylt:      { name: "Young's Literal Translation",         id: 15 }
+    # These are the English translations that are copyright-approved for Bible
+    # Gateway VotD as of November 2019.
+    BIBLE_VERSIONS = {
+      amp: {name: "Amplified Bible", id: 45},
+      asv: {name: "American Standard Version", id: 8},
+      ceb: {name: "Common English Bible", id: 105},
+      darby: {name: "Darby Translation", id: 16},
+      esv: {name: "English Standard Version", id: 47},
+      esvu: {name: "English Standard Version Anglicised", id: 166},
+      gw: {name: "God's Word Translation", id: 158},
+      hcsb: {name: "Holman Christian Standard Bible", id: 77},
+      kjv: {name: "King James Version", id: 9},
+      leb: {name: "Lexham English Bible", id: 165},
+      nasb: {name: "New American Standard Bible", id: 49},
+      nirv: {name: "New International Reader's Version", id: 76},
+      niv: {name: "New International Version", id: 31},
+      nivuk: {name: "New International Version - UK", id: 64},
+      nlt: {name: "New Living Translation", id: 51},
+      nlv: {name: "New Life Version", id: 74},
+      phillips: {name: "J.B. Phillips New Testament", id: 164},
+      we: {name: "Worldwide English (New Testament)", id: 73},
+      wyc: {name: "Wycliffe Bible", id: 53},
+      ylt: {name: "Young's Literal Translation", id: 15}
     }
 
-    # The URI of the API gateway
-    URI = "http://www.biblegateway.com/usage/votd/rss/votd.rdf?"
+    # The URL of the API gateway
+    ENDPOINT_URL = "https://www.biblegateway.com/usage/votd/rss/votd.rdf?"
 
     # Regular expression for pulling the copyright out of the Bible text
-    COPYRIGHT_TEXT_REGEX =  /(Brought to you by BibleGateway.*$)/
+    COPYRIGHT_TEXT_REGEX = /(Brought to you by BibleGateway.*$)/
 
-    # Initializes the BibleGateway class
+    # Initializes the BibleGateway class and fetches the verse of the day.
+    # @param [Symbol] version the Bible translation key (e.g. +:niv+, +:kjv+, +:esv+).
+    #   Must be a key in {BIBLE_VERSIONS}.
+    # @raise [InvalidBibleVersion] if the version symbol is not in {BIBLE_VERSIONS}
     # @return [BibleGateway]
     def initialize(version = :niv)
-      raise InvalidBibleVersion unless BIBLE_VERSIONS.has_key?(version)
+      raise InvalidBibleVersion unless BIBLE_VERSIONS.key?(version)
 
       @version = version.to_s.upcase
       @version_number = BIBLE_VERSIONS[version][:id]
@@ -56,58 +66,56 @@ module Votd
 
     private
 
-    # Gets the votd from the Bible Gateway RSS feed
-    # @return [String]
+    # Fetches the verse of the day from the Bible Gateway RSS feed.
+    # Parses the feed, extracts the verse text, reference, link, and copyright.
+    # @raise [FetchError] if the HTTP request or feed parsing fails
+    # @return [void]
     def get_votd
-      uri          = "#{URI}#{@version_number}"
-      feed         = Feedjira.parse(HTTParty.get(uri).body)
-      entry        = feed.entries.first
-      cleaned_text = clean_text(entry.content)
+      url = "#{ENDPOINT_URL}#{@version_number}"
+      feed = Feedjira.parse(HTTParty.get(url).body)
+      entry = feed.entries.first
+
+      stripped = strip_html_quote_entities(entry.content)
+      stripped = Helper::Text.strip_html_tags(stripped)
 
-      @reference   = entry.title
-      @link        = entry.entry_id
-      @text        = cleaned_text
-      @copyright   = get_copyright(entry.content)
+      @reference = entry.title
+      @link = entry.entry_id
+      @text = build_verse_text(stripped)
+      @copyright = extract_copyright(stripped)
     rescue => e
-      # use default info for VotD
-      set_defaults
-      #raise e
-      # @todo Add logging
+      report_and_raise(e, "Failed to fetch verse from BibleGateway")
     end
 
-    # Cleans up the text. Removes:
-    #   - HTML quote entities
-    #   - HTML tags
-    #   - Copyright text
-    #   - Extra spaces, line breaks, etc.
-    # @return [String]
-    def clean_text(text)
-      text = strip_html_quote_entities(text)
-      text = Helper::Text.strip_html_tags(text)
-      text = strip_copyright_text(text)
-      text.strip!
+    # Builds clean verse text from HTML-stripped content.
+    # Removes copyright text and cleans up verse start/end punctuation.
+    # @param [String] stripped the HTML-stripped feed content
+    # @return [String] the cleaned verse text
+    def build_verse_text(stripped)
+      text = strip_copyright_text(stripped).strip
       text = Helper::Text.clean_verse_start(text)
-      text = Helper::Text.clean_verse_end(text)
+      Helper::Text.clean_verse_end(text)
     end
 
-    # Extracts copyright tag from the Bible text
-    # @return [String]
-    def get_copyright(text)
-      text = strip_html_quote_entities(text)
-      text = Helper::Text.strip_html_tags(text)
-      text.match(COPYRIGHT_TEXT_REGEX)[1]
+    # Extracts the copyright notice from HTML-stripped content.
+    # @param [String] stripped the HTML-stripped feed content
+    # @return [String, nil] the copyright text, or nil if not found
+    def extract_copyright(stripped)
+      match = stripped.match(COPYRIGHT_TEXT_REGEX)
+      match ? match[1] : nil
     end
 
-    # Removes HTML quote entities added by BibleGateway
-    # @return [String]
+    # Removes HTML quote entities (+&ldquo;+ and +&rdquo;+) added by BibleGateway.
+    # @param [String] text the raw feed content
+    # @return [String] text with quote entities removed
     def strip_html_quote_entities(text)
-      text.gsub(/&.dquo;/, '')
+      text.gsub(/&[lr]dquo;/, "")
     end
 
-    # Removes copyright text from the Bible text
-    # @return [String]
+    # Removes copyright text from the Bible text.
+    # @param [String] text the verse text potentially containing a copyright notice
+    # @return [String] text with copyright removed
     def strip_copyright_text(text)
-      text.gsub(COPYRIGHT_TEXT_REGEX, '')
+      text.gsub(COPYRIGHT_TEXT_REGEX, "")
     end
   end
 end

data/lib/votd/cli.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "thor"
+require "votd/helper/command_line"
+
+module Votd
+  # Thor-based command-line interface for the votd gem.
+  # Provides commands to display the Bible verse of the day
+  # from various providers and translations.
+  #
+  # @example
+  #   # From the shell:
+  #   votd verse
+  #   votd verse --provider netbible
+  #   votd verse --provider biblegateway --translation kjv --format json
+  #   votd version
+  class CLI < Thor
+    # @return [Boolean] true so Thor exits with status 1 on errors
+    def self.exit_on_failure?
+      true
+    end
+
+    desc "verse", "Display today's Bible verse of the day"
+    option :provider, type: :string, default: "biblegateway", aliases: "-p",
+      desc: "VotD provider (biblegateway, netbible, ourmanna)"
+    option :translation, type: :string, default: "niv",
+      desc: "Bible translation for BibleGateway (e.g. kjv, esv, nlt)"
+    option :format, type: :string, default: "text", aliases: "-f",
+      desc: "Output format (text, html, json)"
+    option :help, type: :boolean, aliases: "-h", hide: true
+    # Fetches and displays the verse of the day.
+    # @return [void]
+    def verse
+      return invoke(:help, ["verse"]) if options[:help]
+      votd = build_votd(options[:provider], options[:translation])
+      output(votd, options[:format])
+    rescue InvalidBibleVersion
+      warn "Error: Unknown translation '#{options[:translation]}'"
+      warn "Valid translations: #{BibleGateway::BIBLE_VERSIONS.keys.join(", ")}"
+      exit 1
+    rescue FetchError => e
+      warn "Error: #{e.message}"
+      exit 1
+    end
+
+    desc "version", "Show votd gem version"
+    # Prints the votd gem version.
+    # @return [void]
+    def version
+      puts "votd #{Votd::VERSION}"
+    end
+
+    private
+
+    # Instantiates the appropriate VotD provider.
+    # @param [String] provider the provider name ("biblegateway", "netbible", or "ourmanna")
+    # @param [String] translation the Bible translation key (only used for BibleGateway)
+    # @return [Base] a VotD provider instance
+    def build_votd(provider, translation)
+      case provider
+      when "biblegateway" then BibleGateway.new(translation.to_sym)
+      when "netbible" then NetBible.new
+      when "ourmanna" then OurManna.new
+      else
+        warn "Error: Unknown provider '#{provider}'"
+        warn "Valid providers: biblegateway, netbible, ourmanna"
+        exit 1
+      end
+    end
+
+    # Renders the VotD in the requested format.
+    # @param [Base] votd the verse of the day instance
+    # @param [String] format output format ("text", "html", or "json")
+    # @return [void]
+    def output(votd, format)
+      case format
+      when "text" then output_text(votd)
+      when "html" then puts votd.to_html
+      when "json" then output_json(votd)
+      else
+        warn "Error: Unknown format '#{format}'"
+        warn "Valid formats: text, html, json"
+        exit 1
+      end
+    end
+
+    # Renders the VotD as formatted plain text with a banner.
+    # @param [Base] votd the verse of the day instance
+    # @return [void]
+    def output_text(votd)
+      line_width = 40
+      Helper::CommandLine.banner("VERSE OF THE DAY for #{votd.date}", line_width)
+      puts "\n"
+      puts Helper::CommandLine.word_wrap(votd.to_text, line_width)
+
+      if votd.copyright
+        puts "\n"
+        Helper::CommandLine.banner(Helper::CommandLine.word_wrap(votd.copyright, line_width), line_width)
+      end
+    end
+
+    # Renders the VotD as pretty-printed JSON.
+    # @param [Base] votd the verse of the day instance
+    # @return [void]
+    def output_json(votd)
+      puts JSON.pretty_generate({
+        reference: votd.reference,
+        text: votd.text,
+        version: votd.version,
+        version_name: votd.version_name,
+        date: votd.date.to_s,
+        link: votd.link,
+        copyright: votd.copyright
+      })
+    end
+  end
+end

data/lib/votd/esvbible.rb

@@ -1,55 +1,19 @@
-require 'votd/helper/text'
+# frozen_string_literal: true
 
 module Votd
-  # Retrieves a Verse of the Day from http://www.gnpcb.org,
-  # Good News Publishers, Crossway Bibles,
-  # using the English Standard Version translation (ESV).
-  class ESVBible < Votd::Base
-    # The name of the Bible Translation that this module generates
-    BIBLE_VERSION = "ESV"
-    BIBLE_VERSION_NAME = "English Standard Version"
-
-    # The URI of the API gateway
-    URI = "http://www.gnpcb.org/esv/share/rss2.0/daily/"
-
-    # Initializes the ESVBible class
-    # @return [Votd::ESVBible]
+  # @deprecated Use {BibleGateway} with the +:esv+ version instead.
+  #   The gnpcb.org RSS endpoint used by this class was shut down.
+  #   The ESV API (https://api.esv.org/) requires an API key
+  #   and does not provide a verse-of-the-day endpoint.
+  #
+  # @example Replacement usage
+  #   votd = Votd::BibleGateway.new(:esv)
+  class ESVBible
+    # @raise [VotdError] always; this class is no longer supported
     def initialize
-      super()
-    end
-
-    private
-
-    # Gets the votd from the Good News Publishers, Crossway Bibles,
-    # RSS feed
-    # @return [String]
-    def get_votd
-      parsed_feed       = Nokogiri::XML(HTTParty.get(URI).body)
-      cleaned_copyright = clean_copyright(parsed_feed.xpath("//copyright").text)
-
-      @reference = parsed_feed.xpath("//title")[1].text
-      @text      = parsed_feed.xpath("//description")[1].text
-      @copyright = cleaned_copyright
-      @link      = parsed_feed.xpath("//guid").text
-      @version   = BIBLE_VERSION
-      @version_name = BIBLE_VERSION_NAME
-
-      @text = Helper::Text.clean_verse_start(@text)
-      @text = Helper::Text.clean_verse_end(@text)
-    rescue => e
-      # use default info for VotD
-      set_defaults
-    end
-
-    # Cleans up the copyright.
-    # Removes:
-    #   - Tabs, line breaks
-    # Inserts:
-    #   - Missing space after commas
-    # @return [String]
-    def clean_copyright(text)
-      text = text.gsub(/[\t\n]/, '')
-      text = text.gsub(/,(?!\s)/, ', ')
+      raise Votd::VotdError, "Votd::ESVBible is no longer supported. " \
+        "The gnpcb.org endpoint has been shut down. " \
+        "Use Votd::BibleGateway.new(:esv) for an ESV verse of the day."
     end
   end
 end

data/lib/votd/fetch_error.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Votd
+  # Raised when a provider fails to fetch or parse a verse of the day.
+  # The original exception is preserved as #cause.
+  class FetchError < VotdError
+  end
+end