python-guerrillamail 0.2.0

Client for the Guerrillamail temporary email server

Python Guerrillamail is a Python client API and command line interface for interacting with a Guerrillamail temporary email server.

Installation

pip install python-guerrillamail

Example Usage

Create session using auto-assigned email address, print email address and print id of first message in inbox:

from guerrillamail import GuerrillaMailSession
session = GuerrillaMailSession()
print session.get_session_state()['email_address']
print session.get_email_list()[0].guid

Example CLI Usage

Set email address:

$ guerrillamail setaddr john.doe
$ guerrillamail info
Email: [e-mail]

List inbox contents:

$ guerrillamail list
(*) 48859781  23:45:27+00:00  [e-mail]
Example messsage 2

(*) 48859574  09:25:01+00:00  [e-mail]
Example message

( ) 1         00:00:00+00:00  [e-mail]
Welcome to Guerrilla Mail

Read email message:

$ guerrillamail get 48859781
From: [e-mail]
Date: 2016-06-11 23:45:27+00:00
Subject: Example message 2

Example Guerrillamail message body.

Using Alternative Guerrillamail Server

By default, http://api.guerrillamail.com is used as the base URL for Guerrillamail API calls. This can be overridden by providing the base_url property when constructing a GuerrillaMailSession instance. When using the CLI the base_url property can be defined in the ~/.guerrillamail JSON config file, for example:

{
    "base_url": "https://api.guerrillamail.com"
}

License

Python Guerrilla Mail is free software, licensed under the GPLv3.

Change History

0.2.0

• Add support for Python 3.3, 3.4 and 3.5.

• Add “guerrillamail” executable.

0.1.2

• Fix mail “excerpt” property.

0.1.1

• Remove version restriction on Requests dependency.

0.1.0

• Initial release.