From 6d3d2869bb2105c3a9ffb54ed816d8f53c56c1ed Mon Sep 17 00:00:00 2001 From: Martin Ashby Date: Thu, 24 Aug 2023 17:35:37 +0100 Subject: Initial --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..2b0ab93 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# smtp-zig + +SMTP client library for zig. + +WORK IN PROGRESS. + +TODO: +- [ ] Dot encoding/escaping +- [ ] Lots more tests +- [ ] Support more extensions and authentication mechanisms +- [ ] Zig package management + +Code example: +``` +const std = @import("std"); +const client = @import("smtp"); + +pub fn main() !void { + const mail = + \\Subject: test + \\From: + \\To: + \\ + \\This is a test message + ; + const user = std.os.getenv("SMTP_USERNAME").?; + const pass = std.os.getenv("SMTP_PASSWORD").?; + var client = try Client.init(std.heap.page_allocator, "mail.mfashby.net:587", .{.user = user, .pass = pass}); + defer client.deinit(); + try client.send_mail("martin@mfashby.net", &[_][]const u8{"martin@mfashby.net"}, mail); + try client.quit(); +} +``` + +This project is licensed under the terms of the MIT license. \ No newline at end of file -- cgit v1.2.3-ZIG