Sender Rewriting Scheme (SRS) library for Python
srslib is a modern Python implementation of the Sender Rewriting Scheme (SRS).
- Compatible with Python 2.7 and 3.x;
- Implements the standard “Guarded” SRS scheme as described in the original SRS paper;
- Simple to use and understand.
pip install srslib
import srslib srs = srslib.SRS('my_secret_key') # Rewrites an email from alice@A.com to B.com rewritten_addr = srs.forward('alice@A.com', 'B.com') # => 'SRS0=ZPM1=67=A.com=alice@B.com' # Reverse it to get the address to bounce to. try: bounce_addr = srs.reverse(rewritten_addr) # => 'alice@A.com' except srslib.Error as e: ... # Handle errors
The full documentation for srslib lives at https://srslib.readthedocs.io/.
This library is a clean re-implementation of SRS in modern Python based on the original SRS paper, and taking inspiration from the canonical libsrs2 C implementation and the older pysrs library (which itself is based on the Mail::SRS Perl package).
Compared to these two libraries, srslib
- … is a clean, modern, pure-Python implementation and supports Python 3.x;
- … discards baggage from Mail::SRS around legacy schemes and settings.
Licensed under the Apache License, Version 2.0.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.