From 86becbf478e33ccecf6823f9b0358f4320fb8c0b Mon Sep 17 00:00:00 2001 From: Abdur-Rahmaan Janhangeer Date: Wed, 24 Feb 2021 13:11:47 +0400 Subject: [PATCH 1/4] Add pypi badge to readme! --- README.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.rst b/README.rst index fcb113f..6470f63 100644 --- a/README.rst +++ b/README.rst @@ -1,6 +1,9 @@ MailDump ======== +.. image:: https://badge.fury.io/py/maildump.svg + :target: https://badge.fury.io/py/maildump + MailDump is a python-based clone of the awesome `MailCatcher`_ tool. Its purpose is to provide developers a way to let applications send emails without actual emails being sent to anyone. Additionally lazy developers From 7a826aae710ecc1c3602ba9a8e1d08893cda7b93 Mon Sep 17 00:00:00 2001 From: Abdur-RahmaanJ Date: Wed, 24 Feb 2021 14:32:19 +0400 Subject: [PATCH 2/4] fix: badge and logo --- README.rst => README.md | 36 ++++++++++++++++-------------------- 1 file changed, 16 insertions(+), 20 deletions(-) rename README.rst => README.md (63%) diff --git a/README.rst b/README.md similarity index 63% rename from README.rst rename to README.md index fcb113f..3ee34f3 100644 --- a/README.rst +++ b/README.md @@ -1,14 +1,18 @@ -MailDump -======== +# Maildump [![Available on PyPI](https://img.shields.io/pypi/v/maildump.svg)](https://pypi.python.org/pypi/maildump/) -MailDump is a python-based clone of the awesome `MailCatcher`_ tool. Its + + + +MailDump is a python-based clone of the awesome [MailCatcher](https://github.com/sj26/mailcatcher/blob/master/README.md) tool. Its purpose is to provide developers a way to let applications send emails without actual emails being sent to anyone. Additionally lazy developers might prefer this over a real SMTP server simply for the sake of it being much easier and faster to set up. -Features --------- +## Features Since the goal of this project is to have the same features as MailCatcher I suggest you to read its readme instead. @@ -17,19 +21,17 @@ However, there is one unique feature in MailDump: Password protection for the web interface. If your MailDump instance is listening on a public IP you might not want your whole company to have access to it. Instead you can use an Apache-style htpasswd file. I have tested it with SHA-encrypted -passwords but you can use any encryption supported by `passlib.apache`_. +passwords but you can use any encryption supported by [passlib.apache](http://pythonhosted.org/passlib/lib/passlib.apache.html). -Usage ------ +## Usage -After installing maildump, run ``maildump --help`` for a list of available +After installing maildump, run `maildump --help` for a list of available command line arguments. By default maildump runs its webserver on port 1080 and its SMTP server on port 1025 (both only available via localhost). Unless you specify a database file, received mails are lost when maildump terminates. -Credits -------- +## Credits The layout of the web interface has been taken from MailCatcher. No Copy&Paste involved - I rewrote the SASS/Compass stylesheet from @@ -39,15 +41,9 @@ looks as good or even better feel free to send a pull request. I'd actually prefer a layout that differs from MailCatcher at least a little bit but I'm somewhat bad at creating layouts! -The icon was created by `Tobia Crivellari`_. +The icon was created by [Tobia Crivellari](http://dribbble.com/TobiaCrivellari) -License -------- +## License Copyright © 2013-2020 Adrian Mönnich (adrian@planetcoding.net). Released -under the MIT License, see `LICENSE`_ for details. - -.. _MailCatcher: https://github.com/sj26/mailcatcher/blob/master/README.md -.. _passlib.apache: http://pythonhosted.org/passlib/lib/passlib.apache.html -.. _Tobia Crivellari: http://dribbble.com/TobiaCrivellari -.. _LICENSE: https://github.com/ThiefMaster/maildump/blob/master/LICENSE +under the MIT License, see [LICENSE](https://github.com/ThiefMaster/maildump/blob/master/LICENSE) for details. From f62a367af045bb31b79283212938f2cc6abf7660 Mon Sep 17 00:00:00 2001 From: Abdur-RahmaanJ Date: Wed, 24 Feb 2021 14:40:02 +0400 Subject: [PATCH 3/4] fix: rm align right --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index c8fa193..0f8b56f 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,6 @@ From e29983a3eeca0bdf4a7ba4c638406221f6500a88 Mon Sep 17 00:00:00 2001 From: Abdur-RahmaanJ Date: Wed, 24 Feb 2021 14:56:44 +0400 Subject: [PATCH 4/4] fix: add setup.cfg to point to .md filte --- setup.cfg | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/setup.cfg b/setup.cfg index 1c40a7d..0888800 100644 --- a/setup.cfg +++ b/setup.cfg @@ -3,7 +3,8 @@ name = maildump version = 1.0 license = MIT description = An SMTP server that makes all received mails accessible via a web interface and REST API. -long_description = file: README.rst +long_description = file: README.md +long_description_content_type = text/markdown; charset=UTF-8; variant=GFM url = https://github.com/ThiefMaster/maildump download_url = https://github.com/ThiefMaster/maildump author = Adrian Mönnich