Global Configuration

You can configure global defaults for html2rss using Html2rss.configure. This allows you to define options that apply across all generated feeds, rather than repeating them in individual feed configurations.

Global configuration is thread-safe and implements an RCU (Read-Copy-Update) mechanism: once configured, the global configuration instance is frozen and thread-safe.

require 'html2rss'

Html2rss.configure do |config|
config.log_level = :info
config.min_ttl = 60
config.headers = { 'User-Agent' => 'MyCustomUserAgent/1.0' }
end

Options

log_level

Sets the global log level for the gem.

• Type: Symbol, String, or Integer
• Default: ENV['LOG_LEVEL'] (normalized to a symbol) or :warn
• Valid Values: :debug, :info, :warn, :error, :fatal, :unknown (or their string equivalents, or Logger constant integers 0 to 5)

Html2rss.configure do |config|
  config.log_level = :info
end

headers

Defines HTTP headers that are globally appended/prepended to all requests. You can pass a static Hash or a dynamic callable (Proc / lambda) that returns a Hash (e.g. for dynamic or token-refreshed headers).

• Type: Hash, Proc, #call, or nil
• Default: nil

Static Headers

Html2rss.configure do |config|
  config.headers = {
    'User-Agent' => 'MyGlobalUserAgent/1.0',
    'X-Custom-Header' => 'CustomValue'
  }
end

Dynamic/Callable Headers

Html2rss.configure do |config|
  config.headers = -> { { 'X-Request-Timestamp' => Time.now.to_i.to_s } }
end

default_strategy

Overrides the strategy used when a feed configuration does not specify one. Keep the gem default (auto) unless every feed in the process requires a fixed fetch mode.

• Type: Symbol, String, or nil
• Default: nil (uses auto)

Html2rss.configure do |config|
  config.default_strategy = :auto
end

min_ttl

Enforces a strict lower bound on the computed Time to Live (TTL) in minutes for generated feeds. If a feed’s calculated TTL or config-override TTL is lower than min_ttl, it will be clamped to min_ttl.

• Type: Integer or String (must represent a positive integer)
• Default: nil (no minimum boundary enforced)

Html2rss.configure do |config|
  config.min_ttl = 60 # Clamps all feed TTLs to at least 60 minutes
end

stylesheets

Sets the global list of XML stylesheet processing instructions to include in all generated feeds. Stylesheets are added at the top of the generated RSS XML.

• Type: Array<Hash>
• Default: []

Html2rss.configure do |config|
  config.stylesheets = [
    {
      href: '/global-style.xsl',
      type: 'text/xsl',
      media: 'all'
    }
  ]
end

logger

Defines a custom logger for the gem. The gem accepts any duck-typed logger object. If the object responds to #level= and/or #formatter=, they will be configured using the values set via log_level and logger_formatter.

• Type: Object
• Default: Logger.new($stdout)

# Example: Using a custom logger (such as a semantic or JSON logger)
class CustomLogger
  def info(msg)
    puts "[CUSTOM INFO] #{msg}"
  end
  # Implement debug, warn, error, fatal, etc.
end

Html2rss.configure do |config|
config.logger = CustomLogger.new
end

logger_formatter

Specifies a custom formatter for the default logger. This must be a callable object (like a Proc or lambda) that accepts the standard block arguments: severity, datetime, progname, and msg.

• Type: Proc, #call, or nil
• Default: A proc that formats logs as "#{datetime} [#{severity}] #{msg}\n"

Html2rss.configure do |config|
  config.logger_formatter = proc do |severity, datetime, _progname, msg|
    "#{datetime} [#{severity}] - #{msg}
"
  end
end

---

For detailed documentation on the Ruby API, see the official YARD documentation.