Metadata-Version: 2.1
Name: transparentemail
Version: 0.1.1
Summary: Transparent Email clears aliases from email address
Home-page: https://github.com/akash-codes93/TransparentEmail
Keywords: transparentemail,email alias,email
Author: Akash Gupta
Requires-Python: >=3.6.2,<4.0.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Project-URL: Repository, https://github.com/akash-codes93/TransparentEmail
Description-Content-Type: text/markdown

# Transparent Email

Transparent Email clears aliases from email address. Email `John.Doe+alias@gmail.com` will be transformed to `johndoe@gmail.com`.

**Inspired by** : [bkrukowski/transparent-email](https://github.com/bkrukowski/transparent-email) 

## Why?

To detect multi-accounts on your website.

## Supported mailboxes

* [gmail.com](https://gmail.com)
* [33mail.com](https://www.33mail.com)
* [outlook.com](http://outlook.com)
* [yahoo.com](http://mail.yahoo.com)

## Installation

```
pip install transparentemail
```

## Usage

```python
from transparentemail.src import get_primary_email
from transparentemail.services.Emails.emailException import InvalidEmailException

try:
    
    transformed_email = get_primary_email('John.Doe+alias@gmail.com')
    print(transformed_email)  # John.Doe@gmail.com

except InvalidEmailException:
    print('Invalid Email')
```


## Yahoo.com

Aliases work different on Yahoo than on Gmail. On Gmail part after plus is skipped.
For example message sent to `janedoe+alias@gmail.com` will be redirected to `janedoe@gmail.com`.

Yahoo uses the following pattern[*](https://help.yahoo.com/kb/SLN16026.html):

*baseName*-*keyword*@yahoo.com

* *baseName* - value defined by the user, different than email login;
* *keyword* - one from a list of keywords defined by the user.

Therefore we do not know what is the real email, so in this case result will be `baseName@yahoo.com`,
which actually does not exist.
