Welcome to AFFO Email Service’s documentation!¶
AFFO Email Service is a simple and flexible email sending service designed to help application developers to separate email marketing from a development process itself.
AFFO Email Service is Open Source and licensed under the BSD License.
Getting Started¶
If you’re new to AFFO Email Service you can get started by following the first-steps tutorial.
Contents¶
Copyright¶
Copyright © 2019, Affo Ltd.
All rights reserved. This material may be copied or distributed only subject to the terms and conditions set forth in the Creative Commons Attribution-ShareAlike 4.0 International <https://creativecommons.org/licenses/by-sa/4.0/legalcode>`_ license.
You may share and adapt the material, even for commercial purposes, but you must give the original author credit. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same license or a license compatible to this one.
Note
While the AFFO Email Service documentation is offered under the Creative Commons Attribution-ShareAlike 4.0 International license the AFFO Email Service software is offered under the BSD License (3 Clause)
Getting Started¶
Contributor’s Guide¶
Contributions are always welcome and greatly appreciated!
Code contributions¶
We love pull requests from everyone! Here’s a quick guide to improve the code:
Fork the repository and clone the fork.
Create a virtual environment using your tool of choice (e.g.
virtualenv,conda, etc).Install development dependencies:
pip install -r requirements.txt
pip install -r requirements-test.txt
Make sure all tests pass:
python setup.py test
Start making your changes to the master branch (or branch off of it).
Make sure all tests still pass:
python setup.py test
Add yourself to
AUTHORS.rst.Commit your changes and push your branch to GitHub.
Create a pull request through the GitHub website.
Documentation improvements¶
We could always use more documentation, whether as part of the introduction/examples/usage documentation or API documentation in docstrings.
Documentation is written in reStructuredText and use Sphinx to generate the HTML output.
Once you made the documentation changes locally, run the documentation generation:
python setup.py build_sphinx
Bug reports¶
When reporting a bug please include:
Operating system name and version.
affo-email-service version.
Any details about your local setup that might be helpful in troubleshooting.
Detailed steps to reproduce the bug.
REST API¶
-
POST/message/¶ Sends a message by assembling it from the components.
- Status Codes
201 Created – Success
-
POST/template/{template_name}/send/¶ Sends a message built from the specified template.
- Parameters
template_name (string) – A template name
- Status Codes
201 Created – Success