feat(email_sender): add max size to the attachments

[JRocabruna]

Feature/Implement Maximum Attachment Size for Email Messages

Description

This pull request introduces a new feature that allows setting a maximum size for attachments in EmailMessage instances within the gomail package. The feature includes:

• A default maximum attachment size of 25 MB.
• A method to set a custom maximum attachment size.
• Logic to exclude attachments that exceed the specified maximum size during the email sending process.
• Comprehensive updates to the documentation to describe the new feature and provide instructions on its usage.

This enhancement improves the usability and reliability of the gomail package by preventing large attachments from causing email delivery failures. It aligns with best practices for email transmission and assists users in avoiding common issues.

• Related Issue: Closes [FEATURE] - Implement Maximum Attachment Size for Email Messages #11
• Type of Change:
  • New feature (non-breaking change which adds functionality)

Checklist

Please ensure the following guidelines are met:

• The code follows the style guidelines of this project.
• A self-review has been performed on the code.
• The code is well-documented, and comments have been added where necessary.
• Tests have been added to prove that the fix is effective or that the feature works. All existing tests pass.
• Commit messages follow the convention type(scope): description.
• The pull request has no conflicts with the base branch.
• Any dependent changes have been merged and published in downstream modules.

Additional Information

This feature will enhance the usability and reliability of the gomail package by preventing large attachments from causing email delivery failures. The implementation includes comprehensive tests to ensure the feature works as intended and does not introduce regressions. The documentation has been updated to reflect these changes and provide guidance on using the new functionality.

The merge-base changed after approval.

The merge-base changed after approval.

[codecov-commenter]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

[DarkRockMountain-admin]

Comments

The addition of the maximum attachment size feature provides a useful constraint to prevent issues with large email attachments, ensuring compatibility with email provider limits. The default size and the ability to set a custom size add flexibility for users. Documentation and tests have been updated to reflect these changes.

Review Checklist

• Code adheres to the project's coding guidelines.
• Changes are well-documented.
• Tests have been added/updated and pass successfully.
• Commit messages follow the correct format: type(scope): description.
• No conflicts with the base branch.

Approval

Approved: Changes look good and meet the project's contribution standards.