email-validate-2.3.2.15: Email address validation
Safe HaskellSafe-Inferred
LanguageHaskell2010

Text.Email.Validate

Synopsis

Documentation

isValid :: ByteString -> Bool Source #

Validates whether a particular string is an email address according to RFC5322.

validate :: ByteString -> Either String EmailAddress Source #

If you want to find out *why* a particular string is not an email address, use this.

Examples:

>>> validate "example@example.com"
Right "example@example.com"
>>> validate "not.good"
Left "at sign > @: not enough input"

emailAddress :: ByteString -> Maybe EmailAddress Source #

Smart constructor for an email address

canonicalizeEmail :: ByteString -> Maybe ByteString Source #

Checks that an email is valid and returns a version of it where comments and whitespace have been removed.

Example:

>>> canonicalizeEmail "spaces. are. allowed@example.com"
Just "spaces.are.allowed@example.com"

data EmailAddress Source #

Represents an email address.

Instances

Instances details
Eq EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Data EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> EmailAddress -> c EmailAddress #

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c EmailAddress #

toConstr :: EmailAddress -> Constr #

dataTypeOf :: EmailAddress -> DataType #

dataCast1 :: Typeable t => (forall d. Data d => c (t d)) -> Maybe (c EmailAddress) #

dataCast2 :: Typeable t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c EmailAddress) #

gmapT :: (forall b. Data b => b -> b) -> EmailAddress -> EmailAddress #

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> EmailAddress -> r #

gmapQr :: forall r r'. (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> EmailAddress -> r #

gmapQ :: (forall d. Data d => d -> u) -> EmailAddress -> [u] #

gmapQi :: Int -> (forall d. Data d => d -> u) -> EmailAddress -> u #

gmapM :: Monad m => (forall d. Data d => d -> m d) -> EmailAddress -> m EmailAddress #

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> EmailAddress -> m EmailAddress #

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> EmailAddress -> m EmailAddress #

Ord EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Read EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Show EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Generic EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

Associated Types

type Rep EmailAddress :: Type -> Type #

type Rep EmailAddress Source # 
Instance details

Defined in Text.Email.Parser

type Rep EmailAddress = D1 ('MetaData "EmailAddress" "Text.Email.Parser" "email-validate-2.3.2.15-LnVw7WVjAIF8fofpKFivpa" 'False) (C1 ('MetaCons "EmailAddress" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByteString) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByteString)))

domainPart :: EmailAddress -> ByteString Source #

Extracts the domain part of an email address.

localPart :: EmailAddress -> ByteString Source #

Extracts the local part of an email address.

toByteString :: EmailAddress -> ByteString Source #

Converts an email address back to a ByteString

unsafeEmailAddress :: ByteString -> ByteString -> EmailAddress Source #

Creates an email address without validating it. You should only use this when reading data from somewhere it has already been validated (e.g. a database).