.. _sendemailrst:

==========
Send email
==========


.. only:: html

    **Links:** :download:`notebook <send_email.ipynb>`, :downloadlink:`html <send_email2html.html>`, :download:`PDF <send_email.pdf>`, :download:`python <send_email.py>`, :downloadlink:`slides <send_email.slides.html>`, :githublink:`GitHub|_doc/notebooks/send_email.ipynb|*`


Send mails with attachments from a notebook.

.. code:: ipython3

    with open("erty.txt", "w") as f:
        f.write("try.try.try")

.. code:: ipython3

    import pymmails

.. code:: ipython3

    server = pymmails.create_smtp_server("gmail", "xavier.somebody@gmail.com", "pwd")

In fonction
`create_smtp_server <http://www.xavierdupre.fr/app/pymmails/helpsphinx/pymmails/sender/email_sender.html#pymmails.sender.email_sender.create_smtp_server>`__,
the string ``gmail`` is replaced by ``smtp.gmail.com:567`` (tls
version). By default, the server cannot be accessed unless IMAP is
enabled (see `Problems sending mail with POP or
IMAP <https://support.google.com/mail/answer/78775>`__). You can usually
find this string by searching on internet for
``your provider smtp server``, you find pages such as `configuration des
serveurs sortants et entrants des principaux comptes
mails <http://assistance.orange.fr/configuration-des-serveurs-sortants-et-entrants-des-principaux-comptes-mails-1222.php>`__.
However, by doing this, you need to send your password. You should
remove your password wherever it appears as soon as you don’t need it
anymore. If you forget, I advise you to change it.

.. code:: ipython3

    pymmails.send_email(server, "xavier.somebody@gmail.com", "xavier.somebodyelse@else.com",
                    "results", "body", attachements = [ "erty.txt" ])

.. code:: ipython3

    server.quit()




.. parsed-literal::
    (221, b'2.0.0 closing connection e18sm17176289wjz.27 - gsmtp')



Module `keyring <https://pypi.python.org/pypi/keyring/>`__ should be
used to store password instead of letting them accessible in the
notebook.