Skip to main content

A Flask-based web application for testing SMTP server connections and sending test emails

Project description

SMTP Tester

PyPI GitHub Workflow Status License

A Flask-based web application to test SMTP server connections and send test emails. This tool is designed to help developers and system administrators verify SMTP server configurations with a user-friendly interface and AI-powered chat support.

Overview

SMTP Tester provides:

  • Testing of SMTP server connectivity with security options (None, SSL, TLS, Auto).
  • Sending test emails to verify sender and recipient addresses.
  • Real-time chat assistance powered by OpenAI.
  • Email address validation before sending.
  • Secure form submissions with CSRF protection.
  • Configuration of sensitive settings via .env file.

This project is open-source under the MIT License and welcomes contributions from the community.

Demo

SMTP Tester features a sleek, dark-themed interface with a form to input SMTP details and a live chat for troubleshooting. Run it locally to see it in action, or check the Issues page for planned UI enhancements!

Installation and Usage

Prerequisites

  • Python 3.6 or higher
  • pip (Python package manager)
  • Git (for cloning the repository)

Installation Steps

  1. Clone the repository:
    git clone https://github.com/Mrv3n0m666/Smtp-Webtester.git
    cd Smtp-Webtester
    
  2. Install dependencies:
    pip install -r requirements.txt
    
  3. Create a .env file in the project root and add your OpenAI API key:
    OPENAI_API_KEY=sk-proj-your-api-key
    
  4. Run the application:
    python smtpWEBtester.py
    

Usage

  1. Open your browser and navigate to http://localhost:5000.
  2. Fill in the SMTP server details:
    • SMTP Host: e.g., smtp.example.com
    • Port: Common ports are 465 (SSL) or 587 (TLS)
    • Security: Choose None, SSL, TLS, or Auto
    • Username: Your SMTP username (e.g., your@email.com)
    • Password: Your SMTP password or API key
    • Mail From: Sender email address
    • Mail To: Recipient email address
  3. Click Test SMTP to send a test email.
  4. Check the result message for success or error details.
  5. Use the chat feature on the right to ask for assistance or troubleshooting tips.

Notes

  • Ensure your SMTP server supports the selected security protocol.
  • Email addresses are validated to prevent errors.
  • The form is protected against CSRF attacks.
  • For production, configure a secure environment and disable debug mode (debug=True).

Roadmap

We aim to make SMTP Tester more robust and feature-rich. Planned features include:

  • Support for multiple recipients in a single test.
  • Test history stored in a local database.
  • Integration with alternative AI chat providers (e.g., xAI Grok).
  • Automated tests with pytest.
  • Deployment guides for platforms like Heroku or Docker.

Have an idea? Open an issue to discuss!

Contributing

We love contributions! Whether you're fixing bugs, adding features, or improving docs, your help is welcome. See our CONTRIBUTING.md for detailed guidelines on how to get started. Check the Issues page for tasks labeled good first issue or help wanted.

License

MIT License. See LICENSE for details.

Acknowledgements

  • Thanks to the Flask and OpenAI communities for their amazing tools.
  • Shoutout to future contributors for helping improve SMTP Tester!

Contact

For questions, suggestions, or bug reports, please open an issue or contact Mrv3n0m666.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smtp_webtester-0.1.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

smtp_webtester-0.1.0-py3-none-any.whl (3.2 kB view details)

Uploaded Python 3

File details

Details for the file smtp_webtester-0.1.0.tar.gz.

File metadata

  • Download URL: smtp_webtester-0.1.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.5

File hashes

Hashes for smtp_webtester-0.1.0.tar.gz
Algorithm Hash digest
SHA256 453e53ac7f6ff8eb0c9c27778b75e476f5fe8d82e4e78c861421f523297ed7d5
MD5 7a34ff5292ccf6cce46d0c95865e4e6c
BLAKE2b-256 3b15c2549bba58cda17c5cf8eba6cc44743f4af1579006b02b2876c9a5af33aa

See more details on using hashes here.

File details

Details for the file smtp_webtester-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: smtp_webtester-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.5

File hashes

Hashes for smtp_webtester-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 36f8f051786cf3a9a8516f2f9d332d013569bc50ae94b37535d9d5cf345f65f8
MD5 09d6c3538a81e53f0326d4549967df6b
BLAKE2b-256 700199fd1d46eb3d6f4d0389415254bdde0f390febbf52ddd5e3c0fb21614839

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page