mailcatcher-cors 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +15 -0
- data/LICENSE +20 -0
- data/README.md +120 -0
- data/bin/catchmail +71 -0
- data/bin/mailcatcher +5 -0
- data/lib/mail_catcher/events.rb +7 -0
- data/lib/mail_catcher/mail.rb +160 -0
- data/lib/mail_catcher/smtp.rb +61 -0
- data/lib/mail_catcher/version.rb +3 -0
- data/lib/mail_catcher/web/application.rb +199 -0
- data/lib/mail_catcher/web.rb +21 -0
- data/lib/mail_catcher.rb +211 -0
- data/lib/mailcatcher.rb +3 -0
- data/public/assets/logo.png +0 -0
- data/public/assets/logo_large.png +0 -0
- data/public/assets/mailcatcher.css +1 -0
- data/public/assets/mailcatcher.js +5 -0
- data/public/favicon.ico +0 -0
- data/views/404.erb +6 -0
- data/views/index.erb +62 -0
- metadata +328 -0
checksums.yaml
ADDED
@@ -0,0 +1,15 @@
|
|
1
|
+
---
|
2
|
+
!binary "U0hBMQ==":
|
3
|
+
metadata.gz: !binary |-
|
4
|
+
ZTk0NzJhNDJkODY2YWZlZjU4ZjQwZGZlNTgyNjM3ODdmMDY3ZmQ3OA==
|
5
|
+
data.tar.gz: !binary |-
|
6
|
+
N2RlYTg1NzgwM2U0Y2JiZWM2NzE3ZGYxMzMwMzkxNDQyMWFlMTFmNQ==
|
7
|
+
SHA512:
|
8
|
+
metadata.gz: !binary |-
|
9
|
+
MDQ3MmU0YWY3NDY0M2VmODEyYjIxMmFkZjBkMGEzNmI3ZTE1MTZlYzhmYjdk
|
10
|
+
ZjVkYjY4ZjcxOTc3MzZlNjRhMzlhN2I5NDRmOGI5ZDA2MGZmMDhmMGQyMDM4
|
11
|
+
YTA3OGU5NjZmNjVjYmE4NDYwMmJhMTk5MTQwZWVmMjkwMmRhNDM=
|
12
|
+
data.tar.gz: !binary |-
|
13
|
+
MTQ5NjAxZjIzM2JlOWY4ZGIwMmRkZTU0ODgxYWY5YWEwYWEzZWM5Mzg2ZTcy
|
14
|
+
OTY0YTA3MWYzOTk3ZmQ5ODRmY2UyMWIzOGM0NTI4NTBmNGZkMzM1ZjZmZjhi
|
15
|
+
MjQwNzAzN2ZmYTc3ZTYyOWUwMGZlODAzYWI2NmNmNTI1NWRmYTY=
|
data/LICENSE
ADDED
@@ -0,0 +1,20 @@
|
|
1
|
+
Copyright (c) 2010-2011 Samuel Cochran
|
2
|
+
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
4
|
+
a copy of this software and associated documentation files (the
|
5
|
+
"Software"), to deal in the Software without restriction, including
|
6
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
7
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
8
|
+
permit persons to whom the Software is furnished to do so, subject to
|
9
|
+
the following conditions:
|
10
|
+
|
11
|
+
The above copyright notice and this permission notice shall be
|
12
|
+
included in all copies or substantial portions of the Software.
|
13
|
+
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
15
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
16
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
17
|
+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
|
18
|
+
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
|
19
|
+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
20
|
+
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
data/README.md
ADDED
@@ -0,0 +1,120 @@
|
|
1
|
+
# MailCatcher
|
2
|
+
|
3
|
+
Catches mail and serves it through a dream.
|
4
|
+
|
5
|
+
MailCatcher runs a super simple SMTP server which catches any message sent to it to display in a web interface. Run mailcatcher, set your favourite app to deliver to smtp://127.0.0.1:1025 instead of your default SMTP server, then check out http://127.0.0.1:1080 to see the mail that's arrived so far.
|
6
|
+
|
7
|
+

|
8
|
+
|
9
|
+
## Features
|
10
|
+
|
11
|
+
* Catches all mail and stores it for display.
|
12
|
+
* Shows HTML, Plain Text and Source version of messages, as applicable.
|
13
|
+
* Rewrites HTML enabling display of embedded, inline images/etc and open links in a new window.
|
14
|
+
* Lists attachments and allows separate downloading of parts.
|
15
|
+
* Download original email to view in your native mail client(s).
|
16
|
+
* Command line options to override the default SMTP/HTTP IP and port settings.
|
17
|
+
* Mail appears instantly if your browser supports [WebSockets][websockets], otherwise updates every thirty seconds.
|
18
|
+
* Runs as a daemon run in the background.
|
19
|
+
* Sendmail-analogue command, `catchmail`, makes [using mailcatcher from PHP][withphp] a lot easier.
|
20
|
+
* Written super-simply in EventMachine, easy to dig in and change.
|
21
|
+
* Keyboard navigation between messages
|
22
|
+
|
23
|
+
## How
|
24
|
+
|
25
|
+
1. `gem install mailcatcher`
|
26
|
+
2. `mailcatcher`
|
27
|
+
3. Go to http://localhost:1080/
|
28
|
+
4. Send mail through smtp://localhost:1025
|
29
|
+
|
30
|
+
Use `mailcatcher --help` to see the command line options. The brave can get the source from [the GitHub repository][mailcatcher-github].
|
31
|
+
|
32
|
+
### Bundler
|
33
|
+
|
34
|
+
Please don't put mailcatcher into your Gemfile. It will conflict with your applications gems at some point.
|
35
|
+
|
36
|
+
Instead, pop a note in your README stating you use mailcatcher. Simply run `gem install mailcatcher` then `mailcatcher` to get started.
|
37
|
+
|
38
|
+
### RVM
|
39
|
+
|
40
|
+
Under RVM your mailcatcher command may only be available under the ruby you install mailcatcher into. To prevent this, and to prevent gem conflicts, install mailcatcher into a dedicated gemset and create wrapper scripts:
|
41
|
+
|
42
|
+
rvm default@mailcatcher --create do gem install mailcatcher
|
43
|
+
rvm wrapper default@mailcatcher --no-prefix mailcatcher catchmail
|
44
|
+
|
45
|
+
### Rails
|
46
|
+
|
47
|
+
To set up your rails app, I recommend adding this to your `environments/development.rb`:
|
48
|
+
|
49
|
+
config.action_mailer.delivery_method = :smtp
|
50
|
+
config.action_mailer.smtp_settings = { :address => "localhost", :port => 1025 }
|
51
|
+
|
52
|
+
### PHP
|
53
|
+
|
54
|
+
For projects using PHP, or PHP frameworks and application platforms like Drupal, you can set [PHP's mail configuration](http://www.php.net/manual/en/mail.configuration.php) in your [php.ini](http://www.php.net/manual/en/configuration.file.php) to send via MailCatcher with:
|
55
|
+
|
56
|
+
sendmail_path = /usr/bin/env catchmail -f some@from.address
|
57
|
+
|
58
|
+
You can do this in your [Apache configuration](http://php.net/manual/en/configuration.changes.php) like so:
|
59
|
+
|
60
|
+
php_admin_value sendmail_path "/usr/bin/env catchmail -f some@from.address"
|
61
|
+
|
62
|
+
If you've installed via RVM this probably won't work unless you've manually added your RVM bin paths to your system environment's PATH. In that case, run `which catchmail` and put that path into the `sendmail_path` directive above instead of `/usr/bin/env catchmail`.
|
63
|
+
|
64
|
+
If starting `mailcatcher` on alternative SMTP IP and/or port with parameters like `--smtp-ip 192.168.0.1 --smtp-port 10025`, add the same parameters to your `catchmail` command:
|
65
|
+
|
66
|
+
sendmail_path = /usr/bin/env catchmail --smtp-ip 192.160.0.1 --smtp-port 10025 -f some@from.address
|
67
|
+
|
68
|
+
### Django
|
69
|
+
|
70
|
+
For use in Django, simply add the following configuration to your projects' settings.py
|
71
|
+
|
72
|
+
```python
|
73
|
+
if DEBUG:
|
74
|
+
EMAIL_HOST = '127.0.0.1'
|
75
|
+
EMAIL_HOST_USER = ''
|
76
|
+
EMAIL_HOST_PASSWORD = ''
|
77
|
+
EMAIL_PORT = 1025
|
78
|
+
EMAIL_USE_TLS = False
|
79
|
+
```
|
80
|
+
|
81
|
+
### API
|
82
|
+
|
83
|
+
A fairly RESTful URL schema means you can download a list of messages in JSON from `/messages`, each message's metadata with `/messages/:id.json`, and then the pertinent parts with `/messages/:id.html` and `/messages/:id.plain` for the default HTML and plain text version, `/messages/:id/:cid` for individual attachments by CID, or the whole message with `/messages/:id.source`.
|
84
|
+
|
85
|
+
## Caveats
|
86
|
+
|
87
|
+
* Mail processing is fairly basic but easily modified. If something doesn't work for you, fork and fix it or [file an issue][mailcatcher-issues] and let me know. Include the whole message you're having problems with.
|
88
|
+
* The interface is very basic and has not been tested on many browsers yet.
|
89
|
+
|
90
|
+
## TODO
|
91
|
+
|
92
|
+
* Add mail delivery on request, optionally multiple times.
|
93
|
+
* Compatibility testing against CampaignMonitor's [design guidelines](http://www.campaignmonitor.com/design-guidelines/) and [CSS support matrix](http://www.campaignmonitor.com/css/).
|
94
|
+
* Forward mail to rendering service, maybe CampaignMonitor?
|
95
|
+
|
96
|
+
## Thanks
|
97
|
+
|
98
|
+
MailCatcher is just a mishmash of other people's hard work. Thank you so much to the people who have built the wonderful guts on which this project relies.
|
99
|
+
|
100
|
+
Thanks also to [The Frontier Group][tfg] for giving me the idea, being great guinea pigs and letting me steal pieces of time to keep the project alive.
|
101
|
+
|
102
|
+
## Donations
|
103
|
+
|
104
|
+
I work on MailCatcher mostly in my own spare time. If you've found Mailcatcher useful and would like to help feed me and fund continued development and new features, please [donate via PayPal][donate]. If you'd like a specific feature added to MailCatcher and are willing to pay for it, please [email me](mailto:sj26@sj26.com).
|
105
|
+
|
106
|
+
## License
|
107
|
+
|
108
|
+
Copyright © 2010-2011 Samuel Cochran (sj26@sj26.com). Released under the MIT License, see [LICENSE][license] for details.
|
109
|
+
|
110
|
+
## Dreams
|
111
|
+
|
112
|
+
For dream catching, try [this](http://goo.gl/kgbh). OR [THIS](http://www.nyanicorn.com), OMG.
|
113
|
+
|
114
|
+
[donate]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=522WUPLRWUSKE
|
115
|
+
[license]: https://github.com/sj26/mailcatcher/blob/master/LICENSE
|
116
|
+
[mailcatcher-github]: https://github.com/sj26/mailcatcher
|
117
|
+
[mailcatcher-issues]: https://github.com/sj26/mailcatcher/issues
|
118
|
+
[tfg]: http://www.thefrontiergroup.com.au
|
119
|
+
[websockets]: http://www.whatwg.org/specs/web-socket-protocol/
|
120
|
+
[withphp]: http://webschuur.com/publications/blogs/2011-05-29-catchmail_for_drupal_and_other_phpapplications_the_simple_version
|
data/bin/catchmail
ADDED
@@ -0,0 +1,71 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
|
3
|
+
begin
|
4
|
+
require 'mail'
|
5
|
+
rescue LoadError
|
6
|
+
require 'rubygems'
|
7
|
+
require 'mail'
|
8
|
+
end
|
9
|
+
|
10
|
+
require 'optparse'
|
11
|
+
|
12
|
+
options = {:smtp_ip => '127.0.0.1', :smtp_port => 1025}
|
13
|
+
|
14
|
+
OptionParser.new do |parser|
|
15
|
+
parser.banner = <<-BANNER.gsub /^ +/, ""
|
16
|
+
Usage: catchmail [options] [recipient ...]
|
17
|
+
sendmail-like interface to forward mail to MailCatcher.
|
18
|
+
BANNER
|
19
|
+
|
20
|
+
parser.on('--ip IP') do |ip|
|
21
|
+
options[:smtp_ip] = ip
|
22
|
+
end
|
23
|
+
|
24
|
+
parser.on('--smtp-ip IP', 'Set the ip address of the smtp server') do |ip|
|
25
|
+
options[:smtp_ip] = ip
|
26
|
+
end
|
27
|
+
|
28
|
+
parser.on('--smtp-port PORT', Integer, 'Set the port of the smtp server') do |port|
|
29
|
+
options[:smtp_port] = port
|
30
|
+
end
|
31
|
+
|
32
|
+
parser.on('-f FROM', 'Set the sending address') do |from|
|
33
|
+
options[:from] = from
|
34
|
+
end
|
35
|
+
|
36
|
+
parser.on('-oi', 'Ignored option -oi') do |ignored|
|
37
|
+
end
|
38
|
+
parser.on('-t', 'Ignored option -t') do |ignored|
|
39
|
+
end
|
40
|
+
parser.on('-q', 'Ignored option -q') do |ignored|
|
41
|
+
end
|
42
|
+
|
43
|
+
parser.on('-x', '--no-exit', 'Can\'t exit from the application') do
|
44
|
+
options[:no_exit] = true
|
45
|
+
end
|
46
|
+
|
47
|
+
parser.on('-h', '--help', 'Display this help information') do
|
48
|
+
puts parser
|
49
|
+
exit!
|
50
|
+
end
|
51
|
+
end.parse!
|
52
|
+
|
53
|
+
Mail.defaults do
|
54
|
+
delivery_method :smtp,
|
55
|
+
:address => options[:smtp_ip],
|
56
|
+
:port => options[:smtp_port]
|
57
|
+
end
|
58
|
+
|
59
|
+
message = Mail.new($stdin.read)
|
60
|
+
|
61
|
+
message.return_path = options[:from] if options[:from]
|
62
|
+
|
63
|
+
ARGV.each do |recipient|
|
64
|
+
if message.to.nil?
|
65
|
+
message.to = recipient
|
66
|
+
else
|
67
|
+
message.to << recipient
|
68
|
+
end
|
69
|
+
end
|
70
|
+
|
71
|
+
message.deliver
|
data/bin/mailcatcher
ADDED
@@ -0,0 +1,160 @@
|
|
1
|
+
require "active_support/json"
|
2
|
+
require "eventmachine"
|
3
|
+
require "mail"
|
4
|
+
require "sqlite3"
|
5
|
+
|
6
|
+
module MailCatcher::Mail extend self
|
7
|
+
def db
|
8
|
+
@__db ||= begin
|
9
|
+
SQLite3::Database.new(":memory:", :type_translation => true).tap do |db|
|
10
|
+
db.execute(<<-SQL)
|
11
|
+
CREATE TABLE message (
|
12
|
+
id INTEGER PRIMARY KEY ASC,
|
13
|
+
sender TEXT,
|
14
|
+
recipients TEXT,
|
15
|
+
subject TEXT,
|
16
|
+
source BLOB,
|
17
|
+
size TEXT,
|
18
|
+
type TEXT,
|
19
|
+
created_at DATETIME DEFAULT CURRENT_DATETIME
|
20
|
+
)
|
21
|
+
SQL
|
22
|
+
db.execute(<<-SQL)
|
23
|
+
CREATE TABLE message_part (
|
24
|
+
id INTEGER PRIMARY KEY ASC,
|
25
|
+
message_id INTEGER NOT NULL,
|
26
|
+
cid TEXT,
|
27
|
+
type TEXT,
|
28
|
+
is_attachment INTEGER,
|
29
|
+
filename TEXT,
|
30
|
+
charset TEXT,
|
31
|
+
body BLOB,
|
32
|
+
size INTEGER,
|
33
|
+
created_at DATETIME DEFAULT CURRENT_DATETIME
|
34
|
+
)
|
35
|
+
SQL
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|
39
|
+
|
40
|
+
def add_message(message)
|
41
|
+
@add_message_query ||= db.prepare("INSERT INTO message (sender, recipients, subject, source, type, size, created_at) VALUES (?, ?, ?, ?, ?, ?, datetime('now'))")
|
42
|
+
|
43
|
+
mail = Mail.new(message[:source])
|
44
|
+
@add_message_query.execute(message[:sender], message[:recipients].to_json, mail.subject, message[:source], mail.mime_type || "text/plain", message[:source].length)
|
45
|
+
message_id = db.last_insert_row_id
|
46
|
+
parts = mail.all_parts
|
47
|
+
parts = [mail] if parts.empty?
|
48
|
+
parts.each do |part|
|
49
|
+
body = part.body.to_s
|
50
|
+
# Only parts have CIDs, not mail
|
51
|
+
cid = part.cid if part.respond_to? :cid
|
52
|
+
add_message_part(message_id, cid, part.mime_type || "text/plain", part.attachment? ? 1 : 0, part.filename, part.charset, body, body.length)
|
53
|
+
end
|
54
|
+
|
55
|
+
EventMachine.next_tick do
|
56
|
+
message = MailCatcher::Mail.message message_id
|
57
|
+
MailCatcher::Events::MessageAdded.push message
|
58
|
+
end
|
59
|
+
end
|
60
|
+
|
61
|
+
def add_message_part(*args)
|
62
|
+
@add_message_part_query ||= db.prepare "INSERT INTO message_part (message_id, cid, type, is_attachment, filename, charset, body, size, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))"
|
63
|
+
@add_message_part_query.execute(*args)
|
64
|
+
end
|
65
|
+
|
66
|
+
def latest_created_at
|
67
|
+
@latest_created_at_query ||= db.prepare "SELECT created_at FROM message ORDER BY created_at DESC LIMIT 1"
|
68
|
+
@latest_created_at_query.execute.next
|
69
|
+
end
|
70
|
+
|
71
|
+
def messages
|
72
|
+
@messages_query ||= db.prepare "SELECT id, sender, recipients, subject, size, created_at FROM message ORDER BY created_at, id ASC"
|
73
|
+
@messages_query.execute.map do |row|
|
74
|
+
Hash[row.fields.zip(row)].tap do |message|
|
75
|
+
message["recipients"] &&= ActiveSupport::JSON.decode message["recipients"]
|
76
|
+
end
|
77
|
+
end
|
78
|
+
end
|
79
|
+
|
80
|
+
def message(id)
|
81
|
+
@message_query ||= db.prepare "SELECT * FROM message WHERE id = ? LIMIT 1"
|
82
|
+
row = @message_query.execute(id).next
|
83
|
+
row && Hash[row.fields.zip(row)].tap do |message|
|
84
|
+
message["recipients"] &&= ActiveSupport::JSON.decode message["recipients"]
|
85
|
+
end
|
86
|
+
end
|
87
|
+
|
88
|
+
def message_has_html?(id)
|
89
|
+
@message_has_html_query ||= db.prepare "SELECT 1 FROM message_part WHERE message_id = ? AND is_attachment = 0 AND type IN ('application/xhtml+xml', 'text/html') LIMIT 1"
|
90
|
+
(!!@message_has_html_query.execute(id).next) || ["text/html", "application/xhtml+xml"].include?(message(id)["type"])
|
91
|
+
end
|
92
|
+
|
93
|
+
def message_has_plain?(id)
|
94
|
+
@message_has_plain_query ||= db.prepare "SELECT 1 FROM message_part WHERE message_id = ? AND is_attachment = 0 AND type = 'text/plain' LIMIT 1"
|
95
|
+
(!!@message_has_plain_query.execute(id).next) || message(id)["type"] == "text/plain"
|
96
|
+
end
|
97
|
+
|
98
|
+
def message_parts(id)
|
99
|
+
@message_parts_query ||= db.prepare "SELECT cid, type, filename, size FROM message_part WHERE message_id = ? ORDER BY filename ASC"
|
100
|
+
@message_parts_query.execute(id).map do |row|
|
101
|
+
Hash[row.fields.zip(row)]
|
102
|
+
end
|
103
|
+
end
|
104
|
+
|
105
|
+
def message_attachments(id)
|
106
|
+
@message_parts_query ||= db.prepare "SELECT cid, type, filename, size FROM message_part WHERE message_id = ? AND is_attachment = 1 ORDER BY filename ASC"
|
107
|
+
@message_parts_query.execute(id).map do |row|
|
108
|
+
Hash[row.fields.zip(row)]
|
109
|
+
end
|
110
|
+
end
|
111
|
+
|
112
|
+
def message_part(message_id, part_id)
|
113
|
+
@message_part_query ||= db.prepare "SELECT * FROM message_part WHERE message_id = ? AND id = ? LIMIT 1"
|
114
|
+
row = @message_part_query.execute(message_id, part_id).next
|
115
|
+
row && Hash[row.fields.zip(row)]
|
116
|
+
end
|
117
|
+
|
118
|
+
def message_part_type(message_id, part_type)
|
119
|
+
@message_part_type_query ||= db.prepare "SELECT * FROM message_part WHERE message_id = ? AND type = ? AND is_attachment = 0 LIMIT 1"
|
120
|
+
row = @message_part_type_query.execute(message_id, part_type).next
|
121
|
+
row && Hash[row.fields.zip(row)]
|
122
|
+
end
|
123
|
+
|
124
|
+
def message_part_html(message_id)
|
125
|
+
part = message_part_type(message_id, "text/html")
|
126
|
+
part ||= message_part_type(message_id, "application/xhtml+xml")
|
127
|
+
part ||= begin
|
128
|
+
message = message(message_id)
|
129
|
+
message if message.present? and ["text/html", "application/xhtml+xml"].include? message["type"]
|
130
|
+
end
|
131
|
+
end
|
132
|
+
|
133
|
+
def message_part_plain(message_id)
|
134
|
+
message_part_type message_id, "text/plain"
|
135
|
+
end
|
136
|
+
|
137
|
+
def message_part_cid(message_id, cid)
|
138
|
+
@message_part_cid_query ||= db.prepare "SELECT * FROM message_part WHERE message_id = ?"
|
139
|
+
@message_part_cid_query.execute(message_id).map do |row|
|
140
|
+
Hash[row.fields.zip(row)]
|
141
|
+
end.find do |part|
|
142
|
+
part["cid"] == cid
|
143
|
+
end
|
144
|
+
end
|
145
|
+
|
146
|
+
def delete!
|
147
|
+
@delete_all_messages_query ||= db.prepare "DELETE FROM message"
|
148
|
+
@delete_all_message_parts_query ||= db.prepare "DELETE FROM message_part"
|
149
|
+
|
150
|
+
@delete_all_messages_query.execute and
|
151
|
+
@delete_all_message_parts_query.execute
|
152
|
+
end
|
153
|
+
|
154
|
+
def delete_message!(message_id)
|
155
|
+
@delete_messages_query ||= db.prepare "DELETE FROM message WHERE id = ?"
|
156
|
+
@delete_message_parts_query ||= db.prepare "DELETE FROM message_part WHERE message_id = ?"
|
157
|
+
@delete_messages_query.execute(message_id) and
|
158
|
+
@delete_message_parts_query.execute(message_id)
|
159
|
+
end
|
160
|
+
end
|
@@ -0,0 +1,61 @@
|
|
1
|
+
require "eventmachine"
|
2
|
+
|
3
|
+
require "mail_catcher/mail"
|
4
|
+
|
5
|
+
class MailCatcher::Smtp < EventMachine::Protocols::SmtpServer
|
6
|
+
# We override EM's mail from processing to allow multiple mail-from commands
|
7
|
+
# per [RFC 2821](http://tools.ietf.org/html/rfc2821#section-4.1.1.2)
|
8
|
+
def process_mail_from sender
|
9
|
+
if @state.include? :mail_from
|
10
|
+
@state -= [:mail_from, :rcpt, :data]
|
11
|
+
receive_reset
|
12
|
+
end
|
13
|
+
|
14
|
+
super
|
15
|
+
end
|
16
|
+
|
17
|
+
def current_message
|
18
|
+
@current_message ||= {}
|
19
|
+
end
|
20
|
+
|
21
|
+
def receive_reset
|
22
|
+
@current_message = nil
|
23
|
+
true
|
24
|
+
end
|
25
|
+
|
26
|
+
def receive_sender(sender)
|
27
|
+
current_message[:sender] = sender
|
28
|
+
true
|
29
|
+
end
|
30
|
+
|
31
|
+
def receive_recipient(recipient)
|
32
|
+
current_message[:recipients] ||= []
|
33
|
+
current_message[:recipients] << recipient
|
34
|
+
true
|
35
|
+
end
|
36
|
+
|
37
|
+
def receive_data_chunk(lines)
|
38
|
+
current_message[:source] ||= ""
|
39
|
+
lines.each do |line|
|
40
|
+
current_message[:source] << line << "\r\n"
|
41
|
+
end
|
42
|
+
true
|
43
|
+
end
|
44
|
+
|
45
|
+
def receive_message
|
46
|
+
MailCatcher::Mail.add_message current_message
|
47
|
+
puts "==> SMTP: Received message from '#{current_message[:sender]}' (#{current_message[:source].length} bytes)"
|
48
|
+
true
|
49
|
+
rescue
|
50
|
+
puts "*** Error receiving message: #{current_message.inspect}"
|
51
|
+
puts " Exception: #{$!}"
|
52
|
+
puts " Backtrace:"
|
53
|
+
$!.backtrace.each do |line|
|
54
|
+
puts " #{line}"
|
55
|
+
end
|
56
|
+
puts " Please submit this as an issue at http://github.com/sj26/mailcatcher/issues"
|
57
|
+
false
|
58
|
+
ensure
|
59
|
+
@current_message = nil
|
60
|
+
end
|
61
|
+
end
|
@@ -0,0 +1,199 @@
|
|
1
|
+
require "pathname"
|
2
|
+
require "net/http"
|
3
|
+
require "uri"
|
4
|
+
|
5
|
+
require "sinatra"
|
6
|
+
require "skinny"
|
7
|
+
|
8
|
+
require "mail_catcher/events"
|
9
|
+
require "mail_catcher/mail"
|
10
|
+
|
11
|
+
class Sinatra::Request
|
12
|
+
include Skinny::Helpers
|
13
|
+
end
|
14
|
+
|
15
|
+
module MailCatcher
|
16
|
+
module Web
|
17
|
+
class Application < Sinatra::Base
|
18
|
+
set :development, ENV["MAILCATCHER_ENV"] == "development"
|
19
|
+
set :root, File.expand_path("#{__FILE__}/../../../..")
|
20
|
+
|
21
|
+
if development?
|
22
|
+
require "sprockets-helpers"
|
23
|
+
|
24
|
+
configure do
|
25
|
+
require "mail_catcher/web/assets"
|
26
|
+
Sprockets::Helpers.configure do |config|
|
27
|
+
config.environment = Assets
|
28
|
+
config.prefix = "/assets"
|
29
|
+
config.digest = false
|
30
|
+
config.public_path = public_folder
|
31
|
+
config.debug = true
|
32
|
+
end
|
33
|
+
end
|
34
|
+
|
35
|
+
helpers do
|
36
|
+
include Sprockets::Helpers
|
37
|
+
end
|
38
|
+
else
|
39
|
+
helpers do
|
40
|
+
def javascript_tag(name)
|
41
|
+
%{<script src="/assets/#{name}.js"></script>}
|
42
|
+
end
|
43
|
+
|
44
|
+
def stylesheet_tag(name)
|
45
|
+
%{<link rel="stylesheet" href="/assets/#{name}.css">}
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
|
50
|
+
before do
|
51
|
+
response.headers['Access-Control-Allow-Origin'] = "*"
|
52
|
+
response.headers['Access-Control-Allow-Methods'] = "HEAD,GET,PUT,POST,DELETE,OPTIONS"
|
53
|
+
end
|
54
|
+
|
55
|
+
options "*" do
|
56
|
+
response.headers["Allow"] = "HEAD,GET,PUT,POST,DELETE,OPTIONS"
|
57
|
+
response.headers["Access-Control-Allow-Headers"] = "X-Requested-With, X-HTTP-Method-Override, Content-Type, Cache-Control, Accept"
|
58
|
+
200
|
59
|
+
end
|
60
|
+
|
61
|
+
get "/" do
|
62
|
+
erb :index
|
63
|
+
end
|
64
|
+
|
65
|
+
delete "/" do
|
66
|
+
if MailCatcher.quittable?
|
67
|
+
MailCatcher.quit!
|
68
|
+
status 204
|
69
|
+
else
|
70
|
+
status 403
|
71
|
+
end
|
72
|
+
end
|
73
|
+
|
74
|
+
get "/messages" do
|
75
|
+
if request.websocket?
|
76
|
+
request.websocket!(
|
77
|
+
:on_start => proc do |websocket|
|
78
|
+
subscription = Events::MessageAdded.subscribe { |message| websocket.send_message message.to_json }
|
79
|
+
websocket.on_close do |websocket|
|
80
|
+
Events::MessageAdded.unsubscribe subscription
|
81
|
+
end
|
82
|
+
end)
|
83
|
+
else
|
84
|
+
content_type :json
|
85
|
+
Mail.messages.to_json
|
86
|
+
end
|
87
|
+
end
|
88
|
+
|
89
|
+
delete "/messages" do
|
90
|
+
Mail.delete!
|
91
|
+
status 204
|
92
|
+
end
|
93
|
+
|
94
|
+
get "/messages/:id.json" do
|
95
|
+
id = params[:id].to_i
|
96
|
+
if message = Mail.message(id)
|
97
|
+
content_type :json
|
98
|
+
message.merge({
|
99
|
+
"formats" => [
|
100
|
+
"source",
|
101
|
+
("html" if Mail.message_has_html? id),
|
102
|
+
("plain" if Mail.message_has_plain? id)
|
103
|
+
].compact,
|
104
|
+
"attachments" => Mail.message_attachments(id).map do |attachment|
|
105
|
+
attachment.merge({"href" => "/messages/#{escape(id)}/parts/#{escape(attachment["cid"])}"})
|
106
|
+
end,
|
107
|
+
}).to_json
|
108
|
+
else
|
109
|
+
not_found
|
110
|
+
end
|
111
|
+
end
|
112
|
+
|
113
|
+
get "/messages/:id.html" do
|
114
|
+
id = params[:id].to_i
|
115
|
+
if part = Mail.message_part_html(id)
|
116
|
+
content_type part["type"], :charset => (part["charset"] || "utf8")
|
117
|
+
|
118
|
+
body = part["body"]
|
119
|
+
|
120
|
+
# Rewrite body to link to embedded attachments served by cid
|
121
|
+
body.gsub! /cid:([^'"> ]+)/, "#{id}/parts/\\1"
|
122
|
+
|
123
|
+
content_type :html
|
124
|
+
body
|
125
|
+
else
|
126
|
+
not_found
|
127
|
+
end
|
128
|
+
end
|
129
|
+
|
130
|
+
get "/messages/:id.plain" do
|
131
|
+
id = params[:id].to_i
|
132
|
+
if part = Mail.message_part_plain(id)
|
133
|
+
content_type part["type"], :charset => (part["charset"] || "utf8")
|
134
|
+
part["body"]
|
135
|
+
else
|
136
|
+
not_found
|
137
|
+
end
|
138
|
+
end
|
139
|
+
|
140
|
+
get "/messages/:id.source" do
|
141
|
+
id = params[:id].to_i
|
142
|
+
if message = Mail.message(id)
|
143
|
+
content_type "text/plain"
|
144
|
+
message["source"]
|
145
|
+
else
|
146
|
+
not_found
|
147
|
+
end
|
148
|
+
end
|
149
|
+
|
150
|
+
get "/messages/:id.eml" do
|
151
|
+
id = params[:id].to_i
|
152
|
+
if message = Mail.message(id)
|
153
|
+
content_type "message/rfc822"
|
154
|
+
message["source"]
|
155
|
+
else
|
156
|
+
not_found
|
157
|
+
end
|
158
|
+
end
|
159
|
+
|
160
|
+
get "/messages/:id/parts/:cid" do
|
161
|
+
id = params[:id].to_i
|
162
|
+
if part = Mail.message_part_cid(id, params[:cid])
|
163
|
+
content_type part["type"], :charset => (part["charset"] || "utf8")
|
164
|
+
attachment part["filename"] if part["is_attachment"] == 1
|
165
|
+
body part["body"].to_s
|
166
|
+
else
|
167
|
+
not_found
|
168
|
+
end
|
169
|
+
end
|
170
|
+
|
171
|
+
get "/messages/:id/analysis.?:format?" do
|
172
|
+
id = params[:id].to_i
|
173
|
+
if part = Mail.message_part_html(id)
|
174
|
+
# TODO: Server-side cache? Make the browser cache based on message create time? Hmm.
|
175
|
+
uri = URI.parse("http://api.getfractal.com/api/v2/validate#{"/format/#{params[:format]}" if params[:format].present?}")
|
176
|
+
response = Net::HTTP.post_form(uri, :api_key => "5c463877265251386f516f7428", :html => part["body"])
|
177
|
+
content_type ".#{params[:format]}" if params[:format].present?
|
178
|
+
body response.body
|
179
|
+
else
|
180
|
+
not_found
|
181
|
+
end
|
182
|
+
end
|
183
|
+
|
184
|
+
delete "/messages/:id" do
|
185
|
+
id = params[:id].to_i
|
186
|
+
if message = Mail.message(id)
|
187
|
+
Mail.delete_message!(id)
|
188
|
+
status 204
|
189
|
+
else
|
190
|
+
not_found
|
191
|
+
end
|
192
|
+
end
|
193
|
+
|
194
|
+
not_found do
|
195
|
+
erb :"404"
|
196
|
+
end
|
197
|
+
end
|
198
|
+
end
|
199
|
+
end
|
@@ -0,0 +1,21 @@
|
|
1
|
+
require "active_support/core_ext/module/delegation"
|
2
|
+
require "rack/builder"
|
3
|
+
|
4
|
+
require "mail_catcher/web/application"
|
5
|
+
|
6
|
+
module MailCatcher
|
7
|
+
module Web extend self
|
8
|
+
def app
|
9
|
+
@@app ||= Rack::Builder.new do
|
10
|
+
if ENV["MAILCATCHER_ENV"] == "development"
|
11
|
+
require "mail_catcher/web/assets"
|
12
|
+
map("/assets") { run Assets }
|
13
|
+
end
|
14
|
+
|
15
|
+
map("/") { run Application }
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
19
|
+
delegate :call, :to => :app
|
20
|
+
end
|
21
|
+
end
|