pysgs

PYSGS

This is a small tool designed as part of learning, allows sending SendGrid messages via SMTP

Table of Contents

• Installation
• Setup
  • Headers
  • Sender
• Usage
  • Plain text
  • HTML Content
  • Attachment
• Example

Installation

pip install pysgs

Setup

import pysgs
service = pysgs.mailer('SENDGRID_API_KEY')

Headers

sender = "[e-mail]"
recipient = "[e-mail]"
subject = "This is a Subject!!"
service.headers(sender, recipient, subject)

Sender

There are different ways to set recipent emails.

• [e-mail]
• [e-mail], [e-mail]
• User [e-mail]
• User [e-mail], Another User [e-mail]

You can also send a list of recipients

recipients = [
    "User <[e-mail]>",
    "Another User <[e-mail]>"
]

Usage

Plain text

service.content('Message from sendgrid')
service.send()

HTML Content

service.content('<h1>Hello World!</h1>', 'html')
service.send()

Attachment

service.content('/path/to/file/audio.mp3', is_attach=True)
service.send()

Example

import pysgs
from pysgs.exceptions import SGSError

try:
    """Start connection"""
    service = pysgs.mailer("SENDGRID_API_KEY")

    """Set message headers"""
    sender = "[e-mail]"
    recipient = "[e-mail]"
    subject = "This is a Subject!!"
    service.headers(sender, recipient, subject)

    """Set content"""
    service.content('Message from sendgrid')
    service.content('<h1>Hello World!</h1>', 'html')
    service.content('/path/to/file/audio.mp3', is_attach=True)

    """Send message"""
    service.send()

    """Finish service"""
    service.close()

except SGSError as e:
    print('There was an error: ' + str(e))