Class: Html2rss::Item

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

Overview

Takes the selected Nokogiri::HTML and responds to accessor names defined in the feed config.

Instances can only be created via ‘.from_url` and each represents an internally used “RSS item”. Such an item provides dynamically defined attributes as methods.

Defined Under Namespace

Classes: Context, Enclosure

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(xml, config) ⇒ Item

Returns a new instance of Item.

Parameters:



37
38
39
40
 
# File 'lib/html2rss/item.rb', line 37

def initialize(xml, config)
  @xml = xml
  @config = config
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_name, *_args) ⇒ String

Dynamically extracts data based on the method name.

Parameters:

  • method_name (Symbol)
  • _args (Array)

Returns:

  • (String) —

    extracted value for the selector.



60
61
62
63
64
 
# File 'lib/html2rss/item.rb', line 60

def method_missing(method_name, *_args)
  return super unless respond_to_missing?(method_name)

  extract(method_name)
end

Class Method Details

.from_url(url, config) ⇒ Array<Html2rss::Item>

Fetches items from a given URL using configuration settings.

Parameters:

  • url (String) —

    URL to fetch items from.

  • config (Html2rss::Config) —

    Configuration object.

Returns:



25
26
27
28
29
30
31
32
 
# File 'lib/html2rss/item.rb', line 25

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

Instance Method Details

#categories ⇒ Array<String>

Retrieves categories for the item based on configured category selectors.

Returns:

  • (Array<String>) —

    list of categories.



112
113
114
 
# File 'lib/html2rss/item.rb', line 112

def categories
  config.category_selector_names.map { |method_name| public_send(method_name) }
end

#enclosure ⇒ Enclosure

Retrieves enclosure details for the item.

Returns:



128
129
130
131
132
133
134
135
136
137
138
 
# File 'lib/html2rss/item.rb', line 128

def enclosure
  url = enclosure_url

  raise 'An item.enclosure requires an absolute URL' unless url&.absolute?

  Enclosure.new(
    type: Html2rss::Utils.guess_content_type_from_url(url),
    bits_length: 0,
    url: url.to_s
  )
end

#enclosure? ⇒ true, false

Checks if the item has an enclosure based on configuration.

Returns:

  • (true, false) 


120
121
122
 
# File 'lib/html2rss/item.rb', line 120

def enclosure?
  config.selector?(:enclosure)
end

#extract(tag) ⇒ String

Selects and processes data according to the selector name.

Parameters:

  • tag (Symbol)

Returns:

  • (String) —

    the extracted value for the selector.



71
72
73
74
75
76
77
78
 
# File 'lib/html2rss/item.rb', line 71

def extract(tag)
  attribute_options = config.selector_attributes_with_channel(tag.to_sym)

  post_process(
    ItemExtractors.item_extractor_factory(attribute_options, xml).get,
    attribute_options.fetch(:post_process, false)
  )
end

#guid ⇒ String

Returns SHA1 hashed GUID.

Returns:

  • (String) —

    SHA1 hashed GUID.



102
103
104
105
106
 
# File 'lib/html2rss/item.rb', line 102

def guid
  content = config.guid_selector_names.flat_map { |method_name| public_send(method_name) }.join

  Digest::SHA1.hexdigest(content)
end

#respond_to_missing?(method_name, _include_private = false) ⇒ true, false

Checks if the object responds to a method dynamically based on the configuration.

Parameters:

  • method_name (Symbol)
  • _include_private (true, false) (defaults to: false)

Returns:

  • (true, false) 


50
51
52
 
# File 'lib/html2rss/item.rb', line 50

def respond_to_missing?(method_name, _include_private = false)
  config.selector?(method_name) || super
end

#title_or_description ⇒ String?

Returns either the title or the description, preferring title if available.

Returns:

  • (String, nil) 


93
94
95
96
97
 
# File 'lib/html2rss/item.rb', line 93

def title_or_description
  return title if config.selector?(:title)

  description if config.selector?(:description)
end

#valid? ⇒ true, false

Checks if the item is valid accordin to RSS 2.0 spec, by ensuring it has at least a title or a description.

Returns:

  • (true, false) 


85
86
87
 
# File 'lib/html2rss/item.rb', line 85

def valid?
  title_or_description.to_s != ''
end