Skip to main content

Mailing services with HTTP Api

Project description

💨💨💨 Pyuubin – Mailing System 💨💨💨

Build Status

Asynchronous mailing system over HTTP API.

郵便 (Yūbin) - Postal Service

ぴゅー (Pyu-) – SFX for a sudden burst of speed, like running away from something


pip install pyuubin

Installation from source

pip install .

Running the service

You need to run the API and Worker for the system to work.


Use hypercorn or uvicorn to run it

hypercorn --access-log - --error-log -

The Worker

$ python -m pyuubin.worker --help
Usage: [OPTIONS]

  Run the worker.

  -n, --name TEXT                 Name of the service
  -w, --workers INTEGER           Number of workers
  -d, --debug                     Enable debug mode.
  -e, --print-environment-variables
                                  print environment variables to be put in
                                  .env file for configuration
  --help                          Show this message and exit.


You can configure Pyuubin by using environmental variables. List of variables is available on running

$ python -m pyuubin -e

Note that the password is a SecretStr type from pydantic, so in your .env. file please just write your password without SecretStr(), so actually what you want is: PYUUBIN_SMTP_PASSWORD=secret

Pyuubin supports .env files. You can create one quite easily by running above command and directing the output to a .env file.

$ python -m pyuubin -e > .env

Then edit this file, put the values required and run the app.

Authentication - Password File

Generating passwords with htpasswd:

htpasswd -Bc test_htpasswd app1

Note: Only blowfish encrypted hashes are supported

API Specification

You can find API docs here: redoc pages


  • Documentation
  • Client library
  • Handling of rejected/failed mails
  • Bounces management
  • Rate limitting for source / global

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyuubin-0.1.1.tar.gz (12.6 kB view hashes)

Uploaded source

Built Distribution

pyuubin-0.1.1-py3-none-any.whl (15.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page