aiotraceroute 0.1.0

Asynchronous traceroute in python

Simple asynchronous traceroute

Dead simple module which provides asynchronous traceroute with asynchronous dns resolution.

Example

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)

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