Class: SPF::Query::Record

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/spf/query/record.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(version, rules = []) ⇒ Record

Initializes the SPF record.

Parameters:

  • version (:spf1) —

    The SPF version.

  • rules (Array<Mechanism, Modifier>) (defaults to: []) —

    SPF rules.



93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'lib/spf/query/record.rb', line 93

def initialize(version,rules=[])
  @version = version
  @rules   = rules

  @mechanisms = @rules.select { |term| term.kind_of?(Mechanism) }
  @modifiers  = @rules.select { |term| term.kind_of?(Modifier)  }

  # prefer the last `all:` mechanism
  @all = @mechanisms.reverse_each.find do |mechanism|
    mechanism.name == :all
  end

  mechanisms_by_name = lambda { |name|
    @mechanisms.select { |mechanism| mechanism.name == name }
  }

  @include = mechanisms_by_name[:include]
  @a       = mechanisms_by_name[:a]
  @mx      = mechanisms_by_name[:mx]
  @ptr     = mechanisms_by_name[:ptr]
  @ip4     = mechanisms_by_name[:ip4]
  @ip6     = mechanisms_by_name[:ip6]
  @exists  = mechanisms_by_name[:exists]

  modifier_by_name = lambda { |name|
    @modifiers.find { |modifier| modifier.name == name }
  }

  @redirect = modifier_by_name[:redirect]
  @exp      = modifier_by_name[:exp]
end

Instance Attribute Details

#a ⇒ Array<Mechanism> (readonly)

Selects all a: mechanisms.

Returns:



47
48
49
 
# File 'lib/spf/query/record.rb', line 47

def a
  @a
end

#all ⇒ Mechanism? (readonly)

The right-most all: mechanism.

Returns:



37
38
39
 
# File 'lib/spf/query/record.rb', line 37

def all
  @all
end

#exists ⇒ Array<Mechanism> (readonly)

Selects all exists: mechanisms.

Returns:



72
73
74
 
# File 'lib/spf/query/record.rb', line 72

def exists
  @exists
end

#exp ⇒ Modifier? (readonly)

The exp= modifier.

Returns:



82
83
84
 
# File 'lib/spf/query/record.rb', line 82

def exp
  @exp
end

#include ⇒ Array<Mechanism> (readonly)

Selects all include: mechanisms.

Returns:



42
43
44
 
# File 'lib/spf/query/record.rb', line 42

def include
  @include
end

#ip4 ⇒ Array<Mechanism> (readonly)

Selects all ip4: mechanisms.

Returns:



62
63
64
 
# File 'lib/spf/query/record.rb', line 62

def ip4
  @ip4
end

#ip6 ⇒ Array<Mechanism> (readonly)

Selects all ip6: mechanisms.

Returns:



67
68
69
 
# File 'lib/spf/query/record.rb', line 67

def ip6
  @ip6
end

#mechanisms ⇒ Array<Mechanism> (readonly)

All mechanisms within the record.

Returns:



27
28
29
 
# File 'lib/spf/query/record.rb', line 27

def mechanisms
  @mechanisms
end

#modifiers ⇒ Array<Modifier> (readonly)

All modifiers within the record.

Returns:



32
33
34
 
# File 'lib/spf/query/record.rb', line 32

def modifiers
  @modifiers
end

#mx ⇒ Array<Mechanism> (readonly)

Selects all mx: mechanisms.

Returns:



52
53
54
 
# File 'lib/spf/query/record.rb', line 52

def mx
  @mx
end

#ptr ⇒ Array<Mechanism> (readonly)

Selects all ptr: mechanisms.

Returns:



57
58
59
 
# File 'lib/spf/query/record.rb', line 57

def ptr
  @ptr
end

#redirect ⇒ Modifier? (readonly)

The redirect= modifier.

Returns:



77
78
79
 
# File 'lib/spf/query/record.rb', line 77

def redirect
  @redirect
end

#rules ⇒ Array<Mechanism, Modifier> (readonly)

The SPF rules.

Returns:



22
23
24
 
# File 'lib/spf/query/record.rb', line 22

def rules
  @rules
end

#version ⇒ :spf1 (readonly) Also known as: v

The SPF version of the record.

Returns:

  • (:spf1) 


16
17
18
 
# File 'lib/spf/query/record.rb', line 16

def version
  @version
end

Class Method Details

.parse(spf) ⇒ Record

Parses an SPF record.

Parameters:

  • spf (String) —

    The raw SPF record.

Returns:

  • (Record) —

    The parsed SPF record.

Raises:

See Also:



143
144
145
146
147
148
149
150
151
152
153
 
# File 'lib/spf/query/record.rb', line 143

def self.parse(spf)
  if spf.include?('spf2.0')
    raise(SenderIDFound,"Sender ID was found in place of SPF")
  end

  begin
    Parser.parse(spf)
  rescue Parslet::ParseFailed => error
    raise(InvalidRecord.new(error.message,error.cause))
  end
end

.query(domain, resolver = Resolv::DNS.new) ⇒ Record?

Queries the domain for it's SPF record.

Parameters:

  • domain (String) —

    The domain to query.

  • resolver (Resolv::DNS) (defaults to: Resolv::DNS.new) —

    The optional resolver to use.

Returns:

  • (Record, nil) —

    The parsed SPF record. If no SPF record could be found, nil will be returned.



170
171
172
173
174
 
# File 'lib/spf/query/record.rb', line 170

def self.query(domain,resolver=Resolv::DNS.new)
  if (spf = Query.query(domain,resolver))
    parse(spf)
  end
end

Instance Method Details

#each {|rule| ... } ⇒ Enumerator

Enumerates over the rules.

Yields:

  • (rule) —

    The given block will be passed each rule.

Yield Parameters:

Returns:

  • (Enumerator) —

    If no block is given, an Enumerator will be returned.



188
189
190
 
# File 'lib/spf/query/record.rb', line 188

def each(&block)
  @rules.each(&block)
end

#inspect ⇒ String

Inspects the record.

Returns:

  • (String) 


206
207
208
 
# File 'lib/spf/query/record.rb', line 206

def inspect
  "#<#{self.class}: #{self}>"
end

#to_s ⇒ String

Converts the record back to a String.

Returns:

  • (String) 


197
198
199
 
# File 'lib/spf/query/record.rb', line 197

def to_s
  "v=#{@version} #{@rules.join(' ')}"
end