joamag/posterum repository overview

⁠Posterum 📫⁠

Simple (yet powerful) e-mail address verification service.

Build for educational purposed but ready for production.

⁠Features

• SMTP-based validation
• Catch-all⁠ tentative verification
• Email service differentiation (e.g., Microsoft, Google, Yahoo, Zoho, etc.)
• Horizontal scalability

⁠Installation

⁠Development

1. Make sure you are running in a virtual environment (e.g., python3 -m venv .venv)
2. Activate it (e.g., source .venv/bin/activate or .\.venv\Scripts\Activate.ps1)
3. Install dependencies (we use pip-tools⁠ for dependency management)

Request email validation using GET http://localhost:8080/v1/addresses/validate?key=123&[email protected].

⁠Load testing

You can use K6⁠ to load-test the API. To do so, you need to install K6 and run the following command:

k6 run --vus 64 --iterations 5000 load/email-local.js

⁠License

Posterum is currently licensed under the Apache License, Version 2.0⁠.

⁠Build Automation