chatmail relay server ping tool

To install use:

uv tool install cmping

To send and receive from a single chatmail relay:

cmping nine.testrun.org   # <-- substitute with the domain you want to test 

To send from first domain to a second domain and receive from second domain:

cmping nine.testrun.org arcanechat.me 

To show help:

cmping -h 

Example outputs

Example output for single-domain ping:

$ cmping -c 10 nine.testrun.org 

# using accounts_dir at: /home/user/.cache/cmping
PING nine.testrun.org(brrey3kzk@nine.testrun.org) -> nine.testrun.org(uogfnwf3r@nine.testrun.org) count=10
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=0 time=490.42ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=1 time=298.80ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=2 time=232.80ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=3 time=245.76ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=4 time=253.45ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=5 time=293.69ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=6 time=238.98ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=7 time=321.58ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=8 time=209.66ms
64 bytes ME -> nine.testrun.org -> nine.testrun.org -> ME seq=9 time=233.20ms
--- brrey3kzk@nine.testrun.org -> uogfnwf3r@nine.testrun.org statistics ---
10 transmitted, 10 received, 0.00% loss
rtt min/avg/max/mdev = 209.661/281.833/490.416/81.265 ms

Example output for two-domain ping:

$ cmping -c 10 mailchat.pl mehl.cloud 
# using accounts_dir at: /home/user/.cache/cmping
PING mailchat.pl(3yeby7i8m@mailchat.pl) -> mehl.cloud(eeaocuozy@mehl.cloud) count=10
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=0 time=792.29ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=1 time=370.50ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=2 time=379.01ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=3 time=367.38ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=4 time=367.56ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=5 time=367.98ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=6 time=374.11ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=7 time=373.28ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=8 time=401.45ms
64 bytes ME -> mailchat.pl -> mehl.cloud -> ME seq=9 time=378.89ms
--- 3yeby7i8m@mailchat.pl -> eeaocuozy@mehl.cloud statistics ---
10 transmitted, 10 received, 0.00% loss
rtt min/avg/max/mdev = 367.384/417.246/792.292/132.163 ms

Developing / Releasing cmping

1. clone the git repository at https://github.com/chatmail/cmping

2. install 'cmping' in editing mode: uv pip install -e .

3. edit cmping.py and test, finally commit your changes

CI checks (ruff lint/format, packaging) 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, generates the CHANGELOG.md entry with git-cliff and opens it in your editor, then commits, tags vX.Y.Z and pushes. The release.yml workflow builds and publishes to PyPI via trusted publishing (OIDC); no local twine or PyPI token is involved.