tmail 1.2.3.1 → 1.2.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (158) hide show
  1. data/README +10 -0
  2. data/ext/tmailscanner/tmail/tmailscanner.c +39 -8
  3. data/lib/tmail.rb +1 -0
  4. data/lib/tmail/address.rb +6 -40
  5. data/lib/tmail/attachments.rb +41 -22
  6. data/lib/tmail/encode.rb +9 -0
  7. data/lib/tmail/header.rb +5 -3
  8. data/lib/tmail/interface.rb +40 -3
  9. data/lib/tmail/mail.rb +3 -3
  10. data/lib/tmail/mailbox.rb +3 -2
  11. data/lib/tmail/net.rb +3 -1
  12. data/lib/tmail/parser.rb +204 -620
  13. data/lib/tmail/parser.y +38 -3
  14. data/lib/tmail/quoting.rb +38 -1
  15. data/lib/tmail/utils.rb +28 -4
  16. data/lib/tmail/vendor/rchardet-1.3/COPYING +504 -0
  17. data/lib/tmail/vendor/rchardet-1.3/README +12 -0
  18. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet.rb +67 -0
  19. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/big5freq.rb +927 -0
  20. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/big5prober.rb +42 -0
  21. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/chardistribution.rb +237 -0
  22. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/charsetgroupprober.rb +112 -0
  23. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/charsetprober.rb +75 -0
  24. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/codingstatemachine.rb +64 -0
  25. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/constants.rb +42 -0
  26. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/escprober.rb +90 -0
  27. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/escsm.rb +244 -0
  28. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/eucjpprober.rb +88 -0
  29. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/euckrfreq.rb +596 -0
  30. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/euckrprober.rb +42 -0
  31. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/euctwfreq.rb +430 -0
  32. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/euctwprober.rb +42 -0
  33. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/gb2312freq.rb +474 -0
  34. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/gb2312prober.rb +42 -0
  35. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/hebrewprober.rb +289 -0
  36. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/jisfreq.rb +570 -0
  37. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/jpcntx.rb +229 -0
  38. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langbulgarianmodel.rb +229 -0
  39. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langcyrillicmodel.rb +330 -0
  40. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langgreekmodel.rb +227 -0
  41. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langhebrewmodel.rb +202 -0
  42. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langhungarianmodel.rb +226 -0
  43. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/langthaimodel.rb +201 -0
  44. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/latin1prober.rb +147 -0
  45. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/mbcharsetprober.rb +89 -0
  46. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/mbcsgroupprober.rb +47 -0
  47. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/mbcssm.rb +542 -0
  48. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/sbcharsetprober.rb +124 -0
  49. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/sbcsgroupprober.rb +58 -0
  50. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/sjisprober.rb +88 -0
  51. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/universaldetector.rb +166 -0
  52. data/lib/tmail/vendor/rchardet-1.3/lib/rchardet/utf8prober.rb +87 -0
  53. data/lib/tmail/version.rb +1 -1
  54. data/setup.rb +2 -2
  55. data/test/fixtures/apple_unquoted_content_type +44 -0
  56. data/test/fixtures/inline_attachment.txt +2095 -0
  57. data/test/fixtures/iso_8859_1_email_without_encoding_and_message_id.txt +16 -0
  58. data/test/fixtures/mailbox.zip +0 -0
  59. data/test/fixtures/marked_as_iso_8859_1_but_it_is_utf_8.txt +33 -0
  60. data/test/fixtures/marked_as_utf_8_but_it_is_iso_8859_1.txt +56 -0
  61. data/test/fixtures/raw_email_bad_time +62 -0
  62. data/test/fixtures/raw_email_double_at_in_header +14 -0
  63. data/test/fixtures/raw_email_only_attachment +17 -0
  64. data/test/fixtures/raw_email_string_in_date_field +17 -0
  65. data/test/fixtures/raw_email_trailing_dot +21 -0
  66. data/test/fixtures/raw_email_with_quoted_attachment_filename +60 -0
  67. data/test/fixtures/raw_email_with_wrong_splitted_multibyte_encoded_word_subject +15 -0
  68. data/test/fixtures/the_only_part_is_a_word_document.txt +425 -0
  69. data/test/fixtures/unquoted_filename_in_attachment +177 -0
  70. data/test/test_address.rb +114 -92
  71. data/test/test_attachments.rb +84 -1
  72. data/test/test_encode.rb +54 -0
  73. data/test/test_header.rb +60 -2
  74. data/test/test_mail.rb +22 -15
  75. data/test/test_mbox.rb +12 -3
  76. data/test/test_port.rb +13 -9
  77. data/test/test_quote.rb +9 -0
  78. data/tmail.gemspec +34 -0
  79. metadata +68 -167
  80. data/MANIFEST +0 -191
  81. data/log/BugTrackingLog.txt +0 -1231
  82. data/log/Changelog.txt +0 -534
  83. data/log/Fixme.txt +0 -6
  84. data/log/Testlog.txt +0 -2340
  85. data/log/Todo.txt +0 -30
  86. data/log/fixme.rdoc +0 -6
  87. data/meta/MANIFEST +0 -128
  88. data/meta/VERSION +0 -1
  89. data/meta/project.yaml +0 -30
  90. data/meta/unixname +0 -1
  91. data/sample/bench_base64.rb +0 -48
  92. data/sample/data/multipart +0 -23
  93. data/sample/data/normal +0 -29
  94. data/sample/data/sendtest +0 -5
  95. data/sample/data/simple +0 -14
  96. data/sample/data/test +0 -27
  97. data/sample/extract-attachements.rb +0 -33
  98. data/sample/from-check.rb +0 -26
  99. data/sample/multipart.rb +0 -26
  100. data/sample/parse-bench.rb +0 -68
  101. data/sample/parse-test.rb +0 -19
  102. data/sample/sendmail.rb +0 -94
  103. data/site/contributing/index.html +0 -183
  104. data/site/css/clean.css +0 -27
  105. data/site/css/layout.css +0 -31
  106. data/site/css/style.css +0 -60
  107. data/site/download/index.html +0 -61
  108. data/site/img/envelope.jpg +0 -0
  109. data/site/img/mailman.gif +0 -0
  110. data/site/img/stamp-sm.jpg +0 -0
  111. data/site/img/stamp.jpg +0 -0
  112. data/site/img/stampborder.jpg +0 -0
  113. data/site/img/tfire.jpg +0 -0
  114. data/site/img/tmail.png +0 -0
  115. data/site/index.html +0 -270
  116. data/site/js/jquery.js +0 -31
  117. data/site/log/Changelog.xsl +0 -33
  118. data/site/log/changelog.xml +0 -1677
  119. data/site/outdated/BUGS +0 -3
  120. data/site/outdated/DEPENDS +0 -1
  121. data/site/outdated/Incompatibilities +0 -89
  122. data/site/outdated/Incompatibilities.ja +0 -102
  123. data/site/outdated/NEWS +0 -9
  124. data/site/outdated/README.ja +0 -73
  125. data/site/outdated/doc.ja/address.html +0 -275
  126. data/site/outdated/doc.ja/basics.html +0 -405
  127. data/site/outdated/doc.ja/config.html +0 -49
  128. data/site/outdated/doc.ja/details.html +0 -146
  129. data/site/outdated/doc.ja/index.html +0 -39
  130. data/site/outdated/doc.ja/mail.html +0 -793
  131. data/site/outdated/doc.ja/mailbox.html +0 -265
  132. data/site/outdated/doc.ja/port.html +0 -95
  133. data/site/outdated/doc.ja/tmail.html +0 -58
  134. data/site/outdated/doc.ja/usage.html +0 -202
  135. data/site/outdated/rdd/address.rrd.m +0 -229
  136. data/site/outdated/rdd/basics.rd.m +0 -275
  137. data/site/outdated/rdd/config.rrd.m +0 -26
  138. data/site/outdated/rdd/details.rd.m +0 -117
  139. data/site/outdated/rdd/index.rhtml.m +0 -54
  140. data/site/outdated/rdd/mail.rrd.m +0 -701
  141. data/site/outdated/rdd/mailbox.rrd.m +0 -228
  142. data/site/outdated/rdd/port.rrd.m +0 -69
  143. data/site/outdated/rdd/tmail.rrd.m +0 -33
  144. data/site/outdated/rdd/usage.rd.m +0 -247
  145. data/site/quickstart/index.html +0 -69
  146. data/site/quickstart/quickstart.html +0 -52
  147. data/site/quickstart/usage.html +0 -193
  148. data/site/reference/address.html +0 -247
  149. data/site/reference/config.html +0 -30
  150. data/site/reference/index.html +0 -101
  151. data/site/reference/mail.html +0 -726
  152. data/site/reference/mailbox.html +0 -245
  153. data/site/reference/port.html +0 -75
  154. data/site/reference/tmail.html +0 -35
  155. data/work/script/make +0 -26
  156. data/work/script/rdoc +0 -39
  157. data/work/script/setup +0 -1616
  158. data/work/script/test +0 -30
data/site/quickstart/index.html DELETED
@@ -1,69 +0,0 @@
1
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
- <html lang="en">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=utf8">
5
- <meta http-equiv="Content-Language" content="en">
6
-
7
- <link rel="stylesheet" href="../css/clean.css" type="text/css" media="screen, projection, print"/>
8
- <link rel="stylesheet" href="../css/layout.css" type="text/css" media="screen, projection, print"/>
9
- <link rel="stylesheet" href="../css/style.css" type="text/css" media="screen, projection, print"/>
10
-
11
- <link rel="icon" href="../img/tfire.jpg" type="image/x-icon"/>
12
-
13
- <title>TMail &mdash; Quick Start Guide</title>
14
-
15
- <script type="text/javascript" src="../js/jquery.js"></script>
16
-
17
- <script>
18
- $(document).ready(function(){
19
- $('#quickstart').load('quickstart.html');
20
- $('#usage').load('usage.html');
21
- });
22
- </script>
23
-
24
- </head>
25
- <body>
26
- <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
27
- </script>
28
- <script type="text/javascript">
29
- _uacct = "UA-2871747-1";
30
- urchinTracker();
31
- </script>
32
-
33
- <div class="container">
34
-
35
- <div class="logo">
36
- <img src="../img/stamp-sm.jpg"/>
37
- </div>
38
-
39
- <div class="title">
40
- <h1>TMail</h1>
41
- <h2>Ruby on Mail</h2>
42
- </div>
43
-
44
- <div class="menu">
45
- &nbsp;
46
- <a href="../index.html">Home</a> &nbsp;&nbsp;
47
- <a href="../quickstart/index.html">Quickstart</a> &nbsp;&nbsp;
48
- <a href="http://lindsaar.net/tmail/" onClick="javascript:urchinTracker('/outgoing/rubyforge.org/blog_page');">Blog</a> &nbsp;&nbsp;
49
- <a href="http://rubyforge.org/frs/?group_id=4512" onClick="javascript:urchinTracker('/outgoing/rubyforge.org/download_page');">Download</a> &nbsp;&nbsp;
50
- <a href="http://rubyforge.org/mailman/listinfo/tmail-talk">Mailing List</a> &nbsp;&nbsp;
51
- <a href="../reference/index.html">Reference</a> &nbsp;&nbsp;
52
- <a href="../rdoc/index.html">RDocs</a> &nbsp;&nbsp;
53
- <a href="http://rubyforge.org/projects/tmail/" onClick="javascript:urchinTracker('/outgoing/rubyforge.org/project_page');">Project</a> &nbsp;&nbsp;
54
- <a href="../contributing/index.html">Contributing</a>
55
- </div>
56
-
57
- <div class="main">
58
- <div id="quickstart"></div>
59
-
60
- <div id="usage" ></div>
61
- </div>
62
-
63
- <div class="footer">
64
- Copyright (c) 2007 TMail Project &reg; All Rights Reserved
65
- </div>
66
-
67
- </div>
68
- </body>
69
- </html>
data/site/quickstart/quickstart.html DELETED
@@ -1,52 +0,0 @@
1
- <h1>TMail Quick Start Guide</h1>
2
-
3
- <div class="guide">
4
- <p>TMail is an E-Mail handling library. It provides you with access to
5
- any email you wrap it around as an object.</p>
6
-
7
- <h2>Unix like OSes</h2>
8
-
9
- <ol>
10
- <li>
11
- Download the <a href="../download/index.html">
12
- latest release</a> gem from the RubyForge TMail project.
13
- </li>
14
- <li>
15
- Run gem install from the directory where you saved the gem:
16
-
17
- <pre class="shell">
18
- $ gem install tmail
19
- </pre>
20
-
21
- </li>
22
- <li>
23
- That's it!
24
- <br />
25
- <br />
26
- TMail installs into the ruby_lib_path/gems/ folder just like any other
27
- well behaved gem and allows you to require it thusly:<br />
28
- </li>
29
-
30
- <pre class="shell">
31
- irb(main):001:0> require 'rubygems'
32
- irb(main):002:0> require 'tmail'
33
- irb(main):003:0> email = TMail::Mail.load("my_raw_email.txt")
34
- irb(main):004:0> puts email.to
35
- => mikel@example.com
36
- irb(main):005:0> email.to = 'mikel@somewhere.else.com'
37
- => "mikel@somewhere.else.com"
38
- irb(main):006:0> email.cc = 'mikel@another.place.com'
39
- => mikel@another.place.com
40
- irb(main):007:0> email.destinations
41
- => ["mikel@somewhere.else.com", "mikel@another.place.com"]
42
- </pre>
43
-
44
- </ol>
45
-
46
- <h2>UnUnix like OSes (Windows etc)</h2>
47
-
48
- <p>Just do the same as the above... just gem install tmail. If TMail can
49
- find a compiler on your system, it will compile the native C extensions,
50
- if it can't find a compiler, it will just install the Ruby version. Easy
51
- hey?</p>
52
- </div>
data/site/quickstart/usage.html DELETED
@@ -1,193 +0,0 @@
1
- <h1>General Usage</h1>
2
-
3
- <h2>Abstraction</h2>
4
-
5
- <p>
6
- TMail is designed to be an RFC compatible library. The goal of TMail
7
- is to allow you to create emails programatically without having to know
8
- about the RFCs or how they work, or what their standards are.
9
- </p>
10
-
11
- <h2>Getting information from e-mail</h2>
12
-
13
- <h3>class TMail::Mail</h3>
14
-
15
- <p>
16
- When you use TMail, you need to create a TMail object. There are
17
- three ways you can do this, the first is by parsing a string supplied
18
- to TMail, the second is by loading the mail object from a file, and
19
- the third is by opening up a port to whatever mail source you want.
20
- <br />
21
- <br />
22
- For example:
23
- </p>
24
-
25
- <h4>Loading from string:</h4>
26
-
27
- <pre class="ruby">
28
- require 'tmail'
29
-
30
- mail = TMail::Mail.parse(string) # from String
31
- </pre>
32
-
33
- <h4>Loading from a file:</h4>
34
-
35
- <pre class="ruby">
36
- require 'tmail'
37
-
38
- mail = TMail::Mail.load(filename) # from file
39
- </pre>
40
-
41
- <h4>Using the Port abstraction</h4>
42
-
43
- <p>
44
- The third way to get TMail::Mail object is using the "port".
45
- "port" is the abstruction of mail sources, e.g. strings or file names.
46
- You can get ports by using mail loaders (TMail::*Loader classes).
47
- <br />
48
- <br />
49
- Here's simple example:
50
- </p>
51
-
52
- <pre class="ruby">
53
- require 'tmail'
54
-
55
- loader = TMail::MhLoader.new( '/home/aamine/Mail/inbox' )
56
- loader.each_port do |port|
57
- mail = TMail::Mail.new(port)
58
- # ....
59
- end
60
- </pre>
61
-
62
- <p>This lets you cycle through your messages in the inbox</p>
63
-
64
- <h3>Accessing EMail Attributes via TMail::Mail object</h3>
65
-
66
- <p>
67
- Once you have the Email loaded, you can now access the various parts
68
- of the email, using various methods on the now instantiated TMail::Mail
69
- object.
70
- <br />
71
- <br />
72
- For example...
73
- </p>
74
-
75
- <h4>
76
- To get who the email is to:
77
- </h4>
78
-
79
- <pre class="ruby">
80
- require 'tmail'
81
-
82
- mail = TMail::Mail.parse( 'To: Minero Aoki &lt;aamine@loveruby.net&gt;' )
83
- p mail.to # =&gt; ["aamine@loveruby.net"]
84
- </pre>
85
-
86
- <h4>
87
- To get the subject:
88
- </h4>
89
-
90
- <pre class="ruby">
91
- p mail.subject
92
- </pre class="ruby">
93
-
94
- <h4>
95
- To get the body of the email:
96
- </h4>
97
-
98
- <pre class="ruby">
99
- p mail.body
100
- </pre>
101
-
102
- <p>
103
- For more information, see the RDoc index and the TMail::Mail class specifically.
104
- </p>
105
-
106
- <h3>MIME multipart emails</h3>
107
-
108
- <p>
109
- TMail also supports MIME multipart mails.
110
- <br />
111
- <br />
112
- If mail is multipart mail, Mail#multipart? returns true,
113
- and Mail#parts contains an array of parts (TMail::Mail object).
114
- </p>
115
-
116
- <pre class="ruby">
117
- require 'tmail'
118
-
119
- mail = TMail::Mail.parse( multipart_mail_string )
120
- if mail.multipart? then
121
- mail.parts.each do |m|
122
- puts m.main_type
123
- end
124
- end
125
- </pre>
126
-
127
- <h2>Creating New Mail</h2>
128
-
129
- <p>Creating an email is just as easy:</p>
130
-
131
- <pre class="ruby">
132
- require 'tmail'
133
-
134
- # Example 1: create mail only in memory
135
- mail = TMail::Mail.new
136
-
137
- # Example 2: create mail on mailbox (on disk)
138
- loader = TMail::MhLoader.new('/home/aamine/Mail/drafts')
139
- mail = TMail::Mail.new( loader.new_port )
140
- </pre>
141
-
142
- <p>
143
- Then fill headers and body.
144
- </p>
145
-
146
- <pre class="ruby">
147
- mail.to = 'test@loveruby.net'
148
- mail.from = 'Minero Aoki &lt;aamine@loveruby.net&gt;'
149
- mail.subject = 'test mail'
150
- mail.date = Time.now
151
- mail.mime_version = '1.0'
152
- mail.set_content_type 'text', 'plain', {'charset'=&gt;'iso-2022-jp'}
153
- mail.body = 'This is test mail.'
154
- </pre>
155
-
156
- <p>
157
- At last, convert mail object to string.
158
- </p>
159
-
160
- <pre class="ruby">
161
- str = mail.to_s
162
- </pre>
163
-
164
- <p>
165
- If you want to write mails against files directly
166
- (without intermediate string), use Mail#write_back.
167
- </p>
168
-
169
- <pre class="ruby">
170
- mail.write_back
171
- </pre>
172
-
173
-
174
- <h3>What TMail is NOT</h3>
175
-
176
- <p>
177
- Right now, TMail does not touch the body of the mail message,
178
- for example, it doesn't encode, decode, handle character sets
179
- etc. It only handles the message and headers and gives you
180
- access to read and write the mail body.
181
- </p>
182
-
183
- <p>
184
- Plans for future versions are to allow better handling of the mail
185
- body, auto decode Base64 and handling attachments in a better way.
186
- </p>
187
-
188
- <h2>Now what?</h2>
189
-
190
- <p>Go to the <a href="../manual/index.html">online manual</a> to find out
191
- how to use it all, or if you are stuck you can join the
192
- <a href="http://rubyforge.org/mailman/listinfo/tmail-talk">TMail-Talk</a>
193
- mailing list and ask your question there.</p>
data/site/reference/address.html DELETED
@@ -1,247 +0,0 @@
1
- <h1>Address Classes</h1>
2
-
3
- <h2><code>class <a name="TMail%3a%3aAddress">TMail::Address</a> </code></h2>
4
-
5
- <h3>Class Methods</h3>
6
-
7
- <dl>
8
- <dt><a name="TMail%3a%3aAddress-parse"><code>parse(str)</code></a> -&gt; <code><a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a></code></dt>
9
- <dd>
10
- <p>
11
- str: String<br>
12
- </p>
13
-
14
- <p>
15
- parses the string and creates a new <code>TMail::Address</code> object.
16
- If the string does not follow the standard internet address format, a
17
- <code>TMail::SyntaxError</code> exception is raised.
18
- </p>
19
-
20
- </dd>
21
- <dt><a name="TMail%3a%3aAddress-new"><code>new(locals, <var>domains</var>)</code></a> -&gt; <code><a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a></code></dt>
22
- <dd>
23
- <p>
24
- locals: [String]<br>
25
- domains: [String]<br>
26
- </p>
27
-
28
- <p>
29
- creates a new <code>TMail::Address</code> object consisting of the local part,
30
- LOCALS and domain part <var>domains</var>.
31
- </p>
32
-
33
- </dd>
34
- </dl>
35
- <h3>Instance Methods</h3>
36
-
37
- <dl>
38
- <dt><a name="TMail%3a%3aAddress-address_group%3f"><code>address_group?</code></a> -&gt; <code>true | false</code></dt>
39
- <dd>
40
- <p>
41
- returns false.
42
- </p>
43
-
44
- </dd>
45
- <dt><a name="TMail%3a%3aAddress-spec"><code>spec</code></a> -&gt; <code>String</code></dt>
46
- <dd>
47
- <p>
48
- an address spec ("....@....").
49
- </p>
50
-
51
- </dd>
52
- <dt><a name="TMail%3a%3aAddress-routes"><code>routes</code></a> -&gt; <code>[String]</code></dt>
53
- <dd>
54
- <p>
55
- delivery routes. Strings do not include character "@".
56
- </p>
57
-
58
- </dd>
59
- <dt><a name="TMail%3a%3aAddress-name"><code>name</code></a> -&gt; <code>String</code></dt>
60
- <dt><a name="TMail%3a%3aAddress-phrase"><code>phrase</code></a> -&gt; <code>String</code></dt>
61
- <dd>
62
- <p>
63
- short description for this address (e.g. real name).
64
- </p>
65
-
66
- </dd>
67
- <dt><a name="TMail%3a%3aAddress-encoded"><code>encoded(eol = "\r\n", <var>encoding</var> = 'j')</code></a> -&gt; <code>String</code></dt>
68
- <dd>
69
- <p>
70
- eol: String<br>
71
- encoding: String<br>
72
- </p>
73
-
74
- <p>
75
- converts this object into MIME-encoded string.
76
- </p>
77
-
78
- </dd>
79
- <dt><a name="TMail%3a%3aAddress-to_s"><code>to_s(eol = "\n", <var>encoding</var> = 'e')</code></a> -&gt; <code>String</code></dt>
80
- <dt><a name="TMail%3a%3aAddress-decoded"><code>decoded(eol = "\n", <var>encoding</var> = 'e')</code></a> -&gt; <code>String</code></dt>
81
- <dd>
82
- <p>
83
- eol: String<br>
84
- encoding: String<br>
85
- </p>
86
-
87
- <p>
88
- converts this object into decoded string.
89
- </p>
90
-
91
- </dd>
92
- <dt><a name="TMail%3a%3aAddress-%3d%3d"><code>==(other)</code></a> -&gt; <code>true | false</code></dt>
93
- <dd>
94
- <p>
95
- other: Object<br>
96
- </p>
97
-
98
- <p>
99
- judge if self equals to other by inspecting addr-spec string (#spec).
100
- #name and #routes never affects the return value.
101
- </p>
102
-
103
-
104
- </dd>
105
- </dl>
106
- <h2><code>class <a name="TMail%3a%3aAddressGroup">TMail::AddressGroup</a> </code></h2>
107
-
108
- <h3>Class Methods</h3>
109
-
110
- <dl>
111
- <dt><a name="TMail%3a%3aAddressGroup-new"><code>new(name, <var>addrs</var>)</code></a> -&gt; <code><a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a></code></dt>
112
- <dd>
113
- <p>
114
- name: String<br>
115
- addrs: [<a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a>]<br>
116
- </p>
117
-
118
- <p>
119
- creates new <code>TMail::AddressGroup</code> object.
120
- NAME is the name of this group, <var>addrs</var> is addresses
121
- which belongs to this group.
122
- </p>
123
-
124
- </dd>
125
- </dl>
126
- <h3>Instance Methods</h3>
127
-
128
- <dl>
129
- <dt><a name="TMail%3a%3aAddressGroup-address_group%3f"><code>address_group?</code></a> -&gt; <code>true | false</code></dt>
130
- <dd>
131
- <p>
132
- returns true.
133
- </p>
134
-
135
- </dd>
136
- <dt><a name="TMail%3a%3aAddressGroup-name"><code>name</code></a> -&gt; <code>String</code></dt>
137
- <dd>
138
- <p>
139
- the human readable name of this group.
140
- </p>
141
-
142
- </dd>
143
- <dt><a name="TMail%3a%3aAddressGroup-addresses"><code>addresses</code></a> -&gt; <code>[<a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a>]</code></dt>
144
- <dd>
145
- <p>
146
- addresses which belongs to this group.
147
- </p>
148
-
149
- </dd>
150
- <dt><a name="TMail%3a%3aAddressGroup-to_a"><code>to_a</code></a> -&gt; <code>[<a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a>]</code></dt>
151
- <dt><a name="TMail%3a%3aAddressGroup-to_ary"><code>to_ary</code></a> -&gt; <code>[<a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a>]</code></dt>
152
- <dd>
153
- <p>
154
- equals to <code>addresses.dup</code>.
155
- </p>
156
-
157
- </dd>
158
- <dt><a name="TMail%3a%3aAddressGroup-flatten"><code>flatten</code></a> -&gt; <code>[<a href="address.html#TMail%3a%3aAddress">TMail::Address</a>]</code></dt>
159
- <dd>
160
- <p>
161
- flatten this group into one level of array of <code>TMail::Address</code>.
162
- </p>
163
-
164
- </dd>
165
- <dt><a name="TMail%3a%3aAddressGroup-add"><code>add(addr)</code></a></dt>
166
- <dt><a name="TMail%3a%3aAddressGroup-push"><code>push(addr)</code></a></dt>
167
- <dd>
168
- <p>
169
- addr: <a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a><br>
170
- </p>
171
-
172
- <p>
173
- adds an address or an address group to this group.
174
- </p>
175
-
176
- </dd>
177
- <dt><a name="TMail%3a%3aAddressGroup-delete"><code>delete(addr)</code></a></dt>
178
- <dd>
179
- <p>
180
- addr: <a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a><br>
181
- </p>
182
-
183
- <p>
184
- removes ADDR from this group.
185
- </p>
186
-
187
- </dd>
188
- <dt><a name="TMail%3a%3aAddressGroup-each%20%7b%7ca%7c%20%2e%2e%2e%2e%20%7d"><code>each {|a| .... }</code></a></dt>
189
- <dd>
190
- <p>
191
- a: <a href="address.html#TMail%3a%3aAddress">TMail::Address</a> | <a href="address.html#TMail%3a%3aAddressGroup">TMail::AddressGroup</a><br>
192
- </p>
193
-
194
- <p>
195
- equals to <code>addresses.each {|a| .... }</code>.
196
- </p>
197
-
198
- </dd>
199
- <dt><a name="TMail%3a%3aAddressGroup-each_address%20%7b%7ca%7c%20%2e%2e%2e%2e%20%7d"><code>each_address {|a| .... }</code></a></dt>
200
- <dd>
201
- <p>
202
- a: <a href="address.html#TMail%3a%3aAddress">TMail::Address</a><br>
203
- </p>
204
-
205
- <p>
206
- equals to <code>flatten.each {|a| .... }</code>
207
- </p>
208
-
209
- </dd>
210
- <dt><a name="TMail%3a%3aAddressGroup-encoded"><code>encoded(eol = "\r\n", <var>encoding</var> = 'j')</code></a> -&gt; <code>String</code></dt>
211
- <dd>
212
- <p>
213
- eol: String<br>
214
- encoding: String<br>
215
- </p>
216
-
217
- <p>
218
- converts this object into MIME-encoded string.
219
- </p>
220
-
221
- </dd>
222
- <dt><a name="TMail%3a%3aAddressGroup-decoded"><code>decoded(eol = "\n", <var>encoding</var> = 'e')</code></a> -&gt; <code>String</code></dt>
223
- <dd>
224
- <p>
225
- eol: String<br>
226
- encoding: String<br>
227
- </p>
228
-
229
- <p>
230
- converts this object into decoded string.
231
- </p>
232
-
233
- </dd>
234
- <dt><a name="TMail%3a%3aAddressGroup-%3d%3d"><code>==(other)</code></a> -&gt; <code>true | false</code></dt>
235
- <dt><a name="TMail%3a%3aAddressGroup-eql%3f"><code>eql?(other)</code></a> -&gt; <code>true | false</code></dt>
236
- <dd>
237
- <p>
238
- other: Object<br>
239
- </p>
240
-
241
- <p>
242
- judges if self is equal to OTHER, by comparing <code>self.addresses</code> and
243
- <code>other.addresses</code>. (<code>self.name</code> is meanless)
244
- </p>
245
- </dd>
246
- </dl>
247
-