forked from mikel/mail
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.html
656 lines (497 loc) · 24.9 KB
/
README.html
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
<h1>Mail</h1>
<h2>Introduction</h2>
<p>Mail is an internet library for Ruby that is designed to handle emails
generation, parsing and sending in a simple, rubyesque manner.</p>
<p>The purpose of this library is to provide a single point of access to handle
all email functions, including sending and receiving emails. All network
type actions are done through proxy methods to Net::SMTP, Net::POP3 etc.</p>
<p>Built from my experience with TMail, it is designed to be a pure ruby
implementation that makes generating, sending and parsing emails a no
brainer.</p>
<p>It is also designed form the ground up to work with Ruby 1.9. This is because
Ruby 1.9 handles text encodings much more magically than Ruby 1.8.x and so
these features have been taken full advantage of in this library allowing
Mail to handle a lot more messages more cleanly than TMail. Mail does run on
Ruby 1.8.x... it's just not as fun to code.</p>
<p>Finally, Mail has been designed with a very simple object oriented system
that really opens up the email messages you are parsing, if you know what
you are doing, you can fiddle with every last bit of your email directly.</p>
<h2>Donations</h2>
<p>Mail has been downloaded millions of times, by people around the world, in fact,
it represents more than 1% of <em>all</em> gems downloaded. </p>
<p>It is (like all open source software) a labour of love and something I am doing
with my own free time. If you would like to say thanks, please feel free to
<a href="http://www.pledgie.com/campaigns/8790">make a donation</a> and feel free to send
me a nice email :)</p>
<p><a href='http://www.pledgie.com/campaigns/8790'><img alt='Click here to lend your support to: mail and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/8790.png?skin_name=chrome' border='0' /></a></p>
<h2>Compatibility</h2>
<p>Mail is tested by Travis (<img src="https://secure.travis-ci.org/mikel/mail.png" alt="Travis Build Status" title="Build Status" />) and works on the following platforms:</p>
<ul>
<li>jruby-1.6.5.1 [ x86_64 ]</li>
<li>rbx-head-d18 [ x86_64 ]</li>
<li>ree-1.8.7-2011.03 [ i686 ]</li>
<li>ruby-1.8.7-p357 [ i686 ]</li>
<li>ruby-1.9.2-p290 [ x86_64 ]</li>
<li>ruby-1.9.3-p0 [ x86_64 ]</li>
</ul>
<h2>Discussion</h2>
<p>If you want to discuss mail with like minded individuals, please subscribe to
the <a href="http://groups.google.com/group/mail-ruby">Google Group</a>.</p>
<h2>Current Capabilities of Mail</h2>
<ul>
<li>RFC2822 Support, Reading and Writing</li>
<li>RFC2045-2049 Support for multipart emails</li>
<li>Support for creating multipart alternate emails</li>
<li>Support for reading multipart/report emails & getting details from such</li>
<li>Support for multibyte emails - needs quite a lot of work and testing</li>
<li>Wrappers for File, Net/POP3, Net/SMTP</li>
<li>Auto encoding of non US-ASCII header fields</li>
<li>Auto encoding of non US-ASCII bodies</li>
</ul>
<p>Mail is RFC2822 compliant now, that is, it can parse and generate valid US-ASCII
emails. There are a few obsoleted syntax emails that it will have problems with, but
it also is quite robust, meaning, if it finds something it doesn't understand it will
not crash, instead, it will skip the problem and keep parsing. In the case of a header
it doesn't understand, it will initialise the header as an optional unstructured
field and continue parsing.</p>
<p>This means Mail won't (ever) crunch your data (I think).</p>
<p>You can also create MIME emails. There are helper methods for making a
multipart/alternate email for text/plain and text/html (the most common pair)
and you can manually create any other type of MIME email.</p>
<h2>Roadmap</h2>
<p>Next TODO:</p>
<ul>
<li>Improve MIME support for character sets in headers, currently works, mostly, needs
refinement.</li>
</ul>
<h2>Testing Policy</h2>
<p>Basically... we do BDD on Mail. No method gets written in Mail without a
corresponding or covering spec. We expect as a minimum 100% coverage
measured by RCov. While this is not perfect by any measure, it is pretty
good. Additionally, all functional tests from TMail are to be passing before
the gem gets released.</p>
<p>It also means you can be sure Mail will behave correctly.</p>
<h2>API Policy</h2>
<p>No API removals within a single point release. All removals to be deprecated with
warnings for at least one MINOR point release before removal.</p>
<p>Also, all private or protected methods to be declared as such - though this is still I/P.</p>
<h2>Installation</h2>
<p>Installation is fairly simple, I host mail on rubygems, so you can just do:</p>
<pre><code># gem install mail
</code></pre>
<h2>Encodings</h2>
<p>If you didn't know, handling encodings in Emails is not as straight forward as you
would hope.</p>
<p>I have tried to simplify it some:</p>
<ol>
<li><p>All objects that can render into an email, have an <code>#encoded</code> method. Encoded will
return the object as a complete string ready to send in the mail system, that is,
it will include the header field and value and CRLF at the end and wrapped as
needed.</p></li>
<li><p>All objects that can render into an email, have a :decoded method. Decoded will
return the object's "value" only as a string. This means it will not include
the header fields (like 'To:' or 'Subject:').</p></li>
<li><p>By default, calling <code>#to<em>s</code> on a container object will call its encoded
method, while <code>#to</em>s</code> on a field object will call it's decoded method.
So calling <code>#to<em>s</code> on a Mail object will return the mail, all encoded
ready to send, while calling <code>#to</em>s</code> on the From field or the body will
return the decoded value of the object. The header object of Mail is considered a
container. If you are in doubt, call <code>#encoded</code>, or <code>#decoded</code>
explicitly, this is safer if you are not sure.</p></li>
<li><p>Structured fields that have parameter values that can be encoded (e.g. Content-Type) will
provide decoded parameter values when you call the parameter names as methods against
the object.</p></li>
<li><p>Structured fields that have parameter values that can be encoded (e.g. Content-Type) will
provide encoded parameter values when you call the parameter names through the
<code>object.parameters['<parameter_name>']</code> method call.</p></li>
</ol>
<h2>Contributing</h2>
<p>Please do! Contributing is easy in Mail. Please read the CONTRIBUTING.md document for more info</p>
<h2>Usage</h2>
<p>All major mail functions should be able to happen from the Mail module.
So, you should be able to just <code>require 'mail'</code> to get started.</p>
<h3>Making an email</h3>
<p>```ruby
mail = Mail.new do
from 'mikel@test.lindsaar.net'
to 'you@test.lindsaar.net'
subject 'This is a test email'
body File.read('body.txt')
end</p>
<p>mail.to_s #=> "From: mikel@test.lindsaar.net\r\nTo: you@...
```</p>
<h3>Making an email, have it your way:</h3>
<p>```ruby
mail = Mail.new do
body File.read('body.txt')
end</p>
<p>mail['from'] = 'mikel@test.lindsaar.net'
mail[:to] = 'you@test.lindsaar.net'
mail.subject = 'This is a test email'</p>
<p>mail.to_s #=> "From: mikel@test.lindsaar.net\r\nTo: you@...
```</p>
<h3>Don't Worry About Message IDs:</h3>
<p>```ruby
mail = Mail.new do
to 'you@test.lindsaar.net'
body 'Some simple body'
end</p>
<p>mail.to<em>s =~ /Message-ID: <[\d\w</em>]+@.+.mail/ #=> 27
```</p>
<p>Mail will automatically add a Message-ID field if it is missing and
give it a unique, random Message-ID along the lines of:</p>
<pre><code><4a7ff76d7016_13a81ab802e1@local.fqdn.mail>
</code></pre>
<h3>Or do worry about Message-IDs:</h3>
<p>```ruby
mail = Mail.new do
to 'you@test.lindsaar.net'
message_id '<a href="mailto:ThisIsMyMessageId@some.domain.com">ThisIsMyMessageId@some.domain.com</a>'
body 'Some simple body'
end</p>
<p>mail.to_s =~ /Message-ID: <a href="mailto:ThisIsMyMessageId@some.domain.com">ThisIsMyMessageId@some.domain.com</a>/ #=> 27
```</p>
<p>Mail will take the message_id you assign to it trusting that you know
what you are doing.</p>
<h3>Sending an email:</h3>
<p>Mail defaults to sending via SMTP to local host port 25. If you have a
sendmail or postfix daemon running on on this port, sending email is as
easy as:</p>
<p><code>ruby
Mail.deliver do
from 'me@test.lindsaar.net'
to 'you@test.lindsaar.net'
subject 'Here is the image you wanted'
body File.read('body.txt')
add_file '/full/path/to/somefile.png'
end
</code></p>
<p>or</p>
<p>```ruby
mail = Mail.new do
from 'me@test.lindsaar.net'
to 'you@test.lindsaar.net'
subject 'Here is the image you wanted'
body File.read('body.txt')
add_file :filename => 'somefile.png', :content => File.read('/somefile.png')
end</p>
<p>mail.deliver!
```</p>
<p>Sending via sendmail can be done like so:</p>
<p>```ruby
mail = Mail.new do
from 'me@test.lindsaar.net'
to 'you@test.lindsaar.net'
subject 'Here is the image you wanted'
body File.read('body.txt')
add_file :filename => 'somefile.png', :content => File.read('/somefile.png')
end</p>
<p>mail.delivery_method :sendmail</p>
<p>mail.deliver
```</p>
<p>Exim requires it's own delivery manager, and can be used like so:</p>
<p>```ruby
mail.delivery_method :exim, :location => "/usr/bin/exim"</p>
<p>mail.deliver
```</p>
<h3>Getting emails from a pop server:</h3>
<p>You can configure Mail to receive email using <code>retriever_method</code>
within <code>Mail.defaults</code>:</p>
<p><code>ruby
Mail.defaults do
retriever_method :pop3, :address => "pop.gmail.com",
:port => 995,
:user_name => '<username>',
:password => '<password>',
:enable_ssl => true
end
</code></p>
<p>You can access incoming email in a number of ways.</p>
<p>The most recent email:</p>
<p><code>ruby
Mail.all #=> Returns an array of all emails
Mail.first #=> Returns the first unread email
Mail.last #=> Returns the first unread email
</code></p>
<p>The first 10 emails sorted by date in ascending order:</p>
<p><code>ruby
emails = Mail.find(:what => :first, :count => 10, :order => :asc)
emails.length #=> 10
</code></p>
<p>Or even all emails:</p>
<p><code>ruby
emails = Mail.all
emails.length #=> LOTS!
</code></p>
<h3>Reading an Email</h3>
<p>```ruby
mail = Mail.read('/path/to/message.eml')</p>
<p>mail.envelope.from #=> 'mikel@test.lindsaar.net'
mail.from.addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
mail.sender.address #=> 'mikel@test.lindsaar.net'
mail.to #=> 'bob@test.lindsaar.net'
mail.cc #=> 'sam@test.lindsaar.net'
mail.subject #=> "This is the subject"
mail.date.to<em>s #=> '21 Nov 1997 09:55:06 -0600'
mail.message</em>id #=> '<a href="mailto:4D6AA7EB.6490534@xxx.xxx">4D6AA7EB.6490534@xxx.xxx</a>'
mail.body.decoded #=> 'This is the body of the email...
```</p>
<p>Many more methods available.</p>
<h3>Reading a Multipart Email</h3>
<p>```ruby
mail = Mail.read('multipart_email')</p>
<p>mail.multipart? #=> true
mail.parts.length #=> 2
mail.preamble #=> "Text before the first part"
mail.epilogue #=> "Text after the last part"
mail.parts.map { |p| p.content<em>type } #=> ['text/plain', 'application/pdf']
mail.parts.map { |p| p.class } #=> [Mail::Message, Mail::Message]
mail.parts[0].content</em>type<em>parameters #=> {'charset' => 'ISO-8859-1'}
mail.parts[1].content</em>type_parameters #=> {'name' => 'my.pdf'}
```</p>
<p>Mail generates a tree of parts. Each message has many or no parts. Each part
is another message which can have many or no parts.</p>
<p>A message will only have parts if it is a multipart/mixed or related/mixed
content type and has a boundary defined.</p>
<h3>Testing and extracting attachments</h3>
<p><code>ruby
mail.attachments.each do | attachment |
# Attachments is an AttachmentsList object containing a
# number of Part objects
if (attachment.content_type.start_with?('image/'))
# extracting images for example...
filename = attachment.filename
begin
File.open(images_dir + filename, "w+b", 0644) {|f| f.write attachment.body.decoded}
rescue Exception => e
puts "Unable to save data for #{filename} because #{e.message}"
end
end
end
</code></p>
<h3>Writing and sending a multipart/alternative (html and text) email</h3>
<p>Mail makes some basic assumptions and makes doing the common thing as
simple as possible.... (asking a lot from a mail library)</p>
<p>```ruby
mail = Mail.deliver do
to 'nicolas@test.lindsaar.net.au'
from 'Mikel Lindsaar <a href="mailto:mikel@test.lindsaar.net.au">mikel@test.lindsaar.net.au</a>'
subject 'First multipart email sent with Mail'</p>
<p>text_part do
body 'This is plain text'
end</p>
<p>html<em>part do
content</em>type 'text/html; charset=UTF-8'
body '<h1>This is HTML</h1>'
end
end
```</p>
<p>Mail then delivers the email at the end of the block and returns the
resulting Mail::Message object, which you can then inspect if you
so desire...</p>
<p>```
puts mail.to_s #=></p>
<p>To: nicolas@test.lindsaar.net.au
From: Mikel Lindsaar <a href="mailto:mikel@test.lindsaar.net.au">mikel@test.lindsaar.net.au</a>
Subject: First multipart email sent with Mail
Content-Type: multipart/alternative;
boundary=--==<em>mimepart</em>4a914f0c911be_6f0f1ab8026659
Message-ID: <a href="mailto:4a914f12ac7e_6f0f1ab80267d1@baci.local.mail">4a914f12ac7e_6f0f1ab80267d1@baci.local.mail</a>
Date: Mon, 24 Aug 2009 00:15:46 +1000
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit</p>
<p>----==<em>mimepart</em>4a914f0c911be_6f0f1ab8026659
Content-ID: <a href="mailto:4a914f12c8c4_6f0f1ab80268d6@baci.local.mail">4a914f12c8c4_6f0f1ab80268d6@baci.local.mail</a>
Date: Mon, 24 Aug 2009 00:15:46 +1000
Mime-Version: 1.0
Content-Type: text/plain
Content-Transfer-Encoding: 7bit</p>
<p>This is plain text
----==<em>mimepart</em>4a914f0c911be_6f0f1ab8026659
Content-Type: text/html; charset=UTF-8
Content-ID: <a href="mailto:4a914f12cf86_6f0f1ab802692c@baci.local.mail">4a914f12cf86_6f0f1ab802692c@baci.local.mail</a>
Date: Mon, 24 Aug 2009 00:15:46 +1000
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit</p>
<h1>This is HTML</h1>
<p>----==<em>mimepart</em>4a914f0c911be_6f0f1ab8026659--
```</p>
<p>Mail inserts the content transfer encoding, the mime version,
the content-id's and handles the content-type and boundary.</p>
<p>Mail assumes that if your text in the body is only us-ascii, that your
transfer encoding is 7bit and it is text/plain. You can override this
by explicitly declaring it.</p>
<h3>Making Multipart/Alternate, without a block</h3>
<p>You don't have to use a block with the text and html part included, you
can just do it declaratively. However, you need to add Mail::Parts to
an email, not Mail::Messages.</p>
<p>```ruby
mail = Mail.new do
to 'nicolas@test.lindsaar.net.au'
from 'Mikel Lindsaar <a href="mailto:mikel@test.lindsaar.net.au">mikel@test.lindsaar.net.au</a>'
subject 'First multipart email sent with Mail'
end</p>
<p>text_part = Mail::Part.new do
body 'This is plain text'
end</p>
<p>html<em>part = Mail::Part.new do
content</em>type 'text/html; charset=UTF-8'
body '<h1>This is HTML</h1>'
end</p>
<p>mail.text<em>part = text</em>part
mail.html<em>part = html</em>part
```</p>
<p>Results in the same email as done using the block form</p>
<h3>Getting error reports from an email:</h3>
<p>```ruby
@mail = Mail.read('/path/to/bounce_message.eml')</p>
<p>@mail.bounced? #=> true
@mail.final<em>recipient #=> rfc822;mikel@dont.exist.com
@mail.action #=> failed
@mail.error</em>status #=> 5.5.0
@mail.diagnostic_code #=> smtp;550 Requested action not taken: mailbox unavailable
@mail.retryable? #=> false
```</p>
<h3>Attaching and Detaching Files</h3>
<p>You can just read the file off an absolute path, Mail will try
to guess the mime_type and will encode the file in Base64 for you.</p>
<p><code>ruby
@mail = Mail.new
@mail.add_file("/path/to/file.jpg")
@mail.parts.first.attachment? #=> true
@mail.parts.first.content_transfer_encoding.to_s #=> 'base64'
@mail.attachments.first.mime_type #=> 'image/jpg'
@mail.attachments.first.filename #=> 'file.jpg'
@mail.attachments.first.decoded == File.read('/path/to/file.jpg') #=> true
</code></p>
<p>Or You can pass in file<em>data and give it a filename, again, mail
will try and guess the mime</em>type for you.</p>
<p><code>ruby
@mail = Mail.new
@mail.attachments['myfile.pdf'] = File.read('path/to/myfile.pdf')
@mail.parts.first.attachment? #=> true
@mail.attachments.first.mime_type #=> 'application/pdf'
@mail.attachments.first.decoded == File.read('path/to/myfile.pdf') #=> true
</code></p>
<p>You can also override the guessed MIME media type if you really know better
than mail (this should be rarely needed)</p>
<p><code>ruby
@mail = Mail.new
file_data = File.read('path/to/myfile.pdf')
@mail.attachments['myfile.pdf'] = { :mime_type => 'application/x-pdf',
:content => File.read('path/to/myfile.pdf') }
@mail.parts.first.mime_type #=> 'application/x-pdf'
</code></p>
<p>Of course... Mail will round trip an attachment as well</p>
<p>```ruby
@mail = Mail.new do
to 'nicolas@test.lindsaar.net.au'
from 'Mikel Lindsaar <a href="mailto:mikel@test.lindsaar.net.au">mikel@test.lindsaar.net.au</a>'
subject 'First multipart email sent with Mail'</p>
<p>text_part do
body 'Here is the attachment you wanted'
end</p>
<p>html<em>part do
content</em>type 'text/html; charset=UTF-8'
body '<h1>Funky Title</h1><p>Here is the attachment you wanted</p>'
end</p>
<p>add_file '/path/to/myfile.pdf'
end</p>
<p>@round<em>tripped</em>mail = Mail.new(@mail.encoded)</p>
<p>@round<em>tripped</em>mail.attachments.length #=> 1
@round<em>tripped</em>mail.attachments.first.filename #=> 'myfile.pdf'
```
See "Testing and extracting attachments" above for more details.</p>
<h2>Using Mail with Testing or Spec'ing Libraries</h2>
<p>If mail is part of your system, you'll need a way to test it without actually
sending emails, the TestMailer can do this for you.</p>
<p><code>
require 'mail'
=> true
Mail.defaults do
delivery_method :test
end
=> #<Mail::Configuration:0x19345a8 @delivery_method=Mail::TestMailer>
Mail::TestMailer.deliveries
=> []
Mail.deliver do
to 'mikel@me.com'
from 'you@you.com'
subject 'testing'
body 'hello'
end
=> #<Mail::Message:0x19284ec ...
Mail::TestMailer.deliveries.length
=> 1
Mail::TestMailer.deliveries.first
=> #<Mail::Message:0x19284ec ...
Mail::TestMailer.deliveries.clear
=> []
</code></p>
<p>There is also a set of RSpec matchers stolen fr^H^H^H^H^H^H^H^H inspired by Shoulda's ActionMailer matchers (you'll want to set <code>delivery_method</code> as above too):</p>
<p>```
Mail.defaults do
delivery<em>method :test # in practice you'd do this in spec</em>helper.rb
end</p>
<p>describe "sending an email" do
include Mail::Matchers</p>
<p>before(:each) do
Mail::TestMailer.deliveries.clear</p>
<pre><code>Mail.deliver do
to ['mikel@me.com', 'mike2@me.com']
from 'you@you.com'
subject 'testing'
body 'hello'
end
</code></pre>
<p>end</p>
<p>it { should have<em>sent</em>email } # passes if any email at all was sent</p>
<p>it { should have<em>sent</em>email.from('you@you.com') }
it { should have<em>sent</em>email.to('mike1@me.com') }</p>
<p># can specify a list of recipients...
it { should have<em>sent</em>email.to(['mike1@me.com', 'mike2@me.com']) }</p>
<p># ...or chain recipients together
it { should have<em>sent</em>email.to('mike1@me.com').to('mike2@me.com') }</p>
<p>it { should have<em>sent</em>email.with_subject('testing') }</p>
<p>it { should have<em>sent</em>email.with_body('hello') }</p>
<p># Can match subject or body with a regex
# (or anything that responds_to? :match)</p>
<p>it { should have<em>sent</em>email.matching<em>subject(/test(ing)?/) }
it { should have</em>sent<em>email.matching</em>body(/h(a|e)llo/) }</p>
<p># Can chain together modifiers
# Note that apart from recipients, repeating a modifier overwrites old value.</p>
<p>it { should have<em>sent</em>email.from('you@you.com').to('mike1@me.com').matching_body(/hell/)
end
```</p>
<h2>Excerpts from TREC Spam Corpus 2005</h2>
<p>The spec fixture files in spec/fixtures/emails/from<em>trec</em>2005 are from the
2005 TREC Public Spam Corpus. They remain copyrighted under the terms of
that project and license agreement. They are used in this project to verify
and describe the development of this email parser implementation.</p>
<p>http://plg.uwaterloo.ca/~gvcormac/treccorpus/</p>
<p>They are used as allowed by 'Permitted Uses, Clause 3':</p>
<pre><code>"Small excerpts of the information may be displayed to others
or published in a scientific or technical context, solely for
the purpose of describing the research and development and
related issues."
-- http://plg.uwaterloo.ca/~gvcormac/treccorpus/
</code></pre>
<h2>License</h2>
<p>(The MIT License)</p>
<p>Copyright (c) 2009, 2010, 2011, 2012</p>
<p>Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:</p>
<p>The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.</p>
<p>THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>