cmping 0.16.0

ping messages between chatmail relays

chatmail relay server ping tool

To install use:

pip 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([e-mail]) -> nine.testrun.org([e-mail]) 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
--- [e-mail] -> [e-mail] 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([e-mail]) -> mehl.cloud([e-mail]) 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
--- [e-mail] -> [e-mail] 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: pip install -e .

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

4. update CHANGELOG.md with the new version number and changes

5. install build/release tools: pip install build twine

6. run the release script:

    python release.py
   

   The release script will:

   • Validate the version in CHANGELOG.md is a proper version jump
   • Create and push a git tag for the version
   • Build the package and upload to PyPI
   • Add a dev changelog entry and commit it
   • Print which tag was uploaded to PyPI