idutchy / gmailpy

An API wrapper for Gmail

Gmailpy

A simple API wrapper for sending emails with Gmail

Getting Started

Install via pip (recommended)

pip install gmailpy

Install from source

pip install git+https://github.com/iDutchy/gmailpy

Getting Started

First you need to create your client:

import gmailpy

client = gmailpy.Client("[email protected]", "P@$$w0rd")

Usage

await client.send(receiver, content, subject=None, bcc=None, attachment_bytes=None, attachment_name=None)

• Parameters:

  • reveiver (string): The receivers email address
  • content (string): The content of the email
  • subject (string): The email subject. Defaults to "No subject"
  • bcc (list): A list of other email addresses you want to send the mail to as BCC. Defaults to None
  • attachment_bytes (byte array): Attach anything to the email. This has to be a byte array! When providing this, the attachment_bytes argument becomes required! Defaults to None
  • attachment_name (string): The full name of the attachment. This has to contain the file extension too! e.g "dog.png". This is required when providing attachment_bytes. Defaults to None

gmailpy's Issues

Fixed the "Less Secure App Error"

I edited the code a bit to fix it.

import smtplib
import ssl

from email import encoders
from email.mime.base import MIMEBase
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText

class Error(Exception):
    pass

class Client:
    def __init__(self, mail, password):
        self.mail = mail
        self.password = password
        
        
    async def send(self, receiver, body, subject=None, bcc=None, attachment_bytes=None, attachment_name=None):
        sender_email = self.mail
        password = self.password

        message = MIMEMultipart()
        message["From"] = sender_email
        message["To"] = receiver
        message["Subject"] = subject if subject else "No subject"
        message["Bcc"] = bcc

        message.attach(MIMEText(body, "plain"))
        
        if attachment_name is None and attachment_bytes is not None:
            raise Error('You did not provide an attachment name for your attachment!')
            
        if attachment_name is not None and attachment_bytes is None:
            raise Error('Can not set an attachment name without an attachment!')
        
        if attachment_bytes is not None and attachment_name is not None:
            part = MIMEBase("application", "octet-stream")
            part.set_payload(attachment_bytes)

            encoders.encode_base64(part)

            part.add_header(
                "Content-Disposition",
                f"attachment; filename= {attachment_name}",
            )

            message.attach(part)

        text = message.as_string()

        server = smtplib.SMTP(host="smtp.gmail.com", port=587)
        server.starttls()
        server.login(sender_email, password)
        server.sendmail(sender_email, receiver, text)