aiohappyeyeballs

2.6.1 · active · verified Mon Apr 06

Happy Eyeballs for asyncio, currently at version 2.6.1. The library is actively maintained and facilitates easy connection establishment with fallback strategies using asyncio.

Common errors

```
ModuleNotFoundError: No module named 'aiohappyeyeballs'
```
cause The 'aiohappyeyeballs' package is not installed in the current Python environment.

fix Install the package using pip: 'pip install aiohappyeyeballs'.
```
ImportError: cannot import name 'start_connection' from 'aiohappyeyeballs'
```
cause The function 'start_connection' is not found in the 'aiohappyeyeballs' module, possibly due to an incorrect import statement.

fix Ensure the correct import statement: 'from aiohappyeyeballs import start_connection'.
```
TypeError: start_connection() missing 1 required positional argument: 'addr_infos'
```
cause The 'start_connection' function was called without the necessary 'addr_infos' argument.

fix Provide the required argument when calling the function: 'socket = await start_connection(addr_infos)'.
```
IndexError: tuple index out of range (in start_connection method)
```
cause This specific IndexError occurs in the `start_connection` method when socket creation fails with an exception other than an `OSError`, which was a known bug in older versions, particularly when `uvloop` was in use.

fix Update `aiohappyeyeballs` to the latest version to get the fix: `pip install --upgrade aiohappyeyeballs`
```
OSError: [Errno 113] Connect call failed ('<IP_ADDRESS>', <PORT>)
```
cause The `aiohappyeyeballs` library failed to establish a connection to the specified host and port because the target machine was unreachable or actively refused the connection (e.g., firewall, incorrect IP/port, server not running).

fix Verify the target host's IP address and port are correct, ensure the server is running and accessible, and check for any firewall rules blocking the connection.

Warnings

breaking Import paths have changed in v2.5.0. Ensure you import using the new structure.
Fix: Update import statements to use 'from aiohappyeyeballs import HappyEyeballs'.
gotcha Python versions below 3.9.2 may lead to a TypeError during import.
Fix: Upgrade Python to 3.9.2 or higher.

Install

pip install aiohappyeyeballs Install aiohappyeyeballs

Imports

HappyEyeballs
```
from aiohappyeyeballs import HappyEyeballs
```
Avoid using direct import from the old module structure.

Quickstart

Basic usage of HappyEyeballs to resolve an address asynchronously.

import asyncio
from aiohappyeyeballs import HappyEyeballs

async def main():
    resolver = HappyEyeballs()
    addr = await resolver.resolve('example.com')
    print(addr)

asyncio.run(main())

view raw JSON →