email_address 1.0.0

Provides a e-mail address value type.

This package provides the value type EmailAddress to have a typed representation of the e-mail address with the encapsulated validation.

Getting started

1. Install the package as a dependency, running the command in the shell:

   dart pub add email_address
   

2. Import the library:

   import 'package:email_address/email_address.dart';
   

Usage

Parsing a EmailAddress from string:

try {
  final address = EmailAddress.parse('[e-mail]');
} on EmailAddressFormatException {
  // ...
}

Alternatively, you can use .parseOrNull():

assert(EmailAddress.parseOrNull('[e-mail]') != null);
assert(EmailAddress.parseOrNull('not a e-mail address') == null);

When you need to, just check the format of the string without creating an instance of the EmailAddress:

assert(EmailAddress.validFormat('[e-mail]') == true);
assert(EmailAddress.validFormat('not a e-mail address') == false);

Make case-insensitive check for equality of the addresses:

final address = EmailAddress.parse('[e-mail]');
final sameAddressInUpperCase = EmailAddress.parse('[e-mail]');

assert(address == sameAddressInUpperCase);

Convert the EmailAddress back to string using .toString() method as expected:

final address = EmailAddress.parse('[e-mail]');
assert('[e-mail]' == address.toString());