File: return_path_field.rb

package info (click to toggle)
ruby-mail 2.9.0%2Bdfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 5,720 kB
  • sloc: ruby: 73,664; makefile: 3
file content (60 lines) | stat: -rw-r--r-- 1,525 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
# encoding: utf-8
# frozen_string_literal: true

module Mail
  # 4.4.3.  REPLY-TO / RESENT-REPLY-TO
  #
  #    Note:  The "Return-Path" field is added by the mail  transport
  #           service,  at the time of final deliver.  It is intended
  #           to identify a path back to the orginator  of  the  mes-
  #           sage.   The  "Reply-To"  field  is added by the message
  #           originator and is intended to direct replies.
  #
  # 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
  #
  class ReturnPathField < CommonAddressField #:nodoc:
    NAME = 'Return-Path'

    def self.singular?
      true
    end

    def initialize(value = nil, charset = nil)
      if value == '<>'
        super nil, charset
      else
        super
      end
    end

    def default
      address
    end

    private
      def do_encode
        "#{name}: <#{address}>\r\n"
      end

      def do_decode
        address
      end
  end
end