Skip to main content

A convenient email sender for monitoring your task

Project description


This is a Python decorator that can send email for various purpose.

By the way, I am also planning to expand the receiving channels from email to Message, Telegram, Wechat, or even more.

If you are interested, let's work together!


Often we have some time-consuming script, and we want to leave it running for a while without having to check every few minutes if it has been completed.

This package will offer you a one-line experience (a function decorator) of sending you email report with customized information.

This is definitely an easy function, I believe many guys have written their own equivalent one. What I did is to simplify it into a decorator, so it is now even more convenient!


pip install py_reminder==1.0.1

Initial configuration

We strongly recommend to use an unimportant mailbox to send messages, since the password is going to be stored in plain text. We're looking for ways to work around this - you're welcome to help!

For the first time, you should specify configuration:

from py_reminder import config

       port=999,  # currently it should be non-SSL port

You can ignore default_to. It will set to be the same as address by default.

If you receive a testing email, then the configuration is done.

Sample code

from py_reminder import monitor

@monitor('This is a task')
def foo():
	return 0

If you want to specify the receiver:

@monitor(task='This is a task', to='')

Another way to use it without decorator:

from py_reminder import send_email
send_email(task="This is a task")

And you will see:

For error, you will see:

Email Service Provider

  • GMail
    • I used a new registered account and was banned after one day.
    • Haven't tested personal account yet.
  • Foxmail
    • I use my personal account and it is all good up to now (two months).
  • 163
    • It works. Port should be 25.

Tests on other email vendors are welcome!

I have some worked config files. You can simply copy paste it to the ~/.config then skip the configuration process. If you would like to use the config files, just send email to me.

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

py_reminder-1.0.2.tar.gz (5.1 kB view hashes)

Uploaded source

Built Distribution

py_reminder-1.0.2-py3-none-any.whl (5.8 kB view hashes)

Uploaded py3

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