Module: Html2rss::Test

Defined in:
lib/html2rss/test.rb,
lib/html2rss/test/enhance_audit.rb

Overview

Service that runs schema validation and live feed extraction on a configuration, enforcing minimum item thresholds and capturing sample output.

Defined Under Namespace

Modules: EnhanceAudit Classes: FailureKind, QualityReport, Result

Class Method Summary collapse

Class Method Details

.call(config_input, feed_name = nil, min_items: 1, params: {}, strategy: nil, strict_quality: false, compare_enhance: false) ⇒ Html2rss::Test::Result

Tests a configuration by validating schema and executing live feed extraction.

Parameters:

  • config_input (Hash, String) —

    config hash, YAML string, or file path

  • feed_name (String, nil) (defaults to: nil) —

    optional feed name for multi-feed files

  • min_items (Integer) (defaults to: 1) —

    minimum extracted items required to pass

  • params (Hash) (defaults to: {}) —

    optional dynamic feed parameters

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

    optional strategy override

  • strict_quality (Boolean) (defaults to: false) —

    when true, fail on ship-quality audit thresholds

  • compare_enhance (Boolean) (defaults to: false) —

    diagnostic enhance off vs on comparison on cached HTML

Returns:



172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
 
# File 'lib/html2rss/test.rb', line 172

def call(config_input, feed_name = nil, min_items: 1, params: {}, strategy: nil, # rubocop:disable Metrics/ParameterLists, Metrics/MethodLength, Metrics/AbcSize, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
         strict_quality: false, compare_enhance: false)
  raw_config, validation = Config.resolve_and_validate(config_input, feed_name:, params:)
  return validation_failure_result(validation.errors.to_h, raw_config) unless validation.success?

  raw_config[:strategy] = strategy.to_sym if strategy
  raw_config[:params] = params if params&.any?

  started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
  begin
    feed_result, pipeline_outcome = extract_feed(raw_config)
    duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started

    rss_doc = feed_result.to_rss
    rss_xml = rss_doc.to_s
    item_count = rss_doc.items.size
    sample_items = extract_samples(rss_doc.items)
    quality_report = quality_report_for(
      rss_doc.items,
      channel_url: raw_config.dig(:channel, :url).to_s,
      raw_config:,
      feed_result:,
      pipeline_outcome:
    )
    enhance_compare = build_enhance_compare(raw_config, pipeline_outcome) if compare_enhance

    channel_title = feed_result.channel_title
    channel_url = raw_config.dig(:channel, :url).to_s
    strategy_used = feed_result.status.selected_strategy || raw_config[:strategy] ||
                    RequestService.default_strategy_name
    min_items_passed = item_count >= min_items
    quality_failed = strict_quality && min_items_passed && quality_failure?(quality_report)
    passed = min_items_passed && !quality_failed
    failure_kind, error_message = outcome_failure(min_items_passed:, quality_failed:, item_count:, min_items:,
                                                  quality_report:)

    log_strict_quality_failure(failure_kind, item_count) if quality_failed

    Result.new(
      success: passed,
      item_count:,
      sample_items:,
      channel_title:,
      channel_url:,
      strategy_used:,
      duration_seconds: duration.round(3),
      validation_errors: nil,
      error_message:,
      failure_kind:,
      rss: passed ? rss_xml : nil,
      quality_report:,
      enhance_compare:
    )
  rescue StandardError => error
    duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started
    execution_failure_result(error, raw_config, duration)
  end
end

.quality_report_for(items, channel_url:, raw_config:, feed_result:, pipeline_outcome:, probe_native_feed: true) ⇒ QualityReport

Builds a ship-quality report for RSS items (shared by test and MCP apply).

Parameters:

Returns:



252
253
254
255
256
257
258
259
 
# File 'lib/html2rss/test.rb', line 252

def quality_report_for(items, channel_url:, raw_config:, feed_result:, pipeline_outcome:, # rubocop:disable Metrics/ParameterLists
                       probe_native_feed: true)
  audit = AutoSource::Cleanup.audit_feed_items(items)
  native_feed = probe_native_feed ? probe_native_feed_url(channel_url, raw_config)&.to_s : nil
  report = QualityReport.from_audit(audit, native_feed:)
  report = append_url_mismatch_warning(report, channel_url, feed_result)
  merge_enhance_audit(report, raw_config, pipeline_outcome)
end