Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/armanyazdi/emailtools

A Python library for email suggestions and validations.
https://github.com/armanyazdi/emailtools

email pypi pypi-package pypi-packages python python-libraries python-library python3

Last synced: 3 months ago
JSON representation

A Python library for email suggestions and validations.

Awesome Lists containing this project

README

        

# emailtools

[![PyPI](https://img.shields.io/pypi/v/emailtools?style=for-the-badge)](https://pypi.org/project/emailtools)
[![GitHub](https://img.shields.io/github/license/armanyazdi/emailtools?style=for-the-badge)](https://pypi.org/project/emailtools)

A Python library for email suggestions and validations.

## Installation

Install from [PyPI](https://pypi.org/project/emailtools) with pip by typing in your favorite terminal:

This will install `persian-names` (for generating random names).

`pip install emailtools`

## Usage

Let's take a look at what an example test case would look like using `emailtools`.

### Generate Random Emails:

Note: You can use the name of email providers or their domains for the first argument.

```python
from emailtools import generate

# generate('EmailProvider', 'FirstName', 'LastName', BirthYear)

generate() # Generates a random email
# Example: [email protected]

generate('gmail') # Generates a random Gmail
# Example: [email protected]

generate('gmail.com', 'Arash', 'Amiri')
# Example: [email protected]

generate('Outlook', 'Bita', 'Alipour', 1995)
# Example: [email protected]
```

### Suggest Email Usernames:

```python
from emailtools import generate

for i in range(10):
print(generate('Gmail', 'Saman', 'Rezaei', 1980))

# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
# [email protected]
```

### Validate Emails:

```python
from emailtools import isValid

isValid('[email protected]') # True
isValid('Fariborz_Jalali20.gmail.com') # False
isValid('Mohammadrezaei-Arash7@gmail') # False
```

## License

`emailtools` is available under the [MIT license](https://github.com/armanyazdi/emailtools/blob/main/LICENSE).