Metadata-Version: 2.1
Name: winping
Version: 0.2.1
Summary: Ping implementation which utilizes Windows ICMP API
Home-page: https://github.com/Snawoot/winping
Author: Vladislav Yarmak
Author-email: vladislav-ex-src@vm-0.com
License: MIT
Description: winping
        =======
        
        Ping implementation which utilizes Windows ICMP API
        
        ## Installation
        
        Standard Python package installation.
        
        ## Usage
        
        ### Utility
        
        #### Synopsis
        
        ```
        C:\>winping --help
        usage: winping [-h] [-w TIMEOUT] [-l SIZE] [-t | -n COUNT] [-4 | -6] address
        
        Ping implementation which utilizes Windows ICMP API
        
        positional arguments:
          address     specifies the host name or IP address of the destination
        
        optional arguments:
          -h, --help  show this help message and exit
          -w TIMEOUT  timeout in milliseconds to wait for each reply (default: 1000)
          -l SIZE     timeout in seconds to wait for each reply (default: 32)
          -t          ping the specified host until stopped (default: False)
          -n COUNT    number of echo requests to send (default: 4)
          -4          force using IPv4 (default: False)
          -6          force using IPv6 (default: False)
        
        ```
        
        #### Example
        
        ```
        C:\>winping google.com
        
        Pinging google.com [172.217.20.206] with 32 bytes of data:
        Reply from 172.217.20.206: bytes=32 time=29ms TTL=57
        Reply from 172.217.20.206: bytes=32 time=25ms TTL=57
        Reply from 172.217.20.206: bytes=32 time=24ms TTL=57
        Reply from 172.217.20.206: bytes=32 time=25ms TTL=57
        
        Ping statistics for 172.217.20.206:
            Packets: Sent = 4, Received = 4, Lost = 0 (0.00% loss),
        Approximate round trip times in milli-seconds:
            Minimum = 24ms, Maximum = 29ms, Average = 26ms
        
        C:\>winping -6 google.com
        
        Pinging google.com [2a00:1450:401b:804::200e] with 32 bytes of data:
        Reply from 2a00:1450:401b:804::200e: time=79ms
        Reply from 2a00:1450:401b:804::200e: time=77ms
        Reply from 2a00:1450:401b:804::200e: time=76ms
        Reply from 2a00:1450:401b:804::200e: time=75ms
        
        Ping statistics for 2a00:1450:401b:804::200e:
            Packets: Sent = 4, Received = 4, Lost = 0 (0.00% loss),
        Approximate round trip times in milli-seconds:
            Minimum = 75ms, Maximum = 79ms, Average = 77ms
        
        ```
        
        Also, if python scripts are not in your system path, you may run it like this: `python -m winping`
        
        ### Library
        
        ```python3
        import winping
        with winping.IcmpHandle() as h:
            resp = winping.ping(h, '8.8.8.8')
        print(resp[0].RoundTripTime)
        with winping.Icmp6Handle() as h:
            resp = winping.ping6(h, '2a00:1450:401b:804::200e')
        print(resp[0].RoundTripTime)
        ```
        
        For example of working ping utility see [winping/\_\_main\_\_.py](winping/__main__.py).
        
        ## Limitations
        
        * Works only on Windows XP and newer.
        * No asyncio support at this moment, but you may run ping in thread executor.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2003
Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2008
Classifier: Operating System :: Microsoft :: Windows :: Windows XP
Classifier: Operating System :: Microsoft :: Windows :: Windows Vista
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: Microsoft :: Windows :: Windows 8
Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Networking
Classifier: Topic :: Utilities
Requires-Python: >=3.5.3
Description-Content-Type: text/markdown
