Neptune (personal SMTP testing server)

Updated! There is a new version.

While working on a current project I found myself faced with testing code that sends email.  In the past I would end up with an inbox full of test messages or unhappy customers that wonder why they just received a flood of emails from my site.  I was also frustrated that there was no way to easily automate this testing.

Enter Neptune. Neptune is a SMTP Development Server targeted for use in automated testing. I simply asked the question, “what if I had a SMTP server that did not relay the message and allowed me to query for messages and their content”. I would be able to use a server of this type to act as my SMTP server during testing and write custom plug-ins, validation and extraction rules to communicate with the server.

The goals of Neptune were to facilitate automated testing and be easy to use. I did not want to have to install a service or understand everything there is to know about running a SMTP server. I simply want to start Neptune and run my test.

Full documentation on how to use Neptune is provided in the msi you can download here. NeptuneSetup.msi (1.27 mb) Original version

Neptune with POP3 NeptuneSetup.msi (1.40 mb) Newer version

If you find Neptune usefull feel free to Donate for future development.


Comments (12) -

  • This tool is awesome and has allowed me to test my code with all the email portions on.  In the past I'd have to comment this code out and then remember to uncomment when we went live.  Also allows me to narrow down the problem to my code, some setting or the email server quickly and easily as this was just taking shots in the dark in the past.  Thanks!
  • Awesome tool.  I just downloaded it and it does everything you said.  I was dreading setting up an smtp server and I really didn't want to stuff my mailbox full of test messages.

    Cool stuff.

  • thanks, D.  This will solve some my problems and allow me to clean up my code a little.
  • slick idea.  i'll definitely be playing with it tonight.
  • How do I get this to work in a Continuous Integration environment?
  • DKemp - I would say use Process.Start to fire the app up. Then send your emails.
    DBrown - GREAT idea, sir. I'll be using this stat. Mui Bueno!
  • Any chance of this showing up on codeplex (or the like) soon?
  • That's awesome tool...
    till now I had a debugging configuration that automatically changed the email of the recipient to the test one so that users are not flooded by testing emails.. but this is completely transparent: just change the SMTP and everything works.
  • If I put Neptune in the same machine with our test web server and have it point to, can I access Neptune from my desktop (this is a different machine from the web server) and run webtests?
  • Are you considering posting this to codeplex?  Are you planning on releasing an upgrade?  If the answer is no to any of the questions above, would there be any way to get the source code for this?  The reason I am asking is that I would like to add some features to this.  This is great for automated/unit testing, but it would also be nice to have some additional features so it could be used for general testing.

    1) Ability to persist the messages to disk.  That way you can send the message to other who might want to see them (project managers, BU, etc).  This would also include deleting persisted messages.

    2) Ability to view the email messages.  When I am writing new functionality I want to be able to open the emails I just created to see the content.

    3) Ability to configure the application to load on startup.

    4) UI to make editing the config files easier.

  • I just make a dummy email that way neither my customers or I are affected by the influx of a thousands emails. But Neptune sounds like a very good idea.
  • Very nice.
    I like the idea of unit testing via the admin port, clever.
    PK  Wink

Pingbacks and trackbacks (6)+

Comments are closed