aiooui

library0.1.9pypypi✓ verified 83d ago

aiooui offers an asynchronous approach to perform Organisationally Unique Identifier (OUI) lookups, enabling efficient identification of vendors based on MAC addresses in Python applications. It supports asynchronous programming models, making it suitable for use in modern Python asynchronous frameworks. The current version is 0.1.9, with a fairly active release cadence, frequently publishing minor updates and bug fixes.

http-networking data

pip install aiooui

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · AIOOUI

aiooui

http-networkingpythonv0.1.9

Install

1.6s avg

Import

—

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.9 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 18.9MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 1.6s · import 0.000s · 19MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

OUIManager

✓ from aiooui import OUIManager

✗ from aiooui import OUI

get_vendor

✓ from aiooui import get_vendor

async_load

✓ from aiooui import async_load

This quickstart demonstrates how to initialize the OUI lookup client and perform an asynchronous vendor lookup for a given MAC address. The `OUI` class handles fetching and caching OUI data. The example uses known MAC prefixes for demonstration.

import asyncio from aiooui import OUI async def main(): oui = OUI() mac_address = '00:08:DC:FF:FF:FF' # Example MAC address (Cisco) vendor = await oui.lookup(mac_address) print(f"Vendor for {mac_address}: {vendor}") # Optionally, look up another known vendor mac_address_2 = 'F8:F0:05:00:00:00' # Example MAC address (Apple) vendor_2 = await oui.lookup(mac_address_2) print(f"Vendor for {mac_address_2}: {vendor_2}") if __name__ == "__main__": asyncio.run(main())

Debug

Known issues

gotchaOn Windows systems, `aiooui` has historically faced issues loading OUI data due to pathing or permissions. Ensure your environment allows the library to download and access necessary data files.

fix

Upgrade to `aiooui` v0.1.9 or newer. If issues persist, manually verify file permissions for the `aiooui` data directory in your Python environment or consider running in a WSL/Linux environment.

affects: <0.1.9

gotchaThe library fetches OUI data from external sources. Intermittent network issues or server unavailability during installation or initial usage can lead to data loading failures. Earlier versions had less robust retry mechanisms.

fix

Ensure a stable internet connection during installation and initial runs. If data loading fails, retry the operation. Version 0.1.8 and later include improved retry logic for data fetching.

affects: <0.1.8

gotchaOlder versions of `aiooui` had a default timeout for fetching OUI data during the build process, which could be too short on slower connections or with large data files, leading to build failures.

fix

Upgrade to `aiooui` v0.1.1 or later, which increased the timeout. For persistent issues, ensure sufficient network bandwidth and consider pre-downloading OUI data if the library supports it (check project documentation for advanced usage).

affects: <0.1.1

Upgrade

Version history

0.1.9latest on PyPI · released Jan 19, 2025

Audit

Dependencies

pythonrequiredRuntime environment

Agent activity

50 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/bluetooth-devices/aiooui ↗

packagehttps://pypi.org/project/aiooui/ ↗

changeloghttps://github.com/bluetooth-devices/aiooui/blob/main/CHANGELOG.md ↗