Class: Html2rss::Config::RequestControls

Inherits:
Object
  • Object
show all
Defined in:
lib/html2rss/config/request_controls.rb

Overview

Wire provenance for request control values (explicit vs default).

Constant Summary collapse

TOP_LEVEL_KEYS =

Request-control keys accepted at the top level of feed config.

%i[strategy].freeze
REQUEST_KEYS =

Request-control keys accepted under the nested request config.

%i[max_redirects max_requests total_timeout_seconds].freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(strategy: nil, max_redirects: nil, max_requests: nil, total_timeout_seconds: nil, explicit_keys: []) ⇒ RequestControls

Returns a new instance of RequestControls.

Parameters:

  • strategy (Symbol, nil) (defaults to: nil) —

    effective request strategy

  • max_redirects (Integer, nil) (defaults to: nil) —

    effective redirect limit

  • max_requests (Integer, nil) (defaults to: nil) —

    effective request budget

  • total_timeout_seconds (Integer, nil) (defaults to: nil) —

    effective request timeout

  • explicit_keys (Array<Symbol>) (defaults to: []) —

    controls explicitly supplied by the caller



87
88
89
90
91
92
93
94
95
 
# File 'lib/html2rss/config/request_controls.rb', line 87

def initialize(strategy: nil, max_redirects: nil, max_requests: nil,
               total_timeout_seconds: nil, explicit_keys: [])
  @strategy = strategy
  @max_redirects = max_redirects
  @max_requests = max_requests
  @total_timeout_seconds = total_timeout_seconds
  @explicit_keys = explicit_keys.map(&:to_sym).uniq.freeze
  freeze
end

Instance Attribute Details

#max_redirects ⇒ Integer? (readonly)

Returns effective redirect limit.

Returns:

  • (Integer, nil) —

    effective redirect limit



103
104
105
 
# File 'lib/html2rss/config/request_controls.rb', line 103

def max_redirects
  @max_redirects
end

#max_requests ⇒ Integer? (readonly)

Returns effective request budget.

Returns:

  • (Integer, nil) —

    effective request budget



107
108
109
 
# File 'lib/html2rss/config/request_controls.rb', line 107

def max_requests
  @max_requests
end

#strategy ⇒ Symbol? (readonly)

Returns effective request strategy.

Returns:

  • (Symbol, nil) —

    effective request strategy



99
100
101
 
# File 'lib/html2rss/config/request_controls.rb', line 99

def strategy
  @strategy
end

#total_timeout_seconds ⇒ Integer? (readonly)

Returns effective request timeout.

Returns:

  • (Integer, nil) —

    effective request timeout



111
112
113
 
# File 'lib/html2rss/config/request_controls.rb', line 111

def total_timeout_seconds
  @total_timeout_seconds
end

Class Method Details

.from_cli_options(strategy:, max_redirects: nil, max_requests: nil) ⇒ RequestControls

Builds controls from CLI option values. Strategy is explicit when the option was provided (truthy string/symbol), matching Thor option presence.

Parameters:

  • strategy (Symbol, String, nil)
  • max_redirects (Integer, nil) (defaults to: nil)
  • max_requests (Integer, nil) (defaults to: nil)

Returns:



70
71
72
73
74
75
76
77
 
# File 'lib/html2rss/config/request_controls.rb', line 70

def self.from_cli_options(strategy:, max_redirects: nil, max_requests: nil)
  strategy_sym = strategy&.to_sym
  keys = []
  keys << :strategy if strategy
  keys << :max_redirects unless max_redirects.nil?
  keys << :max_requests unless max_requests.nil?
  new(strategy: strategy_sym, max_redirects:, max_requests:, explicit_keys: keys)
end

.from_config(config) ⇒ RequestControls

Returns request controls extracted from the config hash.

Parameters:

  • config (Hash{Symbol => Object}) —

    raw config input

Returns:



16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/html2rss/config/request_controls.rb', line 16

def self.from_config(config)
  HashUtil.assert_symbol_keys!(config, context: 'config', deep: false)
  HashUtil.assert_symbol_keys!(config[:request], context: 'config[:request]') if config[:request].is_a?(Hash)

  new(
    strategy: config[:strategy],
    max_redirects: request_value_for(config, :max_redirects),
    max_requests: request_value_for(config, :max_requests),
    total_timeout_seconds: request_value_for(config, :total_timeout_seconds),
    explicit_keys: explicit_keys_for(config)
  )
end

.from_shortcut(strategy:, max_redirects: nil, max_requests: nil) ⇒ RequestControls

Builds controls for public API shortcuts (Html2rss.auto_source, etc.). Strategy is explicit only when non-nil and not the configured default.

Parameters:

  • strategy (Symbol, nil)
  • max_redirects (Integer, nil) (defaults to: nil)
  • max_requests (Integer, nil) (defaults to: nil)

Returns:



54
55
56
57
58
59
60
 
# File 'lib/html2rss/config/request_controls.rb', line 54

def self.from_shortcut(strategy:, max_redirects: nil, max_requests: nil)
  keys = []
  keys << :strategy unless strategy.nil? || strategy == Config.default_strategy_name
  keys << :max_redirects unless max_redirects.nil?
  keys << :max_requests unless max_requests.nil?
  new(strategy:, max_redirects:, max_requests:, explicit_keys: keys)
end

Instance Method Details

#apply_to(config) ⇒ Hash{Symbol => Object}

Applies only explicitly set controls to the provided config hash.

Parameters:

  • config (Hash{Symbol => Object}) —

    mutable config hash

Returns:

  • (Hash{Symbol => Object}) —

    the same hash with explicit controls written



141
142
143
144
145
146
147
 
# File 'lib/html2rss/config/request_controls.rb', line 141

def apply_to(config)
  config[:strategy] = strategy if explicit?(:strategy)
  apply_request_value(config, :max_redirects, max_redirects)
  apply_request_value(config, :max_requests, max_requests)
  apply_request_value(config, :total_timeout_seconds, total_timeout_seconds)
  config
end

#explicit?(name) ⇒ Boolean

Returns whether the control was explicitly supplied.

Parameters:

  • name (Symbol, String) —

    request control name

Returns:

  • (Boolean) —

    whether the control was explicitly supplied



116
117
118
 
# File 'lib/html2rss/config/request_controls.rb', line 116

def explicit?(name)
  explicit_keys.include?(name.to_sym)
end

#with_effective_values(strategy:, max_redirects:, max_requests:, total_timeout_seconds:) ⇒ RequestControls

Returns controls updated with validated effective values.

Parameters:

  • strategy (Symbol, nil) —

    validated request strategy

  • max_redirects (Integer, nil) —

    validated redirect limit

  • max_requests (Integer, nil) —

    validated request budget

  • total_timeout_seconds (Integer, nil) —

    validated request timeout

Returns:



126
127
128
129
130
131
132
133
134
 
# File 'lib/html2rss/config/request_controls.rb', line 126

def with_effective_values(strategy:, max_redirects:, max_requests:, total_timeout_seconds:)
  self.class.new(
    strategy:,
    max_redirects:,
    max_requests:,
    total_timeout_seconds:,
    explicit_keys:
  )
end