Metadata-Version: 2.4
Name: ruth-emailer
Version: 2022.0.0
Summary: Python email utils package
Author-email: Eyes Rutherford <ruth-tools@inbox.ru>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: ruth-tokenizer>=2022.0.0
Requires-Dist: ruth-logger>=2022.0.0
Requires-Dist: email-validator>=2.3.0
Dynamic: license-file

# Emailer

This module was created to use in email address validation and sending emails with/without message content and with/without attachments.


Examples:

- [ ] email address validation:

    ```python
    from emailer import EmailAddress
    
    # instance
    email = EmailAddress(email='some@email.com')
    print(f'Email address "{email.email}" is valid: {email.is_valid}')
    
    # static
    for email_address in ('first@email.com', 'second@email.com', 'third@email.com'):
        is_valid, details = EmailAddress.validate(email=email_address)
        print(f'Email address "{email_address}" is valid: {is_valid}')
    ```
  
- [ ] email sending:
    ```python
    from emailer import Email
    
    email = Email(
        server='email@server.com', username='usr', password='pwd',
        from_='from@email.com',
        to=['to-1@email.com', 'to-2@email.com'],
        cc=['cc-1@email.com', 'cc-2@email.com'],
        bcc=['bcc-1@email.com', 'bcc-2@email.com'],
        subject='subject',
        message='message',
        attachments=[
            ('att-1.txt', b'1st file content'),
            ('att-2.txt', b'2nd file content')
        ]
    )

    email.send()
    ```
