Skip to main content

Mock SMTP server that logs incoming messages to stdout as JSON for easy parsing and testing by the hitch framework.

Project description


Mock SMTP server that logs all incoming messages to stdout as JSON for easy parsing by HitchServe.

HitchSMTP contains a service definition for use with Hitch, but can also be used alone.

Use with Hitch

Install like so:

$ hitch install hitchsmtp
# Service definition in your test execution engine's setUp['HitchSMTP'] = hitchsmtp.HitchSMTPService(
    port=10025                                                 # Optional (default: 10025)

# Wait for email during test...
containing = "Registration email"

email =['HitchSMTP'].logs.out.tail.until_json(
    lambda email: containing in email['payload'] or containing in email['Subject'],

See this service in action at the DjangoRemindMe project.

Bad SMTP Server

You can send to specific email addresses to mock most SMTP errors.

E.g. Sending an email to will cause the “451 Please try again later” SMTP error.

For a full list of these errors and the email address @ that will trigger them, see:


  • Logs all details about emails received by the SMTP server as easily parsed JSON.

  • Parses links in your emails automatically so that you can check just for links in emails and ‘click’ on them.

  • Can also mock SMTP errors.

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

hitchsmtp-0.2.1.tar.gz (5.5 kB view hashes)

Uploaded source

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