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.1

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.1
File	Size	Uploaded
cmrelayinfo-0.2.1.tar.gz	21.3 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cmrelayinfo 0.2.1
File	Interpreter	ABI	Platform	Reset
cmrelayinfo-0.2.1-py3-none-any.whl 18.7 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 40.0 kB

Release files / cmrelayinfo-0.2.1.tar.gz

Download URL	cmrelayinfo-0.2.1.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`f822cd5b617ee28f07faa3c55e7748e97e8f9f851422bb4aa7da58350184971c`
BLAKE2b-256 checksum How to use checksums	`49127d316bbf545806259c4fdfccd1b500671d447923c1512bd7627e6ac6bef3`
Upload date	Sep 19, 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/29e10bbaf127a87c6b80919f276ba61fd15be882

Workflow

Publishing configuration: github.com/hpk42/cmrelayinfo/blob/29e10bbaf127a87c6b80919f276ba61fd15be882/.github/workflows/release.yml
Publishing logs: github.com/hpk42/cmrelayinfo/actions/runs/35445964533/attempts/1

Artifact

Subject: cmrelayinfo-0.2.1.tar.gz
SHA-256 checksum: f822cd5b617ee28f07faa3c55e7748e97e8f9f851422bb4aa7da58350184971c Verifying attestations

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

Download URL	cmrelayinfo-0.2.1-py3-none-any.whl
Size	18.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`de4f9a1a885f467e625219f621fc91519a5d11d01b14fad522311687b992cb2a`
BLAKE2b-256 checksum How to use checksums	`e4b6b2232c012aa4eccb25952063e1a4ab9b4a85c500f0819cf8096aea574908`
Upload date	Sep 19, 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/29e10bbaf127a87c6b80919f276ba61fd15be882

Workflow

Publishing configuration: github.com/hpk42/cmrelayinfo/blob/29e10bbaf127a87c6b80919f276ba61fd15be882/.github/workflows/release.yml
Publishing logs: github.com/hpk42/cmrelayinfo/actions/runs/35445964533/attempts/1

Artifact

Subject: cmrelayinfo-0.2.1-py3-none-any.whl
SHA-256 checksum: de4f9a1a885f467e625219f621fc91519a5d11d01b14fad522311687b992cb2a Verifying attestations