cmrelayinfo

Report chatmail relay capabilities: iroh relay URL, TURN server, maxsmtprecipients and storage quota.

For each relay, cmrelayinfo logs in with a chat profile that is created once and then cached under ~/.cache/cmrelayinfo/, so repeated runs do not create new accounts on relays.

Usage

cmrelayinfo                     # all relays from chatmail.at/relays (cached)
cmrelayinfo nine.testrun.org    # one specific relay
cmrelayinfo 116.203.128.59      # relay given as IP address
cmrelayinfo --json --refresh    # jsonlines output, refetch relay list

Installation

uv tool install cmrelayinfo

Development

uv venv && uv pip install -e . --group test
uv run pytest

CI checks come from the shared chatmail/workflows repository; run them locally with uvx ruff check . and uvx ruff format --check .

To release, run the shared release script from a checkout of chatmail/workflows:

python ../workflows/scripts/make_new_release.py

It runs the checks, tests the built wheel, writes the CHANGELOG.md entry with git-cliff, then tags and pushes. The release.yml workflow publishes to PyPI via trusted publishing (OIDC).

Metadata

Release files for cmrelayinfo 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cmrelayinfo 0.2.0
File	Size	Uploaded
cmrelayinfo-0.2.0.tar.gz	20.9 kB	Aug 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cmrelayinfo 0.2.0
File	Interpreter	ABI	Platform	Reset
cmrelayinfo-0.2.0-py3-none-any.whl 18.6 kB Aug 26, 2026	Python 3	none	any	Details

Total release size: 39.5 kB

Release files / cmrelayinfo-0.2.0.tar.gz

Download URL	cmrelayinfo-0.2.0.tar.gz
Size	20.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`3501faaa548cdf96f5a5136fa914038f68683d07727133199610303751b4c2eb`
BLAKE2b-256 checksum How to use checksums	`fc33852b45a789afd95b2bed81fa3702d5e6134304a5ad263bcf3148441f54a9`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hpk42/cmrelayinfo
Publishing commit: github.com/hpk42/cmrelayinfo/tree/ef4d7abb99be726f2c2b5d296a5f6f772865507c

Workflow

Publishing configuration: github.com/hpk42/cmrelayinfo/blob/ef4d7abb99be726f2c2b5d296a5f6f772865507c/.github/workflows/release.yml
Publishing logs: github.com/hpk42/cmrelayinfo/actions/runs/32969264609/attempts/1

Artifact

Subject: cmrelayinfo-0.2.0.tar.gz
SHA-256 checksum: 3501faaa548cdf96f5a5136fa914038f68683d07727133199610303751b4c2eb Verifying attestations

Release files / cmrelayinfo-0.2.0-py3-none-any.whl

Download URL	cmrelayinfo-0.2.0-py3-none-any.whl
Size	18.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0363a316fe616fd673c79d6db8abec5e0a6976fc077573a1cd5d45cd86659972`
BLAKE2b-256 checksum How to use checksums	`94c3e750a7ed4bce131fbcda446bfcc815f21624fec5961d408ef7867961749b`
Upload date	Aug 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/hpk42/cmrelayinfo
Publishing commit: github.com/hpk42/cmrelayinfo/tree/ef4d7abb99be726f2c2b5d296a5f6f772865507c

Workflow

Publishing configuration: github.com/hpk42/cmrelayinfo/blob/ef4d7abb99be726f2c2b5d296a5f6f772865507c/.github/workflows/release.yml
Publishing logs: github.com/hpk42/cmrelayinfo/actions/runs/32969264609/attempts/1

Artifact

Subject: cmrelayinfo-0.2.0-py3-none-any.whl
SHA-256 checksum: 0363a316fe616fd673c79d6db8abec5e0a6976fc077573a1cd5d45cd86659972 Verifying attestations