1 基本信息

- 模塊主頁：[github]
- 類型：#第三方庫

2 安裝方法

pip install pythonping

3 一般使用

from pythonping import ping

@timer ?
def case1(): ?
? ? return (ping('www.baidu.com', verbose=True)) ?
@timer ?
def case2(): ?
? ? return ping('www.baidu.com', verbose=False)

verbose=True:意味著輸出平的執行過程，測試Case1：

--------------------------------------------------------------------------------
[case1] start at 2023-02-12 07:45:48.366523
Reply from 110.242.68.4, 29 bytes in 11.75ms
Reply from 110.242.68.4, 29 bytes in 11.33ms
Reply from 110.242.68.4, 29 bytes in 11.32ms
Reply from 110.242.68.4, 29 bytes in 11.33ms
函數[case1]執行時間為：0.05608487129211426
函數[case1]執行結果為：
Reply from 110.242.68.4, 29 bytes in 11.75ms
Reply from 110.242.68.4, 29 bytes in 11.33ms
Reply from 110.242.68.4, 29 bytes in 11.32ms
Reply from 110.242.68.4, 29 bytes in 11.33ms

Round Trip Times min/avg/max is 11.32/11.43/11.75 ms
[case1] end at 2023-02-12 07:45:48.422608
--------------------------------------------------------------------------------

?verbose=False:意味著不輸出執行過程，測試Case2：

--------------------------------------------------------------------------------
[case2] start at 2023-02-12 07:45:48.422608
函數[case2]執行時間為：0.04709315299987793
函數[case2]執行結果為：
Reply from 110.242.68.4, 29 bytes in 11.41ms
Reply from 110.242.68.4, 29 bytes in 11.56ms
Reply from 110.242.68.4, 29 bytes in 12.15ms
Reply from 110.242.68.4, 29 bytes in 11.75ms

Round Trip Times min/avg/max is 11.41/11.72/12.15 ms
[case2] end at 2023-02-12 07:45:48.470690
--------------------------------------------------------------------------------

可以看出，case1有執行過程，但是case2沒有。

4 ping的返回值

ping的返回值是一個ResponseList對象，既然叫做List那么肯定是可以枚舉的。 我們來測試一下：

@timer  
def case3():  
    print("STEP 1: ping www.baidu.com")  
    ping_rst = ping('www.baidu.com', verbose=False)  
  
    print("ping返回值的數據類型是：%s" % type(ping_rst))  
  
    print("STEP 2: 遍歷ResponseList對象的所有屬性")  
    for ping_item in ping_rst.__dict__:  
        print("[%s]:%s" % (ping_item, ping_rst.__dict__[ping_item]))  
  
    print("STEP 3: 遍歷Response對象的所有屬性")  
    cnt = 1  
    for response_item in ping_rst:  
        print("STEP 3-%s. Resoonse對象" % cnt)  
        cnt += 1  
        for item in response_item.__dict__:  
            print("[%s]:%s" % (item, response_item.__dict__[item]))

4.1 返回值類型以及常用屬性

在例程3中， 第一步是執行ping函數，并且取得他的返回值。

第一步的返回結果是：

STEP 1: ping www.baidu.com
ping返回值的數據類型是：<class 'pythonping.executor.ResponseList'>

以上表明， 返回的是pythonping內部定義的一個對象。 既然如此，我們接下來看看一下這個對象的屬性，執行結果如下：

STEP 2: 遍歷ResponseList對象的所有屬性
[_responses]:[Reply from 110.242.68.4, 29 bytes in 11.68ms, Reply from 110.242.68.4, 29 bytes in 11.39ms, Reply from 110.242.68.4, 29 bytes in 11.51ms, Reply from 110.242.68.4, 29 bytes in 11.82ms]
[stats_packets_sent]:4
[stats_packets_returned]:4
[verbose]:False
[output]:<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>
[rtt_avg]:0.01159732499945676
[rtt_min]:0.011385000019799918
[rtt_max]:0.011815299978479743

在這次遍歷中，有一個內部屬性_responses實際上就是4此ping請求的信息。 這里我們日常使用比較多的。就是三個rtt開頭的值，只是用方法直接作為屬性讀取即可。
關于RTT這個縮寫，我讀了pythonping的源碼，并滅有給出詳細的解釋。 于是我請教了ChatGPT，它的回答是：

RTT代表往返時間（Round Trip Time），即數據包從源傳輸到目的地再返回所需的時間。RTT通常用于測量網絡延遲和網絡連接質量。在網絡通信的上下文中，RTT是指從發送請求到接收相應響應之間經過的時間。

4.2 ResponseList中的每個Response對象的屬性

這部分內容在STEP 3中， 我遍歷了所有的屬性：

STEP 3-1. Resoonse對象
[message]:45 00 00 1d c1 52 00 00 35 01 1e 03 6e f2 44 04 c0 a8 32 ec 00 00 46 f9 7f 06 01 00 39
[time_elapsed]:0.01167790000909008
[source_request]:08 00 3e f9 7f 06 01 00 39
[repr_format]:legacy
STEP 3-2. Resoonse對象
......

這里面有4個屬性：

• message: 發送的內容
• time_elapsed: 時間
• source_request:接收的信息
• repr_format: 如何將返回值變為文字列。 有兩個可能的屬性legacy以及None

4.3 pythonping.ping() 方法的常用形參包括：

• hostname: 目標主機的域名或 IP 地址
• size: 發送的數據的大小，以字節為單位。默認為 56 字節
• count: 要發送的請求的數量。默認為 4 次
• timeout: 超時時間，以秒為單位。默認為 1s
• verbose: 布爾值，用于指示是否顯示詳細的輸出。默認為 False