Metadata-Version: 2.4
Name: slaac-resolver
Version: 0.0.5
Summary: Discover SLAAC IPv6 neighbors and resolve their names via mDNS (Avahi)
Author-email: Carlos Junior <cjuniorfox@gmail.com>
License: GNU General Public License v3.0 (GPLv3)
Project-URL: Homepage, https://github.com/cjuniorfox/slaac-resolver
Keywords: slaac,ipv6,mdns,avahi,networking
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# SLAAC Resolver

Discover SLAAC-configured IPv6 neighbors and resolve their mDNS names using Avahi.

## Overview

This tool scans a given network interface for IPv6 neighbors discovered via SLAAC, and attempts to resolve their names using `avahi-resolve-address`. It can be used both as a command-line utility and as a Python library.

## Installation

Clone the repository and install it in editable mode:

```bash
git clone https://github.com/cjuniorfox/slaac-resolver.git
cd slaac-resolver
pip install -e .
````

This will make the `slaac-resolver` command available on your system.

## Usage

### Command-Line Interface

```bash
slaac-resolver <interface> [--log-level <LOG_LEVEL>]
```

. `--log-level` is optional. Possible values: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`. Default is `INFO`.

Example:

```bash
slaac-resolver br0 --log-level DEBUG
```

The output is a JSON list of resolved neighbors, like:

```json
[
  {
    "hostname": ["mydevice", "local"],
    "ipv6": ["fe80", "", "abcd", "1234", "5678", "9abc", "def0", "1234"]
  }
]
```

### Python Library

You can also use the resolver in your Python code:

```python
from slaac_resolver import get_ipv6_neighbors

neighbors = get_ipv6_neighbors("br0", log_level=logging.DEBUG)
print(neighbors)
```

## Requirements

* Python 3.7+
* `ip` command (from iproute2)
* `avahi-resolve-address` (part of `avahi-utils`)

## License

GNU 3.0 License
