Skip to content

Commit c728a28

Browse files
committed
quick push
1 parent f04241b commit c728a28

File tree

1 file changed

+28
-67
lines changed

1 file changed

+28
-67
lines changed

README.md

Lines changed: 28 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,62 +1,43 @@
1-
# Emv
1+
# 📬 emv
22

3-
[![EMV](https://img.shields.io/pypi/v/emv.svg)](https://pypi.python.org/pypi/emv)
4-
[![License](https://img.shields.io/pypi/l/emv.svg)](https://github.com/your-repo/emv/blob/main/LICENSE)
5-
[![Python Versions](https://img.shields.io/pypi/pyversions/emv.svg)](https://pypi.python.org/pypi/emv)
6-
[![CI](https://github.com/your-repo/emv/actions/workflows/ci.yml/badge.svg)](https://github.com/your-repo/emv/actions)
3+
emv is a blazingly fast Python email validator written in Rust.
74

5+
```python
6+
from emv import validate_email, EmailValidator
87

9-
[**Docs**](https://docs.your-repo.com/emv/) | [**GitHub**](https://github.com/your-repo/emv)
10-
11-
EMV is a fast and robust email validation library for Python, utilizing a Rust backend to ensure optimal performance. This package is designed to enhance and speed up the functionality of the older `python-email-validator` library.
12-
13-
<p align="center">
14-
<img src="https://your-image-url.com/benchmark.svg" alt="Benchmark Results">
15-
</p>
16-
17-
<p align="center">
18-
<i>Benchmark comparing EMV with other email validation libraries.</i>
19-
</p>
20-
21-
- 🚀 Lightning-fast validation powered by Rust
22-
- 📦 Available on PyPI for easy installation
23-
- 🌐 Supports internationalized email addresses (IDN)
24-
- 🛠️ Configurable validation settings
25-
- 📜 Detailed error messages
26-
- 🔄 Normalizes email addresses
27-
- ✅ RFC 5322 and RFC 6531 compliance
28-
29-
## Table of Contents
30-
31-
1. [Getting Started](#getting-started)
32-
2. [Installation](#installation)
33-
3. [Usage](#usage)
34-
4. [Configuration](#configuration)
35-
5. [Technical Details](#technical-details)
36-
6. [Examples](#examples)
37-
7. [Contributing](#contributing)
38-
8. [Support](#support)
39-
9. [Acknowledgements](#acknowledgements)
40-
10. [License](#license)
41-
42-
## Getting Started
8+
439

44-
For comprehensive documentation, visit the [official docs](https://docs.your-repo.com/emv/).
10+
try:
11+
validated_email = validate_email(email)
12+
print(validated_email)
13+
except Exception as e:
14+
print(f"Validation error: {e}")
15+
```
4516

46-
### Installation
17+
## Installation
4718

4819
Install EMV from PyPI:
4920

5021
```sh
5122
pip install emv
5223
```
5324

54-
### Usage
25+
## Features
26+
27+
- Validates email address syntax according to RFC 5322 and RFC 6531
28+
- Checks domain deliverability
29+
- Supports internationalized domain names (IDN) and local parts
30+
- Provides friendly error messages
31+
- Optimized for performance with Rust backend
32+
33+
## Usage
34+
35+
### Quick Start
5536

5637
To validate an email address:
5738

5839
```python
59-
from emv import validate_email
40+
from emv import validate_email, EmailValidator
6041

6142
6243

@@ -67,13 +48,11 @@ except Exception as e:
6748
print(f"Validation error: {e}")
6849
```
6950

70-
## Configuration
51+
### Configurations
7152

7253
You can customize the email validation behavior using the `EmailValidator` class:
7354

7455
```python
75-
from emv import EmailValidator
76-
7756
validator = EmailValidator(
7857
allow_smtputf8=True,
7958
allow_empty_local=False,
@@ -165,28 +144,10 @@ except Exception as e:
165144
print(f"Validation error: {e}")
166145
```
167146

168-
## Contributing
147+
## Getting Help
169148

170-
Contributions are welcome and highly appreciated. To get started, check out the [**contributing guidelines**](https://github.com/your-repo/emv/blob/main/CONTRIBUTING.md).
171-
172-
You can also join us on [**Discord**](https://discord.com/invite/your-discord-invite).
173-
174-
## Support
175-
176-
Having trouble? Check out the existing issues on [**GitHub**](https://github.com/your-repo/emv/issues), or feel free to [**open a new one**](https://github.com/your-repo/emv/issues/new).
177-
178-
You can also ask for help on [**Discord**](https://discord.com/invite/your-discord-invite).
179-
180-
## Acknowledgements
181-
182-
EMV draws inspiration from the `python-email-validator` library and other email validation tools. We are grateful to the maintainers of these tools for their work and the value they provide to the Python community.
149+
For questions and issues, please open an issue in the [GitHub issue tracker](https://github.com/your-repo/emv/issues).
183150

184151
## License
185152

186-
This repository is licensed under the [MIT License](https://github.com/your-repo/emv/blob/main/LICENSE). See the [LICENSE](LICENSE) file for more details.
187-
188-
<div align="center">
189-
<a target="_blank" href="https://your-company.com" style="background:none">
190-
<img src="https://your-image-url.com/your-logo.svg" alt="Made by Your Company">
191-
</a>
192-
</div>
153+
EMV is licensed under the [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file for more details.

0 commit comments

Comments
 (0)