diff -r 659c4476c57c -r b678a1c43027 doc/api/source/vmm_emailaddress.rst --- a/doc/api/source/vmm_emailaddress.rst Mon Mar 24 19:22:04 2014 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,61 +0,0 @@ -:mod:`VirtualMailManager.EmailAddress` --- Handling of e-mail addresses -======================================================================= - -.. module:: VirtualMailManager.EmailAddress - :synopsis: Handling of e-mail addresses - -.. moduleauthor:: Pascal Volk - -.. toctree:: - :maxdepth: 2 - - -This module provides the :class:`EmailAddress` class to handle validated e-mail -addresses. - - -EmailAddress ------------- - -.. class:: EmailAddress(address) - - Creates a new EmailAddress instance. - - :param address: string representation of an e-mail addresses - :type address: :obj:`basestring` - :raise VirtualMailManager.errors.EmailAddressError: if the - *address* is syntactically wrong. - :raise VirtualMailManager.errors.VMMError: if the validation of the - local-part or domain name fails. - - An EmailAddress instance has the both read-only attributes: - - .. attribute:: localpart - - The local-part of the address *local-part@domain* - - - .. attribute:: domainname - - The domain part of the address *local-part@domain* - - -Examples --------- - - >>> from VirtualMailManager.EmailAddress import EmailAddress - >>> john = EmailAddress('john.doe@example.com') - >>> john.localpart - 'john.doe' - >>> john.domainname - 'example.com' - >>> jane = EmailAddress('jane.doe@example.com') - >>> jane != john - True - >>> EmailAddress('info@xn--pypal-4ve.tld') == EmailAddress(u'info@pŠ°ypal.tld') - True - >>> jane - EmailAddress('jane.doe@example.com') - >>> print john - john.doe@example.com - >>>