salmon-mail 3.3.0

Salmon - A Python Mail Server

• Download: https://pypi.org/project/salmon-mail/

• Source: https://github.com/moggers87/salmon

• Docs: https://salmon-mail.readthedocs.io/en/latest/

Salmon is a pure Python mail server designed to create robust and complex mail applications in the style of modern web frameworks. Salmon is designed to sit behind a traditional mail server in the same way a web application sits behind Apache or Nginx. It has all the features of a web application stack (templates, routing, handlers, state machine) and plays well with other libraries, such as Django and SQLAlchemy.

Salmon has been released under the GNU GPLv3, as published by the FSF.

Features

Salmon supports running in many contexts for processing mail using the best technology currently available. Since Salmon is aiming to be a modern mail server and Mail processing framework, it has some features you don’t find in any other Mail server.

• Written in portable Python that should run on almost any Unix server.

• Handles mail in almost any encoding and format, including attachments, and canonicalizes them for easier processing.

• Sends nearly pristine clean mail that is easier to process by other receiving servers.

• Properly decodes internationalized mail into Python unicode, and translates Python unicode back into nice clean ascii and/or UTF-8 mail.

• Supports working with Maildir queues to defer work and distribute it to multiple machines.

• Can run as an non-root user on privileged ports to reduce the risk of intrusion.

• Salmon can also run in a completely separate virtualenv for easy deployment.

• A flexible and easy to use routing system lets you write stateful or stateless handlers of your email.

• Ability to use Jinja2 or Mako templates to craft emails including the headers.

• Easily configurable to use alternative sending and receiving systems, database libraries, or any other systems you need to talk to.

• Yet, you don’t have to configure everything to get stated. A simple salmon gen command lets you get an application up and running quick.

• Finally, many helpful commands for general mail server debugging and cleaning.

Installing

pip install salmon-mail

Project Information

Project documentation can be found here

4. Contributors agree that any contributions are owned by the copyright holder
and that contributors have absolutely no rights to their contributions.

5. The copyright holder reserves the right to revoke this license on anyone who
uses this copyrighted work at any time for any reason.

Testing

The Salmon project needs unit tests, code reviews, coverage information, source analysis, and security reviews to maintain quality. If you find a bug, please take the time to write a test case that fails or provide a piece of mail that causes the failure.

If you contribute new code then your code should have as much coverage as possible, with a minimal amount of mocking.

Tests can be run via:

$ python setup.py test

Alternatively, if you have multiple versions of Python installed locally:

$ pip install tox
$ tox -e py36,py37

Refer to the tox documentation for more information.

Development

Salmon is written entirely in Python and runs on Python 3. It should hopefully run on any platform that supports Python and has Unix semantics.

If you find yourself lost in source code, just yell.

PEP-8 should be followed where possible, but feel free to ignore the 80 character limit it imposes (120 is a good marker IMO).

Funding

If you have found Salmon to be useful and would like to see its continued development, please consider buying me a coffee.