emailaddress

Scala micro-library for typing, validating and obfuscating email addresses

Address Typing & Validation

The EmailAddress class will only accept valid addresses:

scala> import io.kinoplan.emailaddress._
 import io.kinoplan.emailaddress._

scala> EmailAddress("[email protected]")
res0: EmailAddress = example@test.com

scala> EmailAddress("not_a_meaningful_address")
java.lang.IllegalArgumentException: requirement failed: 'not_a_meaningful_address' is not a valid email address

You can also use EmailAddress.isValid(...):

scala> EmailAddress.isValid("[email protected]")
res2: Boolean = true

scala> EmailAddress.isValid("not_a_meaningful_address")
res3: Boolean = false

Accessing the domain and mailbox

You can access the mailbox and domain of a given address:

scala> EmailAddress("[email protected]").domain
res0: io.kinoplan.emailaddress.EmailAddress.Domain = test.com

scala> EmailAddress("[email protected]").mailbox
res1: io.kinoplan.emailaddress.EmailAddress.Mailbox = example

These compare equal as you might expect:

scala> EmailAddress("[email protected]").domain == EmailAddress("[email protected]").domain
res2: Boolean = true

scala> EmailAddress("[email protected]").domain == EmailAddress("[email protected]").domain
res3: Boolean = false

Obfuscation

Addresses are obfuscated by starring out all of their mailbox part, apart from the first and last letters:

scala> ObfuscatedEmailAddress("[email protected]")
res4: io.kinoplan.emailaddress.ObfuscatedEmailAddress = e*****e@test.com

Unless there are only two letters:

scala> ObfuscatedEmailAddress("[email protected]")
res7: io.kinoplan.emailaddress.ObfuscatedEmailAddress = **@test.com```

You can also create them directly from an EmailAddress:

scala> EmailAddress("[email protected]").obfuscated
res6: io.kinoplan.emailaddress.ObfuscatedEmailAddress = e*****e@test.com

Converting back to String

All classes toString and implicitly convert to Strings nicely:

scala> val someString: String = EmailAddress("[email protected]")
someString: String = example@test.com

scala> val someString = EmailAddress("[email protected]").toString
someString: String = example@test.com

scala> val someString: String = ObfuscatedEmailAddress("[email protected]")
someString: String = e*****e@test.com

scala> val someString = ObfuscatedEmailAddress("[email protected]").toString
someString: String = e*****e@test.com

scala> EmailAddress("[email protected]").domain.toString
res4: String = test.com

scala> val s: String = EmailAddress("[email protected]").domain
s: String = test.com

scala> EmailAddress("[email protected]").mailbox.toString
res5: String = example

scala> val s: String = EmailAddress("[email protected]").mailbox
s: String = example

Installing

Include the following dependency in your SBT build

Core

libraryDependencies += "io.kinoplan" %% "emailaddress-core" % "<current_version>"

Play Json 2.8.*

libraryDependencies ++= Seq(
   "io.kinoplan" %% "emailaddress-core" % "<current_version>",
   "io.kinoplan" %% "emailaddress-play-json" % "<current_version>"
)

In your code, use following import

import io.kinoplan.emailaddress.EmailAddressFormat._

Circe 0.13.*

libraryDependencies ++= Seq(
   "io.kinoplan" %% "emailaddress-core" % "<current_version>",
   "io.kinoplan" %% "emailaddress-circe" % "<current_version>"
)

In your code, use following import

import io.kinoplan.emailaddress.EmailAddressCodec._

Reactivemongo 0.18.*

libraryDependencies ++= Seq(
   "io.kinoplan" %% "emailaddress-core" % "<current_version>",
   "io.kinoplan" %% "emailaddress-reactivemongo" % "<current_version>"
)

In your code, use following import

import io.kinoplan.emailaddress.EmailAddressHandler._

License

This code is open source software licensed under the Apache 2.0 License.