Git Product home page Git Product logo

mailprobe's Introduction

Mailprobe

Email testing library as fake inbox, useful for E2E and unittests


Mailprobe runs a fake SMTP server to listen to the emails sent. It also runs a tiny webserver to display emails received. For automation tests and unittests where the test cases need to check if certain email is received, or to fetch email sent to a specific person can be checked via APIs.

Installation

Mailprobe is an npm package, you can use npm to install.

$ npm install -g mailprobe

Running

Mailprobe runs SMTP server at standard port 25. And runs the http server for serving webpages at 3000. This can be changed while running the mailprobe.

$ PORT=8000 mailprobe

Now launchhttp://localhost:8000/inbox to see inbox.

Requirements for Development

For development, you will only need Node.js and a node global package, Yarn, installed in your environement.

Node

  • Node installation on Windows

    Just go on official Node.js website and download the installer. Also, be sure to have git available in your PATH, npm might need it (You can find git here).

  • Node installation on Ubuntu

    You can install nodejs and npm easily with apt install, just run the following commands.

    $ sudo apt install nodejs
    $ sudo apt install npm
    
  • Other Operating Systems

    You can find more information about the installation on the official Node.js website and the official NPM website.

If the installation was successful, you should be able to run the following command.

$ node --version
v10.16.3

$ npm --version
6.9.0

If you need to update npm, you can make it using npm! Cool right? After running the following command, just open again the command line and be happy.

$ npm install npm -g

Yarn installation

After installing node, this project will need yarn too, so just run the following command.

  $ npm install -g yarn

Install

$ git clone https://github.com/vkolgi/mailprobe
$ cd mailprobe
$ yarn install

Running the project

$ npm start

mailprobe's People

Contributors

vkolgi avatar dependabot[bot] avatar vkolagi avatar sravichettu avatar

Stargazers

Sanjay Krishnan R S avatar

Watchers

James Cloos avatar  avatar

mailprobe's Issues

Request for a feature (segregation of emails)

It's not an issue, rather a feature. Current setup does not differentiate from which environment the mail comes. If we can have some concept like 'Realms' or 'Environments' such that One Mailprobe instance can be shared with different mail sending services then it would be helpful. Right now, we have to install Mailprobe for each dev and different testing environments seperately.

Or if we can have a unique label mechanism also to differentiat the source instance, then it would be helpful

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.