maildropy

A Python package to read emails from maildrop.cc


Keywords
disposable, mail, maildrop, python, throwable
License
MIT
Install
pip install maildropy==1.0.0

Documentation

A Python package to read emails from maildrop.cc

THIS IS STILL WIP

This package provides a very simple class MailDropReader that mimics the graphql API of maildrop.cc. You create a new reader with `MailDropReader() The methods are:

  • status(): provides the current maildrop.cc status. Returns 'operational' or an error string from the server
  • ping(string): pings the maildrop.cc server with the given string. Returns 'pong '
  • inbox(): returns all messages of your inbox Returns a list of messages with only basic fields filled. (currently returns ALL messages, the filters aren't working).
  • message(message_id): returns a full message including its body, its sender IP, ...
  • delete(message_id)__: deletes a message by its id. Returns True if ok
  • statistics(): returns maildrop.cc statistics. Returns a tuple (blocked, saved)
  • altinbox(): returns an alias for your inbox. Subsequent MailDropReaders created with this alias will return messages from the original inbox

Example:

from maildropy import MailDropReader
reader = MailDropReader("my_own-inbox")

msgs = reader.inbox()
for msg in msgs:
  print(f"subject: {msg.subject}, from: {msg.mailfrom}, date:{msg.date}")
  message = reader.message(msg.id)
  print(f"content: {message.html}, ip={message.ip}, headerfrom={message.headerfrom}"

Testing

To test the module, clone the repo, then copy .env.example in .env and provide the email sending settings. These settings are used to send emails to maildrop.cc Then run python test_maildrop.py