|Build Status| |Coverage| |docs|
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 uner the GNU GPLv3, as published by the FSF.
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.
salmon gencommand lets you get an application up and running quick.
pip install salmon-mail
Project documentation can be found
Salmon is a fork of Lamson. In the summer of 2012 (2012-07-13 to be exact), Lamson was relicensed under a BSD variant that was revokable. The two clauses that were of most concern::
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.
I read that to mean that I could make a contribution but then have said work denied to me because the original author didn't like the colour of my socks. So I went and found the latest version that was available under the GNU GPL version 3.
Salmon is an anagram of Lamson, if you hadn't worked it out already.
You can find the source on GitHub:
Salmon has just had some major changes to modernise the code-base. The main APIs should be compatible with releases prior to 3.0.0, but there's no guarantee that older applications won't need changes.
Python versions supported are: 3.6, 3.7, 3.8 and 3.9.
See the CHANGELOG for more details on what's changed since Salmon version 2.
Salmon is released under the GNU GPLv3 license, which can be found
Pull requests and issues are most welcome. Please read our
code of conduct <https://github.com/moggers87/salmon/blob/🐟/CODE_OF_CONDUCT.md>__ before
I will not accept code that has been submitted for inclusion in the original project due to the terms of its new licence.
The Salmon project has adopted the Contributor Covenant Code version 1.4. By contributing to this project, you agree to abide by its terms.
The full text of the code of conduct can be found
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 <https://tox.readthedocs.io/en/latest/>__ for
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).
If you have found Salmon to be useful and would like to see its continued
development, please consider
buying me a coffee <https://ko-fi.com/moggers87>__.
.. |Build Status| image:: https://github.com/moggers87/salmon/actions/workflows/tests.yml/badge.svg :alt: Build Status :scale: 100% :target: https://github.com/moggers87/salmon/actions/workflows/tests.yml .. |Coverage| image:: https://codecov.io/github/moggers87/salmon/coverage.svg?branch=🐟 :target: https://codecov.io/github/moggers87/salmon :alt: Coverage Status :scale: 100% .. |docs| image:: https://readthedocs.org/projects/salmon-mail/badge/?version=latest :alt: Documentation Status :scale: 100% :target: https://salmon-mail.readthedocs.io/en/latest/?badge=latest