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: 8 months ago
JSON representation
A Python library for email suggestions and validations.
- Host: GitHub
- URL: https://github.com/armanyazdi/emailtools
- Owner: armanyazdi
- License: mit
- Created: 2023-01-08T20:28:39.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-02-26T07:08:52.000Z (almost 3 years ago)
- Last Synced: 2024-11-05T23:42:56.978Z (over 1 year ago)
- Topics: email, pypi, pypi-package, pypi-packages, python, python-libraries, python-library, python3
- Language: Python
- Homepage: https://pypi.org/project/emailtools
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# emailtools
[](https://pypi.org/project/emailtools)
[](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: Reza.Mahmoudi_2023@yahoo.com
generate('gmail') # Generates a random Gmail
# Example: Jafari_Niloufar@gmail.com
generate('gmail.com', 'Arash', 'Amiri')
# Example: Amiri-Arash1@gmail.com
generate('Outlook', 'Bita', 'Alipour', 1995)
# Example: BitaAlipour.1995@outlook.com
```
### Suggest Email Usernames:
```python
from emailtools import generate
for i in range(10):
print(generate('Gmail', 'Saman', 'Rezaei', 1980))
# SamanRezaei@gmail.com
# Rezaei_Saman_1980@gmail.com
# Rezaei_Saman@gmail.com
# RezaeiSaman_5@gmail.com
# Saman_Rezaei_1980@gmail.com
# Rezaei.Saman@gmail.com
# RezaeiSaman7@gmail.com
# Saman-Rezaei_1@gmail.com
# Rezaei_Saman@gmail.com
# Saman.Rezaei1980@gmail.com
```
### Validate Emails:
```python
from emailtools import isValid
isValid('Anahita.Faramarzi@gmail.com') # 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).