Mailinator Python SDK
The official Mailinator Python SDK. This REST API client is implemented as a thin wrapper around the Mailinator API. The OpenAPI specification is the source of truth.
API Reference
See Mailinator's API Reference for all of the currently available API endpoints.
Documentation
- OpenAPI spec: https://github.com/manybrain/mailinatordocs/blob/main/openapi/mailinator-api.yaml
- SDK examples:
EXAMPLE.md - SDK architecture and OpenAPI alignment workflow:
OPENAPI_ALIGNMENT.md - Current modernization and alignment work:
ROADMAP.md
Installation
pip install mailinator-python-client-2
Quick Start
from mailinator import Mailinator
client = Mailinator("YOUR_API_TOKEN")
For request examples (inbox, messages, domains, rules, webhooks, and stats), see EXAMPLE.md.
Tests
Run the mocked tests with:
python -m pytest tests/test_mailinator_mocked.py
These tests do not make network requests and do not require Mailinator credentials.
Run the integration tests with:
python -m pytest tests/test_mailinator.py -s
Integration tests require valid environment values and will skip when required settings are missing.
Use either:
.env(recommended): copy.env.exampleto.envand fill in values.tests/localsettings.py: copytests/localsettings.py.templatetotests/localsettings.py(it also loads.envif present).
Run the full suite with:
python -m pytest
Metadata
Release files for mailinator-python-client-2 1.0.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mailinator_python_client_2-1.0.9.tar.gz | 21.2 kB | Without provenance | Details for mailinator_python_client_2-1.0.9.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mailinator_python_client_2-1.0.9-py3-none-any.whl | Python 3 | none | any | Details for mailinator_python_client_2-1.0.9-py3-none-any.whl |
Total release size: 46.0 kB
Release files / mailinator_python_client_2-1.0.9.tar.gz
| Download URL | mailinator_python_client_2-1.0.9.tar.gz |
|---|---|
| Size | 21.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d0c6a38857f929272088695fcc9ff9308ed668bd602f5b5c2108149e8349b053
|
|
BLAKE2b-256 checksum How to use checksums |
27358292c86d608847a5b5772f69fe6a88a67b2ca6edbbb0729438e2151c1229
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / mailinator_python_client_2-1.0.9-py3-none-any.whl
| Download URL | mailinator_python_client_2-1.0.9-py3-none-any.whl |
|---|---|
| Size | 24.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0798a85d118d24c30ff767382e18d2897db41be45ce83cdf12f5d078e4a7de2b
|
|
BLAKE2b-256 checksum How to use checksums |
4774b24f6cb3156a54a182f1ac55e27611076aca6efc031e40f6d14469c7fac2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for mailinator-python-client-2 1.0.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.