What is ddmail_dmcp_keyhandler

Web application API for dovecot mail-crypt-plugin using per folder keys for the DDMail project. Support for creating password protected keys and change password on keys.

What is DDMail

DDMail is a e-mail system/service that prioritize security. A current production example can be found at www.ddmail.se

Operating system

Developt for and tested on debian 12.

Installing using pip

pip install ddmail-dmcp-keyhandler

Building and installing from source using hatchling.

Step 1: clone github repo
git clone https://github.com/drzobin/ddmail_dmcp_keyhandler [code path]
cd [code path]

Step 2: Setup python virtual environments
python -m venv [venv path]
source [venv path]/bin/activate

Step 3: Install package and required dependencies
pip install -e .[dev]

Step 4: Build package
python -m pip install --upgrade build
python -m build

Packages is now located under dist folder

Step 5: Install package
pip install dist/[package name].whl

Running in development mode

source [ddmail_dmcp_keyhandler venv]/bin/activate
export MODE=DEVELOPMENT
flask --app ddmail_dmcp_keyhandler:create_app(config_file="[full path to config file]") run --host=127.0.0.1 --port 8002 --debug

Testing

cd [code path]
pytest --cov=ddmail_dmcp_keyhandler tests/ --config=[config file path] --password=[password]

Coding

Follow PEP8 and PEP257. Use Flake8 with flake8-docstrings for linting. Strive for 100% test coverage.