Metadata-Version: 2.1
Name: xchange-mail
Version: 0.0.5
Summary: Solução de gerenciamento e envio de e-mails via MS Exchange
Home-page: https://github.com/ThiagoPanini/xchange_mail
Author: Thiago Panini
Author-email: thipanini94@gmail.com
License: MIT
Keywords: Mail,Microsoft Exchange,exchangelib,HTML mail
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.0.0
Description-Content-Type: text/markdown
Requires-Dist: exchangelib (==3.3.0)
Requires-Dist: pretty-html-table (==0.9.dev0)
Requires-Dist: pandas
Requires-Dist: python-dotenv

<h1 align="center">
  <a href="https://pypi.org/project/xchange-mail/"><img src="https://i.imgur.com/ISexIyT.png" alt="xchange_mail logo"></a>
</h1>

<div align="center">
  <strong>Envio de E-mails via Exchange</strong>
</div>
<br/>

<div align="center">

![Release](https://img.shields.io/badge/release-ok-brightgreen)
[![PyPI](https://img.shields.io/pypi/v/xchange_mail?color=blueviolet)](https://pypi.org/project/xchange-mail/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/xchange_mail?color=green)
![PyPI - Status](https://img.shields.io/pypi/status/xchange_mail)

</div>
<br/>

Biblioteca python construída para facilitar o gerenciamento e envio de e-mails utilizando a biblioteca `exchangelib` como ORM da caixa de e-mails Exchange.

## Instalação via git clone

Para utilização das funcionalidades encapsuladas neste repositório, é possível executar o comando `git clone` na máquina local.

```bash
$ git clone https://github.com/ThiagoPanini/xchange_mail.git 
```

Nesse cenário, o usuário pode usufruir de scripts disponibilizados no diretório `examples` para terem uma base de utilização das ferramentas deste repositório. Um dos exemplos de uso está presente em `examples/starlight`, sendo seu conteúdo é dado por:

```bash
└── starlight
    ├── depara_imgs.txt
    ├── depara_tags.txt
    ├── starlight.html
    └── starlight.py
```

O script `starlight.py`, desde configurado previamente com as credenciais do usuário executar do código, permite o envio de um e-mail altamente customizado com um template HTML com o tema Starlight criado a partir da plataforma <a href="https://beefree.io/">Bee Free</a>.

<h1 align="center">
  <img src="https://i.imgur.com/SeNZiJ6.png" alt="starlight_template">
</h1>

## Instalação via pip

Adicionalmente, é possível realizar a instalação do pacote diretamente do <a href="https://pypi.org/project/xchange-mail/0.0.1/">PyPI</a>. Para tal, é recomendada a criação de um ambiente virtual para o projeto ao qual exige a utilização das funcionalidades aqui expostas a partir da sequência de comandos abaixo:

```bash
# Criando e ativando ambiente virtual
$ python3 -m venv <nome_venv>
$ source ~/<nome_venv>/bin/activate

# Instalando biblioteca
pip install xchange_mail
```

Assim, em qualquer script Python, será possível importar os módulos da biblioteca da seguinte forma

```bash
from xchange_mail.handler import send_simple_mail
```


