# -*- coding: UTF-8 -*-

# Copyright (c) 2008 - 2011, Pascal Volk

# See COPYING for distribution information.

"""

    VirtualMailManager.emailaddress

    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

    Virtual Mail Manager's EmailAddress class to handle e-mail addresses.

"""

import re

from VirtualMailManager.domain import check_domainname, get_gid

from VirtualMailManager.constants import \

     DOMAIN_NO_NAME, INVALID_ADDRESS, LOCALPART_INVALID, LOCALPART_TOO_LONG, \

     DOMAIN_INVALID

from VirtualMailManager.errors import DomainError, EmailAddressError as EAErr

RE_LOCALPART = re.compile(r"[^\w!#$%&'\*\+-\.\/=?^_`{\|}~]")

_ = lambda msg: msg

class EmailAddress(object):

    """Simple class for validated e-mail addresses."""

    __slots__ = ('_localpart', '_domainname')

    def __init__(self, address, _validate=True):

        """Creates a new instance from the string/unicode ``address``."""

        assert isinstance(address, basestring)

        self._localpart = None

        self._domainname = None

        if _validate:

            self._chk_address(address)

    @property

    def localpart(self):

        """The local-part of the address *local-part@domain*"""

        return self._localpart

    @property

    def domainname(self):

        """The domain part of the address *local-part@domain*"""

        return self._domainname

    def __eq__(self, other):

        if isinstance(other, self.__class__):

            return self._localpart == other._localpart and \

                    self._domainname == other._domainname

        return NotImplemented

    def __ne__(self, other):

        if isinstance(other, self.__class__):

            return self._localpart != other._localpart or \

                    self._domainname != other._domainname

        return NotImplemented

    def __hash__(self):

        return hash((self._localpart.lower(), self._domainname.lower()))

    def __repr__(self):

        return "EmailAddress('%s@%s')" % (self._localpart, self._domainname)

    def __str__(self):

        return '%s@%s' % (self._localpart, self._domainname)

    def _chk_address(self, address):

        """Checks if the string ``address`` could be used for an e-mail

        address.  If so, it will assign the corresponding values to the

        attributes `_localpart` and `_domainname`."""

        parts = address.split('@')

        p_len = len(parts)

        if p_len < 2:

            raise EAErr(_(u"Missing the '@' sign in address: '%s'") % address,

                        INVALID_ADDRESS)

        elif p_len > 2:

            raise EAErr(_(u"Too many '@' signs in address: '%s'") % address,

                        INVALID_ADDRESS)

        if not parts[0]:

            raise EAErr(_(u"Missing local-part in address: '%s'") % address,

                        LOCALPART_INVALID)

        if not parts[1]:

            raise EAErr(_(u"Missing domain name in address: '%s'") % address,

                        DOMAIN_NO_NAME)

        self._localpart = check_localpart(parts[0])

        self._domainname = check_domainname(parts[1])

class DestinationEmailAddress(EmailAddress):

    """Provides additionally the domains group ID - when the domain is known

    in the database."""

    __slots__ = ('_gid', '_localhost')

    def __init__(self, address, dbh, _validate=False):

        """Creates a new DestinationEmailAddress instance

        Arguments:

        `address`: string/unicode

          a e-mail address like user@example.com

        `dbh`: pyPgSQL.PgSQL.Connection/pyPgSQL.PgSQL.connection

          a database connection for the database access

        """

        super(DestinationEmailAddress, self).__init__(address, _validate)

        self._localhost = False

        if not _validate:

            try:

                self._chk_address(address)

            except DomainError, err:

                if err.code is DOMAIN_INVALID and \

                   address.split('@')[1] == 'localhost':

                    self._localhost = True

                    self._domainname = 'localhost'

                else:

                    raise

        self._gid = 0

        if not self._localhost:

            self._find_domain(dbh)

        else:

            self._localpart = self._localpart.lower()

    def _find_domain(self, dbh):

        """Checks if the domain is known"""

        self._gid = get_gid(dbh, self._domainname)

        if self._gid:

            self._localpart = self._localpart.lower()

    @property

    def at_localhost(self):

        """True when the address is something@localhost."""

        return self._localhost

    @property

    def gid(self):

        """The domains group ID. 0 if the domain is not known."""

        return self._gid

def check_localpart(localpart):

    """Returns the validated local-part `localpart`.

    Throws a `EmailAddressError` if the local-part is too long or contains

    invalid characters.

    """

    if len(localpart) > 64:

        raise EAErr(_(u"The local-part '%s' is too long.") % localpart,

                    LOCALPART_TOO_LONG)

    invalid_chars = set(RE_LOCALPART.findall(localpart))

    if invalid_chars:

        i_chars = u''.join((u'"%s" ' % c for c in invalid_chars))

        raise EAErr(_(u"The local-part '%(l_part)s' contains invalid "

                      u"characters: %(i_chars)s") % {'l_part': localpart,

                    'i_chars': i_chars}, LOCALPART_INVALID)

    return localpart

del _