Class: Html2rss::Selectors::PostProcessors::Base

Inherits:
Object
  • Object
show all
Defined in:
lib/html2rss/selectors/post_processors/base.rb

Overview

All post processors must inherit from this base class and implement self.validate_args! and #get.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(value, context) ⇒ Base

Initializes the post processor

Parameters:

  • value (Object) —

    the value to be processed

  • context (Selectors::Context) —

    the context



53
54
55
56
57
58
59
60
61
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 53

def initialize(value, context)
  klass = self.class
  # TODO: get rid of Hash
  klass.assert_type(context, [Selectors::Context, Hash], 'context', context:)
  klass.validate_args!(value, context)

  @value = value
  @context = context
end

Instance Attribute Details

#context ⇒ Object (readonly)

Returns the value of attribute context.



63
64
65
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 63

def context
  @context
end

#value ⇒ Object (readonly)

Returns the value of attribute value.



63
64
65
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 63

def value
  @value
end

Class Method Details

.assert_type(value, types = [], name, context:) ⇒ Object

Asserts that the value is of the expected type(s)

Parameters:

  • value (Object) —

    the value to check

  • types (Array<Class>, Class) (defaults to: []) —

    the expected type(s)

  • name (String) —

    the name of the option being checked

  • context (Selectors::Context) —

    the context

Raises:

  • (InvalidType) —

    if the value is not of the expected type(s)



30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 30

def self.assert_type(value, types = [], name, context:)
  return if Array(types).any? { |type| value.is_a?(type) }

  options = if context.is_a?(Hash)
              context[:options]
            else
              { file: File.basename(caller(1, 1).first.split(':').first) }
            end
  message = "The type of `#{name}` must be #{Array(types).join(' or ')}, " \
            "but is: #{value.class} in: #{options.inspect}"
  raise InvalidType, message, [], cause: nil
end

.expect_options(keys, context) ⇒ Object

Validates the presence of required options in the context

Parameters:

  • keys (Array<Symbol>) —

    the keys to check for presence

  • context (Hash) —

    the context containing options

Raises:



14
15
16
17
18
19
20
21
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 14

def self.expect_options(keys, context)
  keys.each do |key|
    unless (options = context[:options]).key?(key)
      raise MissingOption, "The `#{key}` option is missing in: #{options.inspect}", [],
            cause: nil
    end
  end
end

.validate_args!(_value, _context) ⇒ Object

This method validates the arguments passed to the post processor. Must be implemented by subclasses.

Raises:

  • (NotImplementedError) 


45
46
47
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 45

def self.validate_args!(_value, _context)
  raise NotImplementedError, 'You must implement the `validate_args!` method in the post processor'
end

Instance Method Details

#get ⇒ Object

Abstract method to be implemented by subclasses

Raises:

  • (NotImplementedError) —

    if not implemented in subclass



68
69
70
 
# File 'lib/html2rss/selectors/post_processors/base.rb', line 68

def get
  raise NotImplementedError, 'You must implement the `get` method in the post processor'
end