Metadata-Version: 2.1
Name: mercurio
Version: 0.10.2
Summary: Send email with python, my way
Home-page: https://github.com/pietrogiuffrida/mercurio/
Author: Pietro Giuffrida
Author-email: pietro.giuffri@gmail.com
License: MIT
Description: # Mercurio
        
        Send email with python, my way.
        
        Mercurio is a simple class to send email with python, managing
        smtp, attachments and mimetypes, multiple recipients,
        attachments with a specific content id (to html email templating)...
        
        ## Installation
        
        Installation is as easy as run:
        ```pip install mercurio```
        
        ## Usage
        
        To initialize a mercurio instance simply call it with
        typical smtp parameters. No connection will be opened
        at this stage, then you can initialize and reuse it
        during the whole code.
        
        ```python
        from mercurio import mercurio
        
        hg = mercurio(
            host="smtp.test.com",
            port=25,
            smtp_user="myuser",
            smtp_pwd="mypwd"
        )
        ```
        
        To debug purposes, you can create the message and save it in a file
        without send it thgrougth smtp. You can open such file
        with a normal email client.
        
        ```python
        message = hg.make_message(
            fromaddress="from@me.com",
            recipient="to@me.com",
            reply_to_address="reply@to.me",
            text="a long text, very long.",
            sbj="The subject, or the object?",
            attachments=[],
            cid_attachments={}
        )
        
        with open('test_email.eml', 'w') as o:
            o.write(message.as_string())
        ```
        
        
        Send a real message is easy: use
        an hg instance, and call
        send method with its parameters. Note that you can
        send multiple type of attachments (images, xlsx, json,
        txt). Mercurio can choice the correct mime type.
        You can also use attachment with a specific content
        id, that can be used in html email to include
        images in the body of the message.
        
        ```python
        hg.send(
            fromaddress="from@me.com",
            recipients=["to@me.com"],
            reply_to_address="reply@to.me",
            text="a long text, very long.",
            sbj="The subject, or the object?",
            attachments=[],
            cid_attachments={"content_id_01": "mylogo.png"}
        )
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
