Email clients for grader and other services of fless.pro
Project description
Email client
This repo consist email client for grader and other services and packages.
Installing and run
You need python3.7
, pytest5.0.1
and make4.1
.
Installation: pip install email-client
You can see also PyPi.
We use makefile for run and environment variables for configuration.
You can find smtp-client and imap-client. If you want, you can customize parsing email into smtp-client, you can implement custom strategy and use them. For default, we use strategy for grader.
To clean email (all emails are deleted):
ENV_FILE=./.envs/my_envfile.env CLEAN=YES make clean
Examples
Creating IMAPClient:
from email_client import client_pkg
client = client_pkg.IMAPClient(
imap_host=os.getenv('IMAP_HOST'),
imap_port=os.getenv('IMAP_PORT'),
login=os.getenv('EMAIL_LOGIN'),
password=os.getenv('EMAIL_PASSWORD'),
extract_strategy=strategy,
)
You can log in:
client.login()
And logout:
client.logout()
After some minutes you must login again. A lot of servers logout automatically by a time. Also, you can clean emails:
client.clean_emails()
You can set specify folder:
client.clean_emails('inbox')
Another case, you can get all emails:
emails, statuses = client.get_imails(folder='inbox')
For each emails, you get specify status. If take zip(emails, statuses)
, you got pairs. You can set EmailType
,
for example UNSEEN
:
emails, statuses = client.get_imails(email_typeEmailsTypes.UNSEEN, folder='inbox')
The same way, you can make SMTP client.
Testing
If we integration-test, we have some stages:
- Data generation
- Create objects
- Testing
- Validation
- Clean
If we unit-test, we have some stages:
- Create objects
- Testing
- Validation
In this way unit-test is partial case of integration test. We use unit-test for testing logic in context one object, function (method). For example, we have function:
def plus(a, b):
return a + b
This is unit-test. We want to test simple object. This situation is not always possible. If we want communication some systems and modules, we deal with integration tests. For example, we test connect to data base and collect data from there. This is integration-tests.
All tests lay down into folder:
tests/
If you want to run tests, you can do this (all emails are deleted):
ENV_FILE=.envs/my_envfile.env make test
Example test.env
:
EMAIL_TIMEOUT_TEST=1.5 # Timeout for waiting between reading and writing of emails
IMAP_HOST=imap.mail.ru
IMAP_PORT=993
SMTP_HOST=smtp.mail.ru
SMTP_PORT=587
EMAIL_LOGIN=my@email.ru
EMAIL_PASSWORD=my_password
Emails (integration)
We have some clients for email:
- SMTP-client sends emails
- IMAP-client receives emails
For emails client we have not best way. We test SMTP-client over IMAP-client and IMAP-client over SMTP-client.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for email_client-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45bc675a0b0f9ffa437e9fb296d7beecb321aca54caac0db947c4fbf5a1d1e85 |
|
MD5 | fa8c1413b310010e342da1242cdc14f7 |
|
BLAKE2b-256 | 9d2a9ec7e4d3a3583146f708b90f132564974066770ee7024fe847eb15d992da |