145 commits

Author	SHA1	Message	Date
Winni Neessen	4e880ab31c	Refactor variable and function names for improved clarity in msg.go ... The change updates various variable and function names in msg.go to make the code more intuitive. Updated names better capture what they represent or do, improving code readability and maintainability. This refactor does not impact functionality or logic of the code.	2024-02-24 18:26:30 +01:00
Winni Neessen	263f6bb3de	Refactor SMTP client code for better readability ... The variable names in the code related to the I/O of the SMTP client have been clarified for improved readability and comprehension. For example, unclear variable names like `d` and `w` have been replaced with more meaningful names like `depth` and `writer`. The same naming improvements have also been applied to function parameters. This update aims to enhance code maintenance and simplify future development processes.	2024-02-24 12:43:01 +01:00
grigorii	a24906d185	Add an option to skip adding a User-Agent	2024-02-23 14:41:58 -08:00
Winni Neessen	f759b1b5fb	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2024-02-08 17:04:06 +01:00
Winni Neessen	a864be059c	Add "X-Auto-Response-Suppress" header and update SetBulk method ... A new "X-Auto-Response-Suppress" header has been added. The SetBulk method has been updated to include this new header, as it is recommended for automated emails. This functionality is tested in the msg_test.go file.	2024-02-08 16:45:06 +01:00
Winni Neessen	bda6b8c899	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2024-02-05 13:00:21 +01:00
Winni Neessen	ef86a1a1fb	Add Charset support for message parts ... Charset support has been added in the 'Part' struct. A 'SetCharset' method and a 'WithPartCharset' option have been added to override the default Part charset. The 'writePart' function in msgWriter now accommodates the charset defined at the Part level, defaulting to the previous functionality if not set.	2024-01-31 16:28:41 +01:00
Winni Neessen	f7ba3a1d02	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2024-01-25 11:21:38 +01:00
Winni Neessen	0b622368ba	#166: Add delivery status indication for messages ... This update introduces a new property, `isDelivered`, in the message struct to track if a message has been successfully sent or not. Additionally, this also includes a new helper function `IsDelivered` to easily retrieve the status. This feature enhances the tracking capabilities of outgoing messages across different client files.	2024-01-23 11:01:08 +01:00
Winni Neessen	8b19e497a0	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2024-01-10 11:07:54 +01:00
rami	bd6250a8c2	Added return error to fileFromReader	2023-12-24 17:04:55 +01:00
Winni Neessen	a12d9c327f	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2023-12-07 13:21:30 +01:00
Winni Neessen	da21550dc9	Fix potential null pointer exceptions in msg.go ... This commit adds conditions in msg.go file to check if the header 'HeaderDispositionNotificationTo' key exists in the map 'm.genHeader' before trying to associate it with a value. This prevents potential null pointer exceptions.	2023-11-29 17:26:58 +01:00
Winni Neessen	ca896bd641	Refactor error checking in msg.SendErrorIsTemp() ... Added an additional condition in the SendErrorIsTemp function within msg.go to ensure that the error e is not nil before referencing it. This guards against potential runtime panics from dereferencing a nil pointer, enhancing robustness of error handling.	2023-11-29 16:45:25 +01:00
Winni Neessen	a50a3ceb18	Add validation for nil STDERR or STDIN pipe ... Introduced a new condition that checks and returns an error if either STDERR or STDIN pipe is nil in the msg function of msg.go. This improves error handling by preventing potential panic due to referencing a nil pipe.	2023-11-29 16:43:50 +01:00
Winni Neessen	1a166770b7	Update range loop to improve msg function readability ... Converted the range loop in the GetAddrHeaderString function in msg.go to use value semantics rather than index notation. This improves code clarity by not unnecessarily referring to m.addrHeader[h] in the loop and instead referencing the value directly (using variable mh), making it easier to understand and maintain.	2023-11-29 16:42:07 +01:00
Winni Neessen	468e1e2b2c	Protect against empty address list, refactor error handling ... Added a condition to prevent assignment of an empty address list to the 'HeaderFrom' scenario. This eliminates potential runtime errors when trying to access an nonexistent element of a slice. Adjusted error handling in the sendmail execution part by reusing the 'err' variable, promoting cleaner, more readable code.	2023-11-20 18:36:19 +01:00
Winni Neessen	1e447b5f2c	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2023-11-10 18:23:52 +01:00
Winni Neessen	cc14864129	#152: Add new methods and tests for handling email addresses ... Added new methods `ToFromString()`, `CcFromString()` and `BccFromString()` in msg.go file to handle strings of comma-separated email addresses.	2023-11-10 18:07:56 +01:00
Winni Neessen	6bda5d1aaa	Merge branch 'main' into feature/145_add-eml-parser-to-generate-msg-from-eml-files	2023-10-20 14:23:24 +02:00
leahoop	3c2c106cb4	#147 add remove attachments and embeds methods	2023-10-20 10:21:03 +08:00
Winni Neessen	e7c717d0fc	"Rename Mime10 to MIME10 in codebase ... Renamed field 'Mime10' to 'MIME10' across multiple files for canonical representation and consistency with standard MIME naming format in the protocol."	2023-10-13 15:23:28 +02:00
Winni Neessen	438cfd60eb	Preparation for the v0.4.0 release: ... - Bump version in doc.go - Add sonarlint to .gitignore - Update README to reflect the changes and contributors - Fixed typos in auth_cram_md5_118.go, msg.go, msg_test.go, reader.go and smtp_ehlo_117.go	2023-05-31 09:34:45 +02:00
Christian Vette	20fe4cd751	fix: parsing of ReplyTo with special characters	2023-03-07 10:51:15 +01:00
Winni Neessen	fa0b9709f6	Correct method names in caveat comment	2023-01-31 21:57:10 +01:00
Winni Neessen	d33f0e8004	Merge branch 'main' into feature/107_provide-more-ways-for-middleware-to-interact-with-mail-parts	2023-01-31 20:47:36 +01:00
Winni Neessen	dab860834a	Adding PGPType to Msg as preparation to support PGP/MIME in go-mail-middleware	2023-01-31 18:35:48 +01:00
Winni Neessen	c9794069cd	Add Caveat note about the io.Reader methods being memory inefficient	2023-01-31 17:48:19 +01:00
Winni Neessen	e66ad2be1a	Fix Attach/EmbedReader and implement Attach/EmbedReadSeeker ... This PR addresses #110. `Msg.AttachReader()` would not output the attached file after consecutive writes (e.g. a write to a file and then send via Client). This PR fixes this behaviour by first reading the io.Reader into memory and then creating a new `bytes.Reader`, which does support seeking. In the writeFunc we then seek to position 0 after a successful `io.Copy`. This is probably not the most memory efficient way of handling this, but otherwise we'll have to break the `io.Reader` interface. Additionally, a new way of attaching/embedding files has been added: `Msg.AttachReadSeeker()` and `Msg.EmbedReadSeeker()` which take a ´io.ReadSeeker` as argument instead. These two methods will skip the reading into memory and make use of the `Seek` method of the corresponding interface instead.	2023-01-31 17:38:31 +01:00
Winni Neessen	25e00c64e2	Introduce GetEmbeds() and SetEmbeds() ... These two methods work analogous to the `*Attachments()` methods and provide the user with access to the embedded files.	2023-01-29 13:48:51 +01:00
Winni Neessen	9724a2b523	Introducing Msg part deletion ... This PR introduces a new struct field for the message parts: `del` If the del flag is set to `true`, the msgWriter will ignore this part during the writing process. Additionally, the `part` has now a `Delete` method that lets the user mark the part as deleted This allows middleware to take further control of the Msg and is part of #107	2023-01-28 14:39:14 +01:00
Winni Neessen	3922d3f195	Switched copyright header from me to "The go-mail Authors"	2023-01-15 16:14:19 +01:00
Winni Neessen	5897bddd11	Update msg.go ... Co-authored-by: iwittkau <iwittkau@users.noreply.github.com>	2023-01-02 22:29:10 +01:00
Winni Neessen	dbb596893d	Update msg.go ... Co-authored-by: iwittkau <iwittkau@users.noreply.github.com>	2023-01-02 22:28:39 +01:00
Winni Neessen	f6709e90cd	Make golangci-lint happy by using errors.As instead of using type assertion on error (which can fail on wrapped errors)	2023-01-01 14:25:00 +01:00
Winni Neessen	78df991399	Proposal change for #90 ... Did a complete overhaul of the senderror.go. - the list of `errors.New()` has been replaced with constant itoa error reasons as `SendErrReason`. Instead, the `Error()` method now reports the corresponding error message based on the reason. - The `SendError` received a `Is()` method so that we can use `errors.Is()` for very specific error checking. I.e. we can check for `&SendErrors{Reason: ErrSMTPMailFrom, isTemp: true}`. This provides much more flexibility in the error checking capabilities - A `isTemp` field has been added to the `SendError` type, indicating whether the received error is temporary and can be retried or not. Accordingly, the `*Msg` now has a `SendErrorIsTemp()` method indicating the same. The decision is based on the first 3 characters returned from the SMTP server. If the error code is within the 4xx range, the error is seen as temporary - A test for the SendError type has been added	2023-01-01 14:20:13 +01:00
Winni Neessen	47bff15de9	Introduction of a Msg error type as proposal for #90 ... This PR introduces the `SendError` type which implements the error interface. A new `senderror` field has been added to the `Msg` as well, so introduce this type to it. I've also added different error variables that indicate the different things that can go wrong during mail delivery. These variables can be checked for, for each `Msg` using the `errors.As` method The `Error()` method of `SendError` will return a detailed error string on why the `Msg` could not be delivered. Additionally, `HasSendError()` and `SendError()` methods have been added to `Msg`. While `HasSendError()` simply returns a bool in case a `Msg` failed during delivery, the `SendError()` will return the full `SendError` error interface.	2022-12-31 12:40:42 +01:00
Winni Neessen	17b9d2ccf6	#80: GetAddrHeader and SetGenHeader ... This PR introduces two major changes: * SetHeader and SetHeaderPreformatted have been deprecated in favour of SetGenHeader and SetGenHeaderPreformatted As pointed out in #80 the naming was pretty confusing, given that we already have SetAddrHeader. With the new naming convention it should be more clear. For compatibility reasons the old methods have been kept for now but in reality they are just aliases to the new methods * GetAddrHeader and GetAddrHeaderString have been introduced As requested in #80 analogous to GetGenHeader we also need a similar method for the address headers. Since address headers are *mail.Address pointer, we've also added a *String method that will extract the address string and return a string slice instead Additionally we're introducing methods for the actual address headers: GetTo, GetFrom, GetCc and GetBcc (with a *String counterpart as well). This way the user has full flexibility. Either they use the more "low-level" GetAddrHeader method or the higher level methods for the corresponding address type	2022-11-19 11:22:20 +01:00
Winni Neessen	d327ca73e4	The new messageID generated with #76 is a bit too long by default. This patch reduces the length	2022-10-26 15:48:48 +02:00
Winni Neessen	2e60d070a6	Add SetHeaderPreformatted() method ... With the SetHeaderPreformatted() method we have the ability to set headers that are already preformatted by the user and will not be altered in the mail message output	2022-10-26 15:33:03 +02:00
Winni Neessen	8484e557d0	Replace math/rand with crypto/rand ... Since the Windows tests were still failing, we are replacing the random number generation with math/rand with random string generation via crypto/rand	2022-10-26 14:05:25 +02:00
Winni Neessen	5bf0c10525	Randomness apparently not good enough for windows. Tests were failing. This fix improves it	2022-10-26 13:43:51 +02:00
Winni Neessen	021e003e78	Closes #74 ... This fix makes sure that generated message IDs via SetMessageID() are truly random and unique	2022-10-26 11:59:03 +02:00
Winni Neessen	2bd6851c78	Fix in the storage of the original Middleware	2022-10-25 16:56:40 +02:00
Winni Neessen	6f93e5835e	Introducing MiddlewareType and WriteToSkipMiddleware ... For middlewares to be able to access the fully written mail message, we need a way to execute WriteTo without the calling middleware to be handled, otherwise we end up in an infinite loop Therefore, this PR introduces the MiddlewareType and the corresponding change of the Middleware interface. We now require to return the MiddlewareType when the Type() method on the interface is called This way we can also introduce the WriteToSkipMiddleware method which takes a MiddlewareType as argument. This will allow us to use a WriteTo call with the initiating Middleware to be skipped	2022-10-25 16:42:18 +02:00
Winni Neessen	b6beeb5cae	Finalized the Reader type and removed the broken Read() method	2022-10-20 18:26:51 +02:00
Winni Neessen	183fb347d6	Fix create header maps in case SetHeader or SetAddrHeader is called on an empty Msg type	2022-10-20 18:06:26 +02:00
Winni Neessen	5faa6dfbd6	We now return a Reader instead of the io.Reader interface	2022-10-20 18:03:57 +02:00
Winni Neessen	966615584d	Implement a proper io.Reader interface since the current implementation is flawed	2022-10-20 15:52:53 +02:00
Dhia Gharsallaoui	b94a42ebe8	Expose Msg attachments fields	2022-10-12 13:36:52 +02:00
Winni Neessen	dbe58745be	#60 Working on Get/Set methods to access the Msg part slice ... Still some tests needed	2022-10-11 17:05:44 +02:00
Winni Neessen	cd2ee86846	Added GetGenHeader to the Msg to grant read access to set generic headers (e g. to use in Middlewares)	2022-10-02 12:25:49 +02:00
dhia gharsallaoui	a4733f0618	Implement middleware concept and their test	2022-09-22 18:05:47 +02:00
Winni Neessen	c1d4dbedee	Remove not needed loop from RequestMDNAddTo	2022-09-09 11:39:08 +02:00
Winni Neessen	46001dc691	Added support for requesting MDNs as described in RFC 8098	2022-09-09 11:35:45 +02:00
Winni Neessen	192627f6a5	Closes #29: Allow attaching/embedding from embed.FS ... - Added `EmbedFromEmbedFS()` to allow embedding from embed.FS - Added `AttachFromEmbedFS()` to allow attaching from embed.FS - Added `fileFromEmbedFS()` as internal method for both other m methods to attach/embed the embed.FS file	2022-07-07 10:46:57 +02:00
Winni Neessen	31001e87b2	#24: Add SPDX license IDs for REUSE compliance ... # SUMMARY * Bad licenses: * Deprecated licenses: * Licenses without file extension: * Missing licenses: * Unused licenses: * Used licenses: CC0-1.0, MIT * Read errors: 0 * Files with copyright information: 45 / 45 * Files with license information: 45 / 45 Congratulations! Your project is compliant with version 3.0 of the REUSE Specification :-)	2022-06-17 15:05:54 +02:00
Winni Neessen	a50910b943	#21: Add possbility to set dedicated envelope from address ... - Added `EnvelopeFrom()` and `EnvelopeFromFormat()` methods analogous to the `From()` `FromFormat()` methods - Changed MsgWriter logic for envelope from addresses - Adjusted `Msg.GetSender()` to return the envelope from first and only mail body from if the envelope is not set	2022-06-13 10:18:35 +02:00
Winni Neessen	95100545d6	#18: Added Msg.WriteToFile which allows storing the Msg in a file	2022-06-06 16:43:04 +02:00
Winni Neessen	97e1386e36	Code smell fix for #13 ... SonarQube identified two code smells for duplicate string usage	2022-06-03 12:27:26 +02:00
Winni Neessen	08cf367772	#13: Avoid nil pointer references in template handling	2022-06-03 11:08:33 +02:00
Winni Neessen	8919d64ca1	#13: Both html/template and text/template support added ... - Switched the previous implementation to support text/template as well as html/template - Added SetBody*Template() methods to use a template directly as message body - Added AddAlternative*Template() methods to use a template directly as alternative message part	2022-06-03 10:40:54 +02:00
Winni Neessen	f24a86a4c6	Fix spelling	2022-06-02 16:22:48 +02:00
Winni Neessen	645ad2ce93	#13 Allow attaching/embedding templates ... Implemented the AttachTemplate and EmbedTemplate methods. Test coverage and documentation is still to be done	2022-06-01 16:49:34 +02:00
Winni Neessen	dd02ac229b	Closes #11 ... This PR adds a `Msg.Read()` method which satisfies the `io.Reader` interface	2022-05-28 10:58:19 +02:00
Winni Neessen	ebef1fe476	Fixes #8 ... We were using `io.Copy` to write to the body string/alternative string to the io.Writer. This placed the byte position of the buffer to be at the EOF after the first `WriteTo()` call leaving the output of a 2nd call to `WriteTo()` empty.	2022-05-27 12:47:33 +02:00
inliquid	4fe503d142	- Stderr should be read after closing Stdin ... - Fix reading of Stderr contents - Remove redundand calls to `Close`	2022-05-26 14:37:23 +03:00
Winni Neessen	fa7066c9cf	Update path to sendmail binary ... On most systems sendmail is located in /usr/sbin not /usr/bin	2022-05-25 10:53:37 +02:00
Winni Neessen	070eb39132	Address #5 ... For the WriteToSendmail* methods the STDIN pipe should be closed so that a forced EOF is sent to the sending program	2022-05-25 10:46:50 +02:00
Winni Neessen	894ff7128c	Rename Write() to WriteTo() so it satisfies the io.WriteTo interface	2022-05-24 15:46:59 +02:00
Winni Neessen	030eba8cfd	Default header and sorting ... - Default headers are set in its own method now - Generic headers are now sorted before being written	2022-03-20 19:11:58 +01:00
Winni Neessen	b852a5281a	v0.1.6: Fix in writeHeader() and User-Agent ... - The writeHeader() method wasn't producing good output for long headers. This has been fixed - Added a VERSION string to the library - If both no User-Agent and no X-Mailer header are set, the lib adds a default UA-header	2022-03-20 17:38:46 +01:00
Winni Neessen	b6d90eac6a	*Reader() methods don't need to check for nil, as the underlying fileFromReader does never return nil	2022-03-19 16:55:30 +01:00
Winni Neessen	e379128c83	Still trying to fix the GH issues with MacOS' broken pipe	2022-03-18 23:28:11 +01:00
Winni Neessen	0e00b165f9	WriteToSendmailWithContext tests revealed a race condition which has been fixed	2022-03-18 22:23:03 +01:00
Winni Neessen	3c642be4eb	Added WriteToSendmailWithCommand which is more generic and takes a command to sendmail ... The code of WriteToSendmail has been refactored to return the new WriteToSendmailWithCommand using SendmailPath	2022-03-18 21:07:07 +01:00
Winni Neessen	709b4e6b91	Switched write functions to return the number of bytes. Due to failing tests in Msg.Write()	2022-03-18 17:08:05 +01:00
Winni Neessen	f8a9512462	More tests for msg.go	2022-03-18 11:47:50 +01:00
Winni Neessen	a87577d388	Attachment names should probably be encoded	2022-03-15 12:12:45 +01:00
Winni Neessen	ce1c37bd16	Check if Attachments/Embeds can be read. If an error occurs don't add them to the mail parts	2022-03-15 11:56:21 +01:00
Winni Neessen	557a161a12	Fix in address handling and more header related methods	2022-03-14 16:25:24 +01:00
Winni Neessen	ebd8f94c1f	Make GoLinter happy	2022-03-14 15:30:41 +01:00
Winni Neessen	54da622bd1	Added WriteToSendmail()/WriteToSendmailWithContext() to allow sending mails via local sendmail binary	2022-03-14 15:26:53 +01:00
Winni Neessen	3e43819b57	Added SetDateWithValue() as well as Reset() to Msg	2022-03-14 11:50:36 +01:00
Winni Neessen	1157180369	v0.1.1: Added embeds/attachments	2022-03-14 10:29:53 +01:00
Winni Neessen	62bf1ae33a	Fix SetEncoding()	2022-03-13 20:01:02 +01:00
Winni Neessen	3261e4d2af	Added ReplyTo()/ReplyToFormat()	2022-03-13 19:36:24 +01:00
Winni Neessen	8e31cf0133	Fix for X-Priority	2022-03-13 19:28:40 +01:00
Winni Neessen	06aff07a03	Added Importance header functions	2022-03-13 19:24:46 +01:00
Winni Neessen	96dab9103c	Make Linter happy	2022-03-13 17:58:47 +01:00
Winni Neessen	8c804ec573	Implemented MIME multipart handling for alternative content	2022-03-13 17:15:23 +01:00
Winni Neessen	a85b761f43	msg.go has almost full test coverage now	2022-03-13 11:31:33 +01:00
Winni Neessen	012303e5ac	Lots of tests and helpers added	2022-03-13 10:49:07 +01:00
Winni Neessen	7266155cf4	Added AddTo() and FromFormat()	2022-03-12 20:05:43 +01:00
Winni Neessen	06e37755f2	Some progress was made: ... - Implemented proper AUTH LOGIN mechanism - Implemented msgWriter for handling io - Implemented proper mail header formatting/output - Minor refactoring	2022-03-12 15:10:01 +01:00

Renamed from mailmsg.go (Browse further)