devise

https://github.com/plataformatec/devise

Ruby

Flexible authentication solution for Rails with Warden.

Mail::Address#format

Returns a correctly formatted address for the email going out.  If given
an incorrectly formatted address as input, Mail::Address will do its best
to format it correctly.  This includes quoting display names as needed and
putting the address in angle brackets etc.

 a = Address.new('Mikel Lindsaar (My email address) <[email protected]>')
 a.format #=> 'Mikel Lindsaar <[email protected]> (My email address)'

Source | Google | Stack overflow

Edit

git clone [email protected]:plataformatec/devise.git
cd devise
open

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Mail--Address-format-for-pr

# Commit to git

git add git commit -m "better docs for Mail::Address#format"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Mail--Address-format-for-pr

hub pull-request

# Celebrate!