Metadata-Version: 2.1
Name: aiotraceroute
Version: 0.1.2
Summary: Asynchronous traceroute in python
Home-page: https://github.com/NicoAdrian/aiotraceroute
Author: Nicolas Adrian
Author-email: nicolasadrian3@gmail.com
License: MIT
Description: # Simple asynchronous traceroute
        
        Dead simple module which provides asynchronous traceroute with asynchronous dns resolution.
        
        Needs root privileges to be executed (for raw socket)
        ## Example
        
        ```python
        import asyncio
        from aiotraceroute import AsyncTraceroute
        
        async def main(dest):
        	# print hop by hop
        	async for n, addr, host in AsyncTraceroute(dest):
        		print(n, addr, host)
        
        	# Or run it without iterating
        	tr = AsyncTraceroute(dest)
        	result = await tr.run()
        	print(result)
        
        asyncio.get_event_loop().run_until_complete(main("google.com"))
        ```
        ## API
        The `AsyncTraceroute` class takes the following arguments:
          * `dest`: Traceroute destination, can either be a hostname or an IP address.
          * `port`: Destination port (optionnal, default: 33333)
          * `max_hops`: Maximum number of hops before reaching final destination (optionnal, default: 30)
          * `timeout`: Timeout between each hop (optionnal: default: 1s)
          * `packet_size`: Pakcte size in bytes to send each time (optionnal: default: 60)
        
        The `run()` method runs the traceroute and returns a list of tuples containing hop_number, address or None, hostname or None
        ## Python versions
        Python >= 3.6 are supported
        
Keywords: traceroute,async,asyncio
Platform: UNKNOWN
Description-Content-Type: text/markdown
