Skip to main content

Python module to, send SMS, emails and read unread emails.

Project description

Pypi-version Pypi-py-version

docs pypi

Pypi-format Pypi-status

Maintained GitHub Repo created GitHub commit activity GitHub last commit

Gmail Connector

Python module to, send SMS, emails and read unread emails in inbox folder.

Uses the default python modules:
  • email - Format emails as MIMEMultipart object, read emails from bytes and str and decode headers.
  • smtplib - SMTP Simple Mail Transfer Protocol to connect to gmail server, do auth and perform outgoing tasks.
  • imaplib - IMAP Internet Message Access Protocol to access messages in an email mailbox.
  • datetime - Uses datetime module to skim the date and time when the email arrived.

Pypi Module

https://pypi.org/project/gmail-connector/

Usage

pip install gmail-connector


Send SMS

from gmailconnector.send_sms import Messenger

messenger = Messenger(
    gmail_user='username@gmail.com',
    gmail_pass='<ACCOUNT_PASSWORD>',
    phone_number='+11234567890',
    message='Test SMS using gmail-connector'
)
print(messenger.send_sms())

Send Email

from pathlib import PurePath
from gmailconnector.send_email import SendEmail

email_obj = SendEmail(
        gmail_user='username@gmail.com',
        gmail_pass='<ACCOUNT_PASSWORD>',
        recipient='another_username@gmail.com',
        subject='Howdy!',
        attachment=PurePath(__file__).name,  # filename of the attachment
        body='Attached is the code that generated this very email',
        sender=None
    )
print(email_obj.send_email())

Read Email

from gmailconnector.read_email import ReadEmail

ReadEmail(
    gmail_user='username@gmail.com',
    gmail_pass='<ACCOUNT_PASSWORD>'
).read_email()

Pre-Commit

Install pre-commit to run flake8 and isort for linting and sphinx for documentation generator.

pip3 install pre-commit==2.13.0 Sphinx==4.1.1

pre-commit run --all-files

Runbook

https://thevickypedia.github.io/gmail-connector/

License & copyright

© Vignesh Sivanandha Rao, Gmail Connector

Licensed under the MIT License

Change Log

0.0.14 (07/18/2021)

  • Delete broken releases
  • Modify and update CHANGELOG
  • Change URL for HomePage

0.0.15 (07/18/2021)

  • Update project description and README.md

0.0.16 (07/19/2021)

  • Add module usage in description
  • Fix broken hyperlinks in README.md
  • Setup github actions for pypi publish

Project details


Download files

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

Source Distribution

gmail-connector-0.0.17.tar.gz (8.1 kB view hashes)

Uploaded Source

Built Distribution

gmail_connector-0.0.17-py2.py3-none-any.whl (8.9 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page