lib/html2rss.rb in html2rss-0.9.0 vs lib/html2rss.rb in html2rss-0.10.0

@@ -1,44 +1,44 @@
+# frozen_string_literal: true
+
 require 'zeitwerk'
 
 loader = Zeitwerk::Loader.for_gem
 loader.setup
 
 require 'yaml'
 
 ##
 # The Html2rss namespace.
-# Request HTML from an URL and transform it to a RSS 2.0 object.
 module Html2rss
+  CONFIG_KEY_FEEDS = :feeds
+
   ##
-  # Returns a RSS object which is generated from the provided file.
+  # Returns an RSS object generated from the provided YAML file configuration.
   #
-  # `file_path`: a File object of a YAML file
-  # `name`: the of the feed
-  #
   # Example:
   #
   #    feed = Html2rss.feed_from_yaml_config(File.join(['spec', 'config.test.yml']), 'nuxt-releases')
   #    # => #<RSS::Rss:0x00007fb2f6331228
-  # @return [RSS:Rss]
-  def self.feed_from_yaml_config(file, name)
-    # rubocop:disable Security/YAMLLoad
-    yaml = YAML.load(File.open(file))
-    # rubocop:enable Security/YAMLLoad
+  #
+  # @param file [String] Path to the YAML file.
+  # @param name [String, Symbol, nil] Name of the feed in the YAML file.
+  # @param global_config [Hash] Global options (e.g., HTTP headers).
+  # @param params [Hash] Dynamic parameters for the feed configuration.
+  # @return [RSS::Rss] RSS object generated from the configuration.
+  def self.feed_from_yaml_config(file, name = nil, global_config: {}, params: {})
+    yaml = load_yaml(file)
+    feeds = yaml[CONFIG_KEY_FEEDS] || {}
 
-    feed_config = yaml['feeds'][name]
-    global_config = yaml.reject { |key| key == 'feeds' }
+    feed_config = find_feed_config(yaml, feeds, name, global_config)
 
-    config = Config.new(feed_config, global_config)
-    feed(config)
+    feed(Config.new(feed_config, global_config, params))
   end
 
   ##
-  # Returns a RSS object which is generated from the provided config.
+  # Returns an RSS object generated from the provided configuration.
   #
-  # `config`: can be a Hash or an instance of Html2rss::Config.
-  #
   # Example:
   #
   #    feed = Html2rss.feed(
   #      channel: { name: 'StackOverflow: Hot Network Questions', url: 'https://stackoverflow.com' },
   #      selectors: {
@@ -46,13 +46,44 @@
   #        title: { selector: 'a' },
   #        link: { selector: 'a', extractor: 'href' }
   #      }
   #    )
   #    # => #<RSS::Rss:0x00007fb2f48d14a0 ...>
-  # @return [RSS:Rss]
+  #
+  # @param config [Hash<Symbol, Object>, Html2rss::Config] Feed configuration.
+  # @return [RSS::Rss] RSS object generated from the configuration.
   def self.feed(config)
     config = Config.new(config) unless config.is_a?(Config)
+    RssBuilder.build(config)
+  end
 
-    feed = FeedBuilder.new config
-    feed.rss
+  ##
+  # Loads and parses the YAML file.
+  #
+  # @param file [String] Path to the YAML file.
+  # @return [Hash] Parsed YAML content.
+  def self.load_yaml(file)
+    YAML.safe_load_file(file, symbolize_names: true)
   end
+
+  ##
+  # Builds the feed configuration based on the provided parameters.
+  #
+  # @param yaml [Hash] Parsed YAML content.
+  # @param feeds [Hash] Feeds from the YAML content.
+  # @param feed_name [String, Symbol, nil] Name of the feed in the YAML file.
+  # @param global_config [Hash] Global options (e.g., HTTP headers).
+  # @return [Hash] Feed configuration.
+  def self.find_feed_config(yaml, feeds, feed_name, global_config)
+    return yaml unless feed_name
+
+    feed_name = feed_name.to_sym
+    if feeds.key?(feed_name)
+      global_config.merge!(yaml.reject { |key| key == CONFIG_KEY_FEEDS })
+      feeds[feed_name]
+    else
+      yaml
+    end
+  end
+
+  private_class_method :load_yaml, :find_feed_config
 end