Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/moteus/lua-sendmail
Simple wrapper around luasoket smtp.send
https://github.com/moteus/lua-sendmail
email lua smtp
Last synced: 2 months ago
JSON representation
Simple wrapper around luasoket smtp.send
- Host: GitHub
- URL: https://github.com/moteus/lua-sendmail
- Owner: moteus
- License: mit
- Created: 2012-09-12T10:57:28.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2021-08-28T08:09:13.000Z (over 3 years ago)
- Last Synced: 2024-11-01T10:42:40.980Z (2 months ago)
- Topics: email, lua, smtp
- Language: CMake
- Size: 66.4 KB
- Stars: 30
- Watchers: 4
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
lua-sendmail
============
[](LICENCE.txt)
Simple wrapper around luasoket smtp.send.
See [documentation](http://moteus.github.io/sendmail/index.html).
## Usage
```Lua
local sendmail = require "sendmail"
local from, to, server = '[email protected]', '[email protected]', '127.0.0.1'
sendmail(from, to, server, {"Subject", [[
This is mail body.
]],
file = {
name = 'message.txt';
data = 'file content';
};
})
```
### Send mail with SSL/TLS connection (using LuaSec)
```Lua
sendmail{
server = {
ssl = {
protocol = "sslv3",
verify = {"peer", "fail_if_no_peer_cert"},
options = {"all", "no_sslv2"},
},
address = ...;
user = ...;
password = ...;
},
...
}
```
### Send mail with SSL/TLS connection (using custom SSL connection)
```Lua
-- I use lua-lluv-ssl library.
local ut = require "lluv.utils"
local ssl = require "lluv.ssl"
local socket = require "lluv.ssl.luasocket"
-- this is asyncronus call
ut.corun(sendmail, {
server = {
ssl = ssl.context{
protocol = "sslv3",
verify = {"peer", "fail_if_no_peer_cert"},
options = {"all", "no_sslv2"},
},
create = socket.ssl;
address = ...;
user = ...;
password = ...;
},
...
})
```
### Send attached files as single zip archive
```Lua
local ZipWriter = require "ZipWriter"
sendmail{
...
message = {
...
file = {
source = ZipWriter.source(ZipWriter.new(), {
{"file01.txt", "path/to/file01.txt"},
{"file02.txt", "path/to/file02.txt"},
}),
name = 'files.zip';
}
}
}
```
## Dependences
* [LuaSocket](https://luarocks.org/modules/luarocks/luasocket)
* [LuaSec](https://luarocks.org/modules/brunoos/luasec) - to support SMTPS protocol
* [Lua-cURL](https://luarocks.org/modules/moteus/lua-curl) - can be used to handle SMTP(S) protocol and IO. Still require LuaSocket to build message itself