THE PROJECT IS ARCHIVED. NO ISSUES / PULL REQUESTS CAN BE OPENED. FEEL FREE TO FORK.

An extension of standard smtplib, which supports proxy tunneling.

Package works on Python 2.7+ and Python 3.5+.

Using PySocks.

You can install xsmtplib from PyPI by running:

pip install xsmtplib

Or you can just download tarball / clone the repository and run:

python setup.py install

Alternatively, include just xsmtplib.py in your project.

xsmtplib extends standard python smtplib, so it can be used instead without any compatibility issues.

Connection to SMTP server via proxy can be done during instance initialization:

from xsmtplib import SMTP

server = SMTP(host="smtp.example.com", proxy_host="proxy.example.com")
server.sendmail("[email protected]", "[email protected]", "I have an issue. Please help!")
server.quit()

Alternatively, you can connect to SMTP server manually when you need to:

from xsmtplib import SMTP

server = SMTP(timeout=30)
server.set_debuglevel(1)
server.connect_proxy(proxy_host="proxy.example.com", host="smtp.example.com")
server.helo("[email protected]")
server.sendmail("[email protected]", "[email protected]", "I have an issue. Please help!")
s.quit()

SMTPS (SSL SMTP) and LMTP connections via proxy are not supported yet.

See LICENSE file for more details.