herfy-email

Provider-abstracted email SDK for Herfy applications. Send transactional email using only your Control Center client_id and client_secret — no email provider credentials in app config.

Installation

pip install herfy-email[mailgun]

Usage

from herfy_email import HerfyEmailClient, AsyncHerfyEmailClient

# Sync
client = HerfyEmailClient.from_credentials(
    client_id="app_pettycash",
    client_secret="your_secret",
    control_center_url="https://cc.herfy.com",
)
client.send(to="user@herfy.com", subject="Hello", html="<p>Hello</p>", text="Hello")

# Async (FastAPI)
client = AsyncHerfyEmailClient.from_credentials(
    client_id="app_pettycash",
    client_secret="your_secret",
    control_center_url="https://cc.herfy.com",
)
await client.send(to="user@herfy.com", subject="Hello", html="<p>Hello</p>", text="Hello")

# From environment variables (CC_CLIENT_ID / AUTH_CLIENT_ID, CC_CLIENT_SECRET / AUTH_CLIENT_SECRET, CC_URL / CONTROL_CENTER_URL)
client = HerfyEmailClient.from_env()

How it works

SDK authenticates with Control Center via POST /api/app-auth/token (cached, TTL 300s)
SDK fetches provider config from GET /api/config/email (cached for process lifetime)
SDK calls the configured provider (Mailgun, SendGrid, …) directly

Switching email providers requires only a Control Center env-var change — zero app changes.

Provider support

Provider	Extra
Mailgun	`pip install herfy-email[mailgun]`
SendGrid	`pip install herfy-email[sendgrid]`

Control Center configuration

EMAIL_PROVIDER=mailgun
MAILGUN_API_KEY=key-xxxxxxxxxxxxxxxxxxxxxxxx
MAILGUN_DOMAIN=mg.herfy.com
MAILGUN_FROM_ADDRESS=noreply@herfy.com

Download files

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

Source Distribution

herfy_email-1.1.0.tar.gz (11.1 kB view details)

Uploaded Jul 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

herfy_email-1.1.0-py3-none-any.whl (11.3 kB view details)

Uploaded Jul 26, 2026 Python 3

File details

Details for the file herfy_email-1.1.0.tar.gz.

File metadata

Download URL: herfy_email-1.1.0.tar.gz
Upload date: Jul 26, 2026
Size: 11.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for herfy_email-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`c4138763839166e27220f07664b6b3d00d740a4361d4f3c516f7a7cf0a0ae76c`
MD5	`168d9f639339d3cf3f04d5f89ba77e91`
BLAKE2b-256	`cd67db451f689c846f59384cd7cb7cb05bb8d6d144cf4a9ba03b33539c5ed3fe`

See more details on using hashes here.

Provenance

The following attestation bundles were made for herfy_email-1.1.0.tar.gz:

Publisher: publish-email-sdk.yml on Herfy-Food-Services/herfy-shared-library

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: herfy_email-1.1.0.tar.gz
- Subject digest: c4138763839166e27220f07664b6b3d00d740a4361d4f3c516f7a7cf0a0ae76c
- Sigstore transparency entry: 2255810874
- Sigstore integration time: Jul 26, 2026
Source repository:
- Permalink: Herfy-Food-Services/herfy-shared-library@3b64cb01e836e8209d8d20db4af365f0db671a7b
- Branch / Tag: refs/tags/herfy-email/v1.1.0
- Owner: https://github.com/Herfy-Food-Services
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-email-sdk.yml@3b64cb01e836e8209d8d20db4af365f0db671a7b
- Trigger Event: push