html2rss 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d51b095228dec5d98a1ff66ee7329171d2297bad67ca27a7930afe296b589e8
-  data.tar.gz: 32bf56a05ed45a1bb8c3341f228f41d1441e65243c6a5d55908e90d002f8880b
+  metadata.gz: ebe536d8051a64c6e2adf9fa8e1d9d1f9fa3743541c44ca85022d0603f9032b2
+  data.tar.gz: 7b3aaa213aaf6a37fb6e94fa72c9936ffd2391322297553b253b097edea300cc
 SHA512:
-  metadata.gz: 0cbe761521ec3cd43bd25565f6425e6ced445814c30706d50d52c008ce6e3905a6f95b9f6d9dfa2faf90baf4bc2fbeb43741af5bc185e1488d31b55b9ffa3c75
-  data.tar.gz: 353e1586ddde92858ea95a2eecda6d752975585038acc29e6d09ff97363e5429d15966a005e1f9c4a41e9ad83b972973cfadd9c840160849d530166e7dd84298
+  metadata.gz: '03985002d050b996c1dc315cbe8e3fc79b6619447a048ad3d2dca86f792eab5c2356716cf6198a24efc61de7e7ddceba2780da49c3e68a3c9efe895eb7cf0cf1'
+  data.tar.gz: 8315473528f46a5ba28297af296b879a66ac00f86ba9eb117b4e6c9ec61c285e4090cfd999ff712368f5b988b1cbda460e268aa3ea8928912bcdb1960ae25a4a

data/README.md

@@ -1,6 +1,6 @@
 ![html2rss logo](https://github.com/html2rss/html2rss/raw/master/support/logo.png)
 
-[![Gem Version](https://badge.fury.io/rb/html2rss.svg)](http://rubygems.org/gems/html2rss/) [![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](https://www.rubydoc.info/gems/html2rss) ![Retro Badge: valid RSS](https://validator.w3.org/feed/images/valid-rss-rogers.png) [![](http://img.shields.io/liberapay/goal/gildesmarais.svg?logo=liberapa)](https://liberapay.com/gildesmarais/donate)
+[![Gem Version](https://badge.fury.io/rb/html2rss.svg)](http://rubygems.org/gems/html2rss/) [![Yard Docs](http://img.shields.io/badge/yard-docs-blue.svg)](https://www.rubydoc.info/gems/html2rss) ![Retro Badge: valid RSS](https://validator.w3.org/feed/images/valid-rss-rogers.png)
 
 `html2rss` is a Ruby gem that generates RSS 2.0 feeds from a _feed config_.
 

data/html2rss.gemspec

@@ -10,23 +10,23 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Gil Desmarais']
   spec.email         = ['html2rss@desmarais.de']
 
-  spec.summary       = 'Returns an RSS::Rss object by scraping a URL.'
-  spec.description   = 'Give the URL to scrape and some CSS selectors. Get a RSS::Rss instance in return.'
+  spec.summary       = 'Generates RSS feeds from websites by scraping a URL and using CSS selectors to extract item.'
+  spec.description   = 'Supports JSON content, custom HTTP headers, and post-processing of extracted content.'
   spec.homepage      = 'https://github.com/html2rss/html2rss'
   spec.license       = 'MIT'
   spec.required_ruby_version = '>= 3.1'
 
   if spec.respond_to?(:metadata)
     spec.metadata['allowed_push_host'] = 'https://rubygems.org'
-    spec.metadata['changelog_uri'] = 'https://github.com/html2rss/html2rss/releases'
+    spec.metadata['changelog_uri'] = "#{spec.homepage}/releases/tag/v#{spec.version}"
     spec.metadata['rubygems_mfa_required'] = 'true'
   else
     raise 'RubyGems 2.0 or newer is required to protect against ' \
           'public gem pushes.'
   end
 
-  spec.files = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features|support|docs|.github|.yardoc)/})
+  spec.files = `git ls-files -z`.split("\x0").select do |f|
+    f.match(%r{^(lib/|exe/|README.md|LICENSE|html2rss.gemspec)})
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

data/lib/html2rss/attribute_post_processors/base.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Html2rss
+  ##
+  # Provides a namespace for attribute post processors.
+  module AttributePostProcessors
+    ##
+    # All post processors must inherit from this base class and implement `self.validate_args!` and `#get`.
+    class Base
+      # Validates the presence of required options in the context
+      #
+      # @param keys [Array<Symbol>] the keys to check for presence
+      # @param context [Hash] the context containing options
+      # @raise [MissingOption] if any key is missing
+      def self.expect_options(keys, context)
+        keys.each do |key|
+          unless (options = context[:options]).key?(key)
+            raise MissingOption, "The `#{key}` option is missing in: #{options.inspect}", [],
+                  cause: nil
+          end
+        end
+      end
+
+      # Asserts that the value is of the expected type(s)
+      #
+      # @param value [Object] the value to check
+      # @param types [Array<Class>, Class] the expected type(s)
+      # @param name [String] the name of the option being checked
+      # @raise [InvalidType] if the value is not of the expected type(s)
+      def self.assert_type(value, types = [], name)
+        types = [types] unless types.is_a?(Array)
+
+        return if types.any? { |type| value.is_a?(type) }
+
+        error_message_template = 'The type of `%s` must be %s, but is: %s'
+        raise InvalidType, format(error_message_template, name, types.join(' or '), value.class), [], cause: nil
+      end
+
+      # private_class_method :expect_options, :assert_type
+
+      ##
+      # This method validates the arguments passed to the post processor. Must be implemented by subclasses.
+      def self.validate_args!(_value, _context)
+        raise NotImplementedError, 'You must implement the `validate_args!` method in the post processor'
+      end
+
+      # Initializes the post processor
+      #
+      # @param value [Object] the value to be processed
+      # @param context [Item::Context] the context
+      def initialize(value, context)
+        klass = self.class
+        # TODO: get rid of Hash
+        klass.assert_type(context, [Item::Context, Hash], 'context')
+        klass.validate_args!(value, context)
+
+        @value = value
+        @context = context
+      end
+
+      attr_reader :value, :context
+
+      # Abstract method to be implemented by subclasses
+      #
+      # @raise [NotImplementedError] if not implemented in subclass
+      def get
+        raise NotImplementedError, 'You must implement the `get` method in the post processor'
+      end
+    end
+  end
+end

data/lib/html2rss/attribute_post_processors/gsub.rb

@@ -25,39 +25,39 @@ module Html2rss
     # `replacement` can be a String or a Hash.
     #
     # See the doc on [String#gsub](https://ruby-doc.org/core/String.html#method-i-gsub) for more info.
-    class Gsub
+    class Gsub < Base
+      def self.validate_args!(value, context)
+        assert_type value, String, :value
+        expect_options(%i[replacement pattern], context)
+        assert_type context.dig(:options, :replacement), [String, Hash], :replacement
+      end
+
       ##
       # @param value [String]
       # @param context [Item::Context]
       def initialize(value, context)
-        @value = value
-        @options = context[:options]
+        super
+
+        options = context[:options]
+
+        @replacement = options[:replacement]
+        @pattern = options[:pattern]
       end
 
       ##
       # @return [String]
       def get
-        @value.to_s.gsub(pattern, replacement)
+        value.to_s.gsub(pattern, replacement)
       end
 
       private
 
+      attr_accessor :replacement
+
       ##
       # @return [Regexp]
       def pattern
-        pattern = @options[:pattern]
-        raise ArgumentError, 'The `pattern` option is missing' unless pattern
-
-        pattern.is_a?(String) ? Utils.build_regexp_from_string(pattern) : pattern
-      end
-
-      ##
-      # @return [Hash, String]
-      def replacement
-        replacement = @options[:replacement]
-        return replacement if replacement.is_a?(String) || replacement.is_a?(Hash)
-
-        raise ArgumentError, 'The `replacement` option must be a String or Hash'
+        @pattern.is_a?(String) ? Utils.build_regexp_from_string(@pattern) : @pattern
       end
     end
   end

data/lib/html2rss/attribute_post_processors/html_to_markdown.rb

@@ -26,18 +26,17 @@ module Html2rss
     #
     # Would return:
     #    'Lorem **ipsum** dolor'
-    class HtmlToMarkdown
-      ##
-      # @param value [String]
-      # @param env [Item::Context]
-      def initialize(value, env)
-        @sanitized_value = SanitizeHtml.new(value, env).get
+    class HtmlToMarkdown < Base
+      def self.validate_args!(value, _context)
+        assert_type value, String, :value
       end
 
       ##
       # @return [String] formatted in Markdown
       def get
-        ReverseMarkdown.convert(@sanitized_value)
+        sanitized_value = SanitizeHtml.new(value, context).get
+
+        ReverseMarkdown.convert(sanitized_value)
       end
     end
   end

data/lib/html2rss/attribute_post_processors/markdown_to_html.rb

@@ -32,13 +32,9 @@ module Html2rss
     #    <h1>Section</h1>
     #
     #    <p>Price: 12.34</p>
-    class MarkdownToHtml
-      ##
-      # @param value [String] Markdown content to convert to HTML
-      # @param env [Item::Context] Context object providing additional environment details
-      def initialize(value, env)
-        @value = value
-        @env = env
+    class MarkdownToHtml < Base
+      def self.validate_args!(value, _context)
+        assert_type value, String, :value
       end
 
       ##
@@ -46,8 +42,8 @@ module Html2rss
       #
       # @return [String] Sanitized HTML content
       def get
-        html_content = Kramdown::Document.new(@value).to_html
-        SanitizeHtml.new(html_content, @env).get
+        html_content = Kramdown::Document.new(value).to_html
+        SanitizeHtml.new(html_content, context).get
       end
     end
   end

data/lib/html2rss/attribute_post_processors/parse_time.rb

@@ -24,22 +24,22 @@ module Html2rss
     # Would return:
     #    "Tue, 02 Jul 2019 00:00:00 +0200"
     #
-    # It uses {https://ruby-doc.org/stdlib-2.5.3/libdoc/time/rdoc/Time.html#method-c-parse Time.parse}.
-    class ParseTime
-      ##
-      # @param value [String] the time to parse
-      # @param env [Item::Context] Context object providing additional environment details
-      def initialize(value, env)
-        @value = value.to_s
-        @time_zone = env[:config].time_zone
+    # It uses `Time.parse`.
+    class ParseTime < Base
+      def self.validate_args!(value, context)
+        assert_type value, String, :value
+        assert_type context[:config].time_zone, String, :time_zone
       end
 
       ##
-      # Converts the provided time string to RFC822 format, taking into account the configured time zone.
+      # Converts the provided time string to RFC822 format, taking into account the time_zone.
       #
       # @return [String] RFC822 formatted time
+      # @raise [TZInfo::InvalidTimezoneIdentifier] if the configured time zone is invalid
       def get
-        Utils.use_zone(@time_zone) { Time.parse(@value).rfc822 }
+        time_zone = context[:config].time_zone
+
+        Utils.use_zone(time_zone) { Time.parse(value).rfc822 }
       end
     end
   end

data/lib/html2rss/attribute_post_processors/parse_uri.rb

@@ -21,21 +21,24 @@ module Html2rss
     #
     # Would return:
     #    'http://why-not-use-a-link.uh'
-    class ParseUri
-      ##
-      # @param value [String]
-      # @param context [Item::Context]
-      def initialize(value, context)
-        @value = value
-        @config_url = context.config.url
+    class ParseUri < Base
+      def self.validate_args!(value, context)
+        url_types = [String, URI::HTTP, Addressable::URI].freeze
+
+        assert_type(value, url_types, :value)
+        assert_type(context.config.url, url_types, :url)
+
+        raise ArgumentError, 'The `value` option is missing or empty.' if value.to_s.empty?
       end
 
       ##
       # @return [String]
       def get
+        config_url = context.config.url
+
         Html2rss::Utils.build_absolute_url_from_relative(
-          Html2rss::Utils.sanitize_url(@value),
-          @config_url
+          Html2rss::Utils.sanitize_url(value),
+          config_url
         ).to_s
       end
     end

data/lib/html2rss/attribute_post_processors/sanitize_html.rb

@@ -38,19 +38,15 @@ module Html2rss
     #
     # Would return:
     #    '<p>Lorem <b>ipsum</b> dolor ...</p>'
-    class SanitizeHtml
-      ##
-      # @param value [String]
-      # @param env [Item::Context]
-      def initialize(value, env)
-        @value = value
-        @channel_url = env[:config].url
+    class SanitizeHtml < Base
+      def self.validate_args!(value, _context)
+        assert_type value, String, :value
       end
 
       ##
       # @return [String]
       def get
-        sanitized_html = Sanitize.fragment(@value, sanitize_config)
+        sanitized_html = Sanitize.fragment(value, sanitize_config)
         sanitized_html.to_s.gsub(/\s+/, ' ').strip
       end
 
@@ -77,13 +73,15 @@ module Html2rss
         }
       end
 
+      def channel_url = context[:config].url
+
       ##
       # Wrapper for transform_urls_to_absolute_ones to pass the channel_url.
       #
       # @param env [Hash]
       # @return [nil]
       def transform_urls_to_absolute_ones(env)
-        HtmlTransformers::TransformUrlsToAbsoluteOnes.new(@channel_url).call(**env)
+        HtmlTransformers::TransformUrlsToAbsoluteOnes.new(channel_url).call(**env)
       end
 
       ##

data/lib/html2rss/attribute_post_processors/substring.rb

@@ -28,13 +28,15 @@ module Html2rss
     #
     # Would return:
     #    'bar'
-    class Substring
-      ##
-      # @param value [String] The original string to extract a substring from.
-      # @param env [Item::Context] Context object providing additional environment details.
-      def initialize(value, env)
-        @value = value
-        @options = env[:options]
+    class Substring < Base
+      def self.validate_args!(value, context)
+        assert_type value, String, :value
+
+        options = context[:options]
+        assert_type options[:start], Integer, :start
+
+        end_index = options[:end]
+        assert_type end_index, Integer, :end if end_index
       end
 
       ##
@@ -42,11 +44,29 @@ module Html2rss
       #
       # @return [String] The extracted substring.
       def get
-        start_index = @options[:start].to_i
-        end_index = @options[:end]&.to_i || @value.length
+        value[range]
+      end
+
+      ##
+      # Determines the range for the substring extraction based on the provided start and end indices.
+      #
+      # @return [Range] The range object representing the start and end/Infinity (integers).
+      def range
+        return (start_index..) unless end_index?
+
+        if start_index == end_index
+          raise ArgumentError,
+                'The `start` value must be unequal to the `end` value.'
+        end
 
-        @value[start_index..end_index]
+        (start_index..end_index)
       end
+
+      private
+
+      def end_index?  = !context[:options][:end].to_s.empty?
+      def end_index   = context[:options][:end].to_i
+      def start_index = context[:options][:start].to_i
     end
   end
 end

data/lib/html2rss/attribute_post_processors/template.rb

@@ -31,15 +31,23 @@ module Html2rss
     #
     # Would return:
     #    'Product (23,42€)'
-    class Template
+    class Template < Base
+      def self.validate_args!(value, context)
+        assert_type value, String, :value
+
+        string = context[:options]&.dig(:string).to_s
+        raise InvalidType, 'The `string` template is absent.' if string.empty?
+      end
+
       ##
       # @param value [String]
-      # @param env [Item::Context]
-      def initialize(value, env)
-        @value = value
-        @options = env[:options]
-        @item = env[:item]
-        @string = @options[:string]
+      # @param context [Item::Context]
+      def initialize(value, context)
+        super
+
+        @options = context[:options] || {}
+        @item = context[:item]
+        @string = @options[:string].to_s
       end
 
       ##
@@ -86,7 +94,7 @@ module Html2rss
       # @param method_name [String, Symbol]
       # @return [String]
       def item_value(method_name)
-        method_name.to_sym == :self ? @value.to_s : @item.public_send(method_name).to_s
+        method_name.to_sym == :self ? value : @item.public_send(method_name).to_s
       end
     end
   end

data/lib/html2rss/attribute_post_processors.rb

@@ -6,7 +6,15 @@ module Html2rss
   module AttributePostProcessors
     ##
     # Error raised when an unknown post processor name is requested.
-    class UnknownPostProcessorName < StandardError; end
+    class UnknownPostProcessorName < Html2rss::Error; end
+
+    ##
+    # Error raised when a required option is missing.
+    class MissingOption < Html2rss::Error; end
+
+    ##
+    # Error raised when an invalid type is provided.
+    class InvalidType < Html2rss::Error; end
 
     ##
     # Maps the post processor name to the class implementing the post processor.

data/lib/html2rss/config/channel.rb

@@ -11,6 +11,15 @@ module Html2rss
     # 1. the RSS channel attributes
     # 2. html2rss options like json or custom HTTP-headers for the request
     class Channel
+      ##
+      # @param config [Hash<Symbol, Object>]
+      # @return [Set<String>] the required parameter names
+      def self.required_params_for_config(config)
+        config.each_with_object(Set.new) do |(_, value), required_params|
+          required_params.merge(value.scan(/%<([\w_\d]+)>/).flatten) if value.is_a?(String)
+        end
+      end
+
       ##
       # @param channel [Hash<Symbol, Object>]
       # @param params [Hash]
@@ -77,15 +86,6 @@ module Html2rss
         config.fetch(:json, false)
       end
 
-      ##
-      # @param config [Hash<Symbol, Object>]
-      # @return [Set<String>] the required parameter names
-      def self.required_params_for_config(config)
-        config.each_with_object(Set.new) do |(_, value), required_params|
-          required_params.merge(value.scan(/%<([\w_\d]+)>/).flatten) if value.is_a?(String)
-        end
-      end
-
       private
 
       # @return [Hash<Symbol, Object>]

data/lib/html2rss/config/selectors.rb

@@ -10,6 +10,9 @@ module Html2rss
       # Struct to represent a selector with associated attributes for extraction and processing.
       Selector = Struct.new(:selector, :attribute, :extractor, :post_process, :order, :static, keyword_init: true)
 
+      # raised when an invalid selector name is used
+      class InvalidSelectorName < Html2rss::Error; end
+
       ##
       # @param config [Hash<Symbol, Object>]
       def initialize(config)
@@ -28,9 +31,15 @@ module Html2rss
       # @param name [Symbol]
       # @return [Selector]
       def selector(name)
-        raise ArgumentError, "invalid item's selector name: #{name}" unless selector?(name)
+        raise InvalidSelectorName, "invalid selector name: #{name}" unless selector?(name)
+
+        keywords = config[name].slice(*available_keys)
 
-        Selector.new(config[name])
+        if (additional_keys = available_keys - keywords.keys).any?
+          warn "additional keys (#{additional_keys.join(', ')}) present in selector #{name}"
+        end
+
+        Selector.new(keywords)
       end
 
       ##
@@ -86,6 +95,8 @@ module Html2rss
           array.map!(&:to_sym)
         end.to_set
       end
+
+      def available_keys = @available_keys ||= Selector.members
     end
   end
 end

data/lib/html2rss/config.rb

@@ -12,11 +12,11 @@ module Html2rss
     ##
     # The Error class to be thrown when a feed config requires params, but none
     # were passed to Config.
-    class ParamsMissing < StandardError; end
+    class ParamsMissing < Html2rss::Error; end
 
     ##
     # Thrown when the feed config does not contain a value at `:channel`.
-    class ChannelMissing < StandardError; end
+    class ChannelMissing < Html2rss::Error; end
 
     # Struct to store XML Stylesheet attributes
     Stylesheet = Struct.new(:href, :type, :media, keyword_init: true)

data/lib/html2rss/item.rb

@@ -16,6 +16,21 @@ module Html2rss
     # Class to keep an Item's <enclosure>.
     Enclosure = Struct.new('Enclosure', :type, :bits_length, :url, keyword_init: true)
 
+    ##
+    # Fetches items from a given URL using configuration settings.
+    #
+    # @param url [String] URL to fetch items from.
+    # @param config [Html2rss::Config] Configuration object.
+    # @return [Array<Html2rss::Item>] list of items fetched.
+    def self.from_url(url, config)
+      body = Utils.request_body_from_url(url, convert_json_to_xml: config.json?, headers: config.headers)
+
+      Nokogiri.HTML(body)
+              .css(config.selector_string(Config::Selectors::ITEMS_SELECTOR_NAME))
+              .map { |xml| new(xml, config) }
+              .select(&:valid?)
+    end
+
     ##
     # @param xml [Nokogiri::XML::Element]
     # @param config [Html2rss::Config]
@@ -122,21 +137,6 @@ module Html2rss
       )
     end
 
-    ##
-    # Fetches items from a given URL using configuration settings.
-    #
-    # @param url [String] URL to fetch items from.
-    # @param config [Html2rss::Config] Configuration object.
-    # @return [Array<Html2rss::Item>] list of items fetched.
-    def self.from_url(url, config)
-      body = Utils.request_body_from_url(url, convert_json_to_xml: config.json?, headers: config.headers)
-
-      Nokogiri.HTML(body)
-              .css(config.selector_string(Config::Selectors::ITEMS_SELECTOR_NAME))
-              .map { |xml| new(xml, config) }
-              .select(&:valid?)
-    end
-
     private
 
     # @return [Nokogiri::XML::Element] XML element representing the item.

data/lib/html2rss/item_extractors.rb

@@ -6,7 +6,7 @@ module Html2rss
   module ItemExtractors
     ##
     # The Error class to be thrown when an unknown extractor name is requested.
-    class UnknownExtractorName < StandardError; end
+    class UnknownExtractorName < Html2rss::Error; end
 
     ##
     # Maps the extractor name to the class implementing the extractor.

data/lib/html2rss/version.rb

@@ -3,6 +3,6 @@
 ##
 # The Html2rss namespace.
 module Html2rss
-  VERSION = '0.10.0'
+  VERSION = '0.12.0'
   public_constant :VERSION
 end

data/lib/html2rss.rb

@@ -10,6 +10,12 @@ require 'yaml'
 ##
 # The Html2rss namespace.
 module Html2rss
+  ##
+  # The Html2rss::Error base class.
+  class Error < StandardError; end
+
+  ##
+  # Key for the feeds configuration in the YAML file.
   CONFIG_KEY_FEEDS = :feeds
 
   ##

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: html2rss
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Gil Desmarais
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-07-30 00:00:00.000000000 Z
+date: 2024-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -204,8 +204,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Give the URL to scrape and some CSS selectors. Get a RSS::Rss instance
-  in return.
+description: Supports JSON content, custom HTTP headers, and post-processing of extracted
+  content.
 email:
 - html2rss@desmarais.de
 executables:
@@ -213,21 +213,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".mergify.yml"
-- ".rspec"
-- ".rubocop.yml"
-- ".yardopts"
-- Gemfile
-- Gemfile.lock
 - LICENSE
 - README.md
-- bin/console
-- bin/setup
 - exe/html2rss
 - html2rss.gemspec
 - lib/html2rss.rb
 - lib/html2rss/attribute_post_processors.rb
+- lib/html2rss/attribute_post_processors/base.rb
 - lib/html2rss/attribute_post_processors/gsub.rb
 - lib/html2rss/attribute_post_processors/html_to_markdown.rb
 - lib/html2rss/attribute_post_processors/html_transformers/transform_urls_to_absolute_ones.rb
@@ -256,13 +248,12 @@ files:
 - lib/html2rss/rss_builder/stylesheet.rb
 - lib/html2rss/utils.rb
 - lib/html2rss/version.rb
-- rakefile.rb
 homepage: https://github.com/html2rss/html2rss
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-  changelog_uri: https://github.com/html2rss/html2rss/releases
+  changelog_uri: https://github.com/html2rss/html2rss/releases/tag/v0.12.0
   rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
@@ -282,5 +273,6 @@ requirements: []
 rubygems_version: 3.5.11
 signing_key: 
 specification_version: 4
-summary: Returns an RSS::Rss object by scraping a URL.
+summary: Generates RSS feeds from websites by scraping a URL and using CSS selectors
+  to extract item.
 test_files: []

data/.gitignore

@@ -1,12 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status
-docs/

data/.mergify.yml

@@ -1,15 +0,0 @@
-queue_rules:
-  - name: dependabot
-    conditions:
-      - author=dependabot[bot]
-      - status-success=test
-      - base=master
-
-pull_request_rules:
-  - name: automatic merge for Dependabot pull requests
-    conditions:
-      - author=dependabot[bot]
-    actions:
-      queue:
-        method: squash
-        name: dependabot

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---color
---order random
---require spec_helper

data/.rubocop.yml

@@ -1,30 +0,0 @@
-require:
-  - rubocop-performance
-  - rubocop-rspec
-  - rubocop-md
-  - rubocop-rake
-
-AllCops:
-  DisplayCopNames: true
-  NewCops: enable
-  Exclude:
-    - vendor/**/*
-
-Metrics/BlockLength:
-  Exclude:
-    - "spec/**/*_spec.rb"
-    - html2rss.gemspec
-
-RSpec/NestedGroups:
-  Exclude:
-    - spec/html2rss_spec.rb
-
-RSpec/DescribeClass:
-  Exclude:
-    - spec/exe/**/*_spec.rb
-
-RSpec/NamedSubject:
-  Enabled: false
-
-Naming/RescuedExceptionsVariableName:
-  PreferredName: error

data/.yardopts

@@ -1,6 +0,0 @@
---readme README.md
---charset utf-8
---no-private
---exclude /coverage
---exclude /support
---output-dir docs/

data/Gemfile

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in html2rss.gemspec
-gemspec
-
-group :development, :test do
-  gem 'byebug'
-  gem 'rake'
-  gem 'rspec', '~> 3.0'
-  gem 'rubocop'
-  gem 'rubocop-md'
-  gem 'rubocop-performance'
-  gem 'rubocop-rake'
-  gem 'rubocop-rspec'
-  gem 'vcr'
-  gem 'yard'
-end
-
-group :test do
-  gem 'simplecov', require: false
-end

data/Gemfile.lock

@@ -1,153 +0,0 @@
-PATH
-  remote: .
-  specs:
-    html2rss (0.10.0)
-      addressable (~> 2.7)
-      faraday (> 2.0.1, < 3.0)
-      faraday-follow_redirects
-      kramdown
-      mime-types (> 3.0)
-      nokogiri (>= 1.10, < 2.0)
-      regexp_parser
-      reverse_markdown (~> 2.0)
-      rss
-      sanitize (~> 6.0)
-      thor
-      tzinfo
-      zeitwerk
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.8.6)
-      public_suffix (>= 2.0.2, < 6.0)
-    ast (2.4.2)
-    byebug (11.1.3)
-    concurrent-ruby (1.2.3)
-    crass (1.0.6)
-    diff-lcs (1.5.1)
-    docile (1.4.0)
-    faraday (2.9.0)
-      faraday-net_http (>= 2.0, < 3.2)
-    faraday-follow_redirects (0.3.0)
-      faraday (>= 1, < 3)
-    faraday-net_http (3.1.0)
-      net-http
-    json (2.7.2)
-    kramdown (2.4.0)
-      rexml
-    language_server-protocol (3.17.0.3)
-    mime-types (3.5.2)
-      mime-types-data (~> 3.2015)
-    mime-types-data (3.2024.0305)
-    mini_portile2 (2.8.6)
-    net-http (0.4.1)
-      uri
-    nokogiri (1.16.5)
-      mini_portile2 (~> 2.8.2)
-      racc (~> 1.4)
-    nokogiri (1.16.5-x86_64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.16.5-x86_64-linux)
-      racc (~> 1.4)
-    parallel (1.24.0)
-    parser (3.3.1.0)
-      ast (~> 2.4.1)
-      racc
-    public_suffix (5.0.5)
-    racc (1.7.3)
-    rainbow (3.1.1)
-    rake (13.2.1)
-    regexp_parser (2.9.0)
-    reverse_markdown (2.1.1)
-      nokogiri
-    rexml (3.3.2)
-      strscan
-    rspec (3.13.0)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rss (0.3.0)
-      rexml
-    rubocop (1.63.4)
-      json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-capybara (2.20.0)
-      rubocop (~> 1.41)
-    rubocop-factory_bot (2.25.1)
-      rubocop (~> 1.41)
-    rubocop-md (1.2.2)
-      rubocop (>= 1.0)
-    rubocop-performance (1.21.0)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (2.29.1)
-      rubocop (~> 1.40)
-      rubocop-capybara (~> 2.17)
-      rubocop-factory_bot (~> 2.22)
-      rubocop-rspec_rails (~> 2.28)
-    rubocop-rspec_rails (2.28.3)
-      rubocop (~> 1.40)
-    ruby-progressbar (1.13.0)
-    sanitize (6.1.0)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.12.0)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
-    simplecov_json_formatter (0.1.4)
-    strscan (3.1.0)
-    thor (1.3.1)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
-    vcr (6.2.0)
-    yard (0.9.36)
-    zeitwerk (2.6.13)
-
-PLATFORMS
-  ruby
-  x86_64-darwin
-  x86_64-darwin-20
-  x86_64-linux
-
-DEPENDENCIES
-  byebug
-  html2rss!
-  rake
-  rspec (~> 3.0)
-  rubocop
-  rubocop-md
-  rubocop-performance
-  rubocop-rake
-  rubocop-rspec
-  simplecov
-  vcr
-  yard
-
-BUNDLED WITH
-   2.4.1

data/bin/console

@@ -1,16 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require 'bundler/setup'
-require 'html2rss'
-require 'byebug'
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require 'irb'
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/rakefile.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler'
-require 'rake'
-require 'rspec'
-require 'rspec/core/rake_task'
-
-Bundler.setup
-Bundler::GemHelper.install_tasks
-
-task default: [:spec]
-
-desc 'Run all examples'
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.ruby_opts = %w[-w]
-end