Metadata-Version: 2.4
Name: mailwizz-python-sdk
Version: 1.0.4
Summary: This repository contains the Python SDK for MailWizz EMA.
Author-email: twisted1919 <support@mailwizz.com>
License: MIT
Project-URL: Homepage, https://www.mailwizz.com
Project-URL: Documentation, https://api-docs.mailwizz.com/python
Project-URL: Source, https://github.com/twisted1919/mailwizz-python-sdk
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: multidimensional-urlencode>=0.0.4
Requires-Dist: requests>=2.31.0
Requires-Dist: urllib3>=1.26.18
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Dynamic: license-file

Mailwizz Python SDK
================

This repository contains the Python SDK for MailWizz EMA.  
You'll find proper example on how to manage lists, subscribers, campaigns, templates and more.

The documentation website at https://api-docs.mailwizz.com/python showcases all the API endpoints.  
You can find them in the examples folder as well.  

Other implementations:
- PHP: https://github.com/twisted1919/mailwizz-php-sdk.  

- Node.js: https://www.npmjs.com/package/node-mailwizz  

### Install
You can either download latest version of the code or you can install it via pip as follows:  
`pip install mailwizz-python-sdk`  
Then follow the instructions from `examples/setup_api.py` file.

### Development

#### Running Tests
The package includes a comprehensive test suite. To run tests:

```bash
# Install with dev dependencies
pip install -e ".[dev]"

# Run all tests
pytest tests/

# Run with coverage report
pytest tests/ --cov=mailwizz --cov-report=term
```

Tests cover:
- Configuration and validation
- Client initialization and instance isolation
- Request signing (HMAC-SHA1) matching PHP SDK format
- All HTTP methods (GET, POST, PUT, DELETE)
- Endpoint functionality
- Regression tests for fixed bugs

### Python packaging reference    
1. https://packaging.python.org/tutorials/packaging-projects/  
2. https://packaging.python.org/tutorials/installing-packages/#creating-virtual-environments  
