Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

mail1 is an API to send emails in a single call

Project Description

Mail1 is an API to send email with a single function call. For instance, we could send an email running:

import mail1

           text='This is a test!',

That’s it!

send() method

The signature of the method to send an email is the following:

send(subject, text, text_html=None, sender=None,
     recipients=[None], cc=[], bcc=[], attachments={},
     smtp_host=SMTP_HOST, smtp_port=SMTP_PORT,

The parameters are the following:

  • subject: this is the subject of the email, as a string.
  • text: this is the text of the email as a string.
  • text_html: text as HTML.
  • sender: email address of the sender of the email.
  • recipients: the list of recipients, or the recipient as a string if there is a single one (this is NOT a coma separated list).
  • cc: the list of carbon copies.
  • bcc: the list of blind carbon copies.
  • attachments: a dictionnary that gives the file name for a given attachment name.
  • smtp_host: the hostname of the email server.
  • smtp_port: the port of the email server (defaults to 25).
  • encoding: the encoding of the message.

Command line

You can also invoke this script on command line to send emails. To get help about command line parameters, type mail1 -h, which will display following help page:

mail1 [-h] -f from -r recipient -s subject -a file
           -m smtphost -e encoding message
Send an email with following:
-h            Print this help page
-f from       The mail sender
-r recipient  The mail recipient (repeat for more than one recipient)
-s subject    The mail subject
-a file       A file to attach
-m smtphost   The SMTP server host
-e encoding   The encoding to use
message       The message


Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(7.5 kB) Copy SHA256 Hash SHA256
Source Sep 1, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting