michael orlitzky

email-validator

get it

Release

email-validator-1.1.0.tar.gz

Browse source

gitweb

Clone it

git clone https://gitweb.michael.orlitzky.com/email-validator.git

What is it?

It validates email addresses, i.e. takes a list and removes the bad ones. Or at least it tries to, without sending any mail.

We validate the email addresses using three techniques:

• Ensuring that the length of local and domain parts is within the RFC-specified limits.
• A syntax check using a regular expression, or the full RFC 5322 grammar (see the --rfc5322 option).
• Confirmation of the existence of an MX record for the domain part of the address. NULLMX (RFC7505) records are not accepted. This is not required; in fact many domains accept mail via an A record for (say) example.com which is used in lieu of an MX record. This behavior can be controlled via the --accept-a flag, but note that --accept-a is ignored for domains that have NULLMX records.

These checks are performed in parallel using the number of available threads. To increase the number of threads, you can pass the appropriate flag to the GHC runtime.

This will set the number of threads to 25:

user $ email-validator -i addresses.csv +RTS -N25

Input

The input file (default: stdin) should be a list of email addresses, one per line. Empty lines will be ignored.

Output

Valid email addresses will be written to the output file (default: stdout), one per line.

Usage

user $ email-validator [-har] [-i FILE] [-o FILE] <input>

Options

--accept-a, -a

Accept an A record for the domain instead of requiring an MX record (the default).

--input, -i

Specify the input file containing a list of email addresses, rather than using stdin (the default).

--output, -o

Specify the output file to which the good addresses will be written, rather than using stdout (the default).

--rfc5322, -r

Verify addresses against RFC 5322 rather than a naive regular expression. This is much more lenient than the default.

Requirements

All of the software dependencies are listed in the email-validator.cabal file. Just use cabal to build it.

Installation

Cabal handles the build, so do whatever you normally do to install cabal packages. If you just want to install it for your user,

user $ runghc Setup.hs configure --user

user $ runghc Setup.hs build

user $ runghc Setup.hs install

should do it.

How to report bugs

Email them to me at michael@orlitzky.com.