netenum 0.1.0

Efficient IP address enumerator that interpolates across IPv4 and IPv6 CIDR ranges

Netenum

Efficient IP address enumerator that interpolates across IPv4 and IPv6 CIDR ranges without expanding full ranges in memory.

Features

• Supports both IPv4 and IPv6 CIDR ranges
• Memory efficient - doesn't expand full ranges
• Intelligent partitioning based on network size
• Stripes across multiple networks for balanced enumeration
• Supports both synchronous and asynchronous iteration
• Command-line interface with stdin input

Installation

pip install netenum

Usage

Command Line

Enumerate addresses in sequence:

echo "192.168.1.0/24
10.0.0.0/8" | python -m netenum

Enumerate addresses in random order:

echo "192.168.1.0/24
10.0.0.0/8" | python -m netenum -r

You can also use a file:

cat cidrs.txt | python -m netenum

Python API

Synchronous Usage

from netenum import netenum

cidrs = [
    "192.168.0.0/16",          # IPv4
    "2001:db8::/32",           # IPv6
    "224.0.0.0/4",             # IPv4
]

for addr in netenum(cidrs):
    print(addr)

Asynchronous Usage

import asyncio
from netenum import aionetenum

cidrs = [
    "192.168.0.0/16",          # IPv4
    "2001:db8::/32",           # IPv6
    "224.0.0.0/4",             # IPv4
]

async def main():
    async for addr in await aionetenum(cidrs):
        print(addr)

asyncio.run(main())

Development

Install development dependencies:

pip install -e ".[dev]"

Run tests:

pytest

Format code:

black .
isort .

Type check:

mypy .