Metadata-Version: 2.1
Name: nullsmtpd
Version: 0.5.1
Summary: Fake SMTP server
Home-page: http://github.com/MasterOdin/nullsmtpd
Author: Matthew Peveler
Author-email: matt.peveler@gmail.com
License: UNKNOWN
Description: nullsmtpd
        =========
        
        .. image:: https://travis-ci.org/MasterOdin/nullsmtpd.svg?branch=master
            :target: https://travis-ci.org/MasterOdin/nullsmtpd
            :alt: Build Status
        
        nullsmtpd is a fake SMTP server (written in python) which can be used for development. The server catches incoming mail,
        writes them to a file, and doesn't actually send it out to the intended recipients. All emails are saved to a directory
        (defaults to ``/var/log/nullsmtpd``, but can be changed via flag) where each email address sent to gets its own folder
        and then emails are stored in that folder named ``{sender}.{time}.msg``. This is useful for debugging applications
        where you don't want a GUI (as you're running a headless VM say), but still actually need to see the messages that
        were sent in the system, without having to worry about things getting bounced or whatever.
        
        Generally, you'd probably want to install this instead of something like sendmail or some other package that would
        handle sending mail from your server.
        
        Requirements
        ============
        nullsmtpd relies on Python 3.5+ and `aiosmtpd <https://github.com/aio-libs/aiosmtpd>`_. Recommended to also have ``pip`` for installation.
        
        Installation
        ============
        Recommended Installation is through PyPi::
        
            pip install nullsmtpd
        
        Or if you've cloned the repository::
        
            python3 setup.py install
        
        
        Usage
        =====
        ::
        
            usage: nullsmtpd [-h] [--no-fork] [-H HOST] [-P PORT] [--mail-dir MAIL_DIR]
                            [-v]
        
            optional arguments:
              -h, --help            show this help message and exit
              --no-fork             Don't fork and run nullsmtpd as a daemon. Additionally,
                                    this willprint all log messages to stdout/stderr and
                                    all emails to stdout.
              -H HOST, --host HOST  Host to listen on
              -P PORT, --port PORT  Port to listen on
              --mail-dir MAIL_DIR   Location to write logs and emails (defaults to
                                    ~/.nullsmtpd)
              -v, --version         show program's version number and exit
        
        By default, you will need to use sudo as the server wants to bind itself to localhost and port 22.
        However, if you use a different port, then it will not require using sudo. However, note, that if the current running
        user of the script does not have access to create a directory/file within ``/var/log`` or ``/var/log/nullsmtpd``, then
        no emails will be written to file, but just through the console.
        
        If the mail directory is writeable to, then you should have the following directory structure::
        
            nullsmtpd.log
            person1@example.com/
                1492024232.person2@example.com.msg
                1492024462.person2@example.com.msg
                1493678462.person1@example.com.msg
            person2@example.com/
                person1@example.com.1232421423.msg
        
        where ``nullsmtpd.log`` a log file for the system, and then each folder represents a person's "inbox" and inside
        are messages from someone at a given timestamp (seconds from epoch).
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: Public Domain
Classifier: Topic :: Communications :: Email :: Mail Transport Agents
Requires-Python: >=3.5.x
