File: received_field.rb

package info (click to toggle)
ruby-mail 2.6.4%2Bdfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 4,256 kB
  • ctags: 1,327
  • sloc: ruby: 44,678; makefile: 3
file content (76 lines) | stat: -rw-r--r-- 1,765 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
# encoding: utf-8
# frozen_string_literal: true
# 
# trace           =       [return]
#                         1*received
# 
# return          =       "Return-Path:" path CRLF
# 
# path            =       ([CFWS] "<" ([CFWS] / addr-spec) ">" [CFWS]) /
#                         obs-path
# 
# received        =       "Received:" name-val-list ";" date-time CRLF
# 
# name-val-list   =       [CFWS] [name-val-pair *(CFWS name-val-pair)]
# 
# name-val-pair   =       item-name CFWS item-value
# 
# item-name       =       ALPHA *(["-"] (ALPHA / DIGIT))
# 
# item-value      =       1*angle-addr / addr-spec /
#                          atom / domain / msg-id
# 
module Mail
  class ReceivedField < StructuredField
    
    FIELD_NAME = 'received'
    CAPITALIZED_FIELD = 'Received'
    
    def initialize(value = nil, charset = 'utf-8')
      self.charset = charset
      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, value), charset)
      self.parse
      self

    end
    
    def parse(val = value)
      unless Utilities.blank?(val)
        @element = Mail::ReceivedElement.new(val)
      end
    end
    
    def element
      @element ||= Mail::ReceivedElement.new(value)
    end
    
    def date_time
      @datetime ||= ::DateTime.parse("#{element.date_time}")
    end

    def info
      element.info
    end
   
    def formatted_date
      date_time.strftime("%a, %d %b %Y %H:%M:%S ") + date_time.zone.delete(':')
    end
 
    def encoded
      if Utilities.blank?(value)
        "#{CAPITALIZED_FIELD}: \r\n"
      else
        "#{CAPITALIZED_FIELD}: #{info}; #{formatted_date}\r\n"
      end
    end
    
    def decoded
      if Utilities.blank?(value)
        ""
      else
        "#{info}; #{formatted_date}" 
      end
    end
    
  end
end