Metadata-Version: 2.4
Name: cmping
Version: 0.14.0
Summary: ping messages between chatmail relays
Project-URL: Repository, https://github.com/chatmail/cmping
Project-URL: Changelog, https://github.com/chatmail/cmping/blob/master/CHANGELOG.md
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: deltachat-rpc-server>=2.24.0
Requires-Dist: deltachat-rpc-client>=2.24.0
Requires-Dist: xdg-base-dirs>=6.0.2
Dynamic: license-file

# 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(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: `pip install -e .`

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

4. set a new git-tag 

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

6. run the following command: 

        rm -rf dist && python -m build && twine upload -r pypi dist/cmping*
