Metadata-Version: 2.4
Name: fluxmail
Version: 0.1.0
Summary: A Python library for Email Automation. FluxMail allows you to create and send emails using either SMTP or Outlook. It supports both Windows and Linux platforms (with Outlook available only on Windows)
Author-email: Vertex AI Automations <info@vertexaiautomations.com>
License-Expression: MIT
Project-URL: homepage, https://www.vertexaiautomations.com
Project-URL: documentation, https://vertex-ai-automations.github.io/fluxmail
Project-URL: repository, https://github.com/vertex-ai-automations/fluxmail
Project-URL: issues, https://github.com/vertex-ai-automations/fluxmail/issues/new
Keywords: email,automation,smtp,outlook,domain,fluxmail
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pywin32; sys_platform == "win32"
Requires-Dist: pylogshield>=0.0.1
Requires-Dist: typer[all]>=0.9.0
Requires-Dist: typing_extensions>=4.0.0

<a name="readme-top"></a>

<div align="center">
<img src="https://github.com/vertex-ai-automations/fluxmail/raw/main/docs/img/fluxmail.png" alt="FluxMail Logo" width="420">

<br/>

[![PyPI version](https://img.shields.io/pypi/v/fluxmail?color=2563eb&logo=pypi&logoColor=white)](https://pypi.org/project/fluxmail/)
[![Python versions](https://img.shields.io/pypi/pyversions/fluxmail?color=2563eb&logo=python&logoColor=white)](https://pypi.org/project/fluxmail/)
[![License: MIT](https://img.shields.io/badge/license-MIT-2563eb.svg)](https://github.com/vertex-ai-automations/fluxmail/blob/main/LICENSE.txt)
[![Downloads](https://img.shields.io/pypi/dm/fluxmail?color=2563eb)](https://pypi.org/project/fluxmail/)
[![CI](https://img.shields.io/github/actions/workflow/status/vertex-ai-automations/fluxmail/release.yml?branch=main&label=CI&logo=github)](https://github.com/vertex-ai-automations/fluxmail/actions)
[![Docs](https://img.shields.io/badge/docs-online-2563eb?logo=readthedocs&logoColor=white)](https://vertex-ai-automations.github.io/fluxmail)

<br/>

<p>
<a href="https://vertex-ai-automations.github.io/fluxmail"><strong>📃 Documentation</strong></a>
&nbsp;·&nbsp;
<a href="https://github.com/vertex-ai-automations/fluxmail/issues/new">🔧 Report Bug</a>
&nbsp;·&nbsp;
<a href="https://www.vertexaiautomations.com">⛪ Vertex AI Automations</a>
</p>

</div>

---

## 📋 Table of Contents

- [Overview](#-overview)
- [Quick Start](#-quick-start)
- [Configuration](#-configuration)
- [Contributing](#-contributing)

---

## 📣 Overview

A Python library for email automation supporting SMTP and Outlook protocols. Send emails
via CLI or Python API. Outlook support is Windows-only (requires `pywin32`).

---

## 📌 Quick Start

### Installation

```bash
pip install fluxmail
```

```bash
pip install --upgrade fluxmail   # upgrade
```

### CLI

```bash
export FLUXMAIL_USERNAME=me@gmail.com
export FLUXMAIL_PASSWORD=secret

fluxmail --type smtp --host smtp.gmail.com --port 587 --tls \
  --subject "Hello" \
  --recipients friend@example.com \
  --body "Hi from the CLI!"
```

### Python API

```python
from fluxmail import FluxMail

FluxMail(
    object_type="smtp",
    host="smtp.gmail.com",
    port=587,
    use_tls=True,
    username="me@gmail.com",
    password="secret",
).create(
    subject="Hello",
    recipients=["friend@example.com"],
    body="Hi there!",
).send()
```

**Full documentation:** 👉 [vertex-ai-automations.github.io/fluxmail](https://vertex-ai-automations.github.io/fluxmail)

---

## ⚙️ Configuration

Pass credentials via environment variables so they never appear in shell history:

```bash
export FLUXMAIL_USERNAME=me@gmail.com
export FLUXMAIL_PASSWORD=secret
```

Works with any SMTP provider — Gmail, SendGrid, Amazon SES, Mailgun, Office 365, or a self-hosted relay.

See [Configuration](https://vertex-ai-automations.github.io/fluxmail/getting-started/configuration/) for provider-specific settings.

---

## 👪 Contributing

All contributions are welcome! Fork the repo, make your changes, and open a pull request.
You can also open an issue with the label `enhancement`.

Don't forget to ⭐ star the project!

🔶 [View all contributors](https://github.com/vertex-ai-automations/fluxmail/graphs/contributors)

---

📃 [Full Docs](https://vertex-ai-automations.github.io/fluxmail) &nbsp;·&nbsp; 🔧 [Report a Bug](https://github.com/vertex-ai-automations/fluxmail/issues/new) &nbsp;·&nbsp; ⛪ [Vertex AI Automations](https://www.vertexaiautomations.com)

<p align="right">(<a href="#readme-top">back to top</a>)</p>
