pyrcrack 1.0.1

Pythonic aircrack-ng bindings

pyrcrack

Python aircrack-ng bindings

PyrCrack is a Python API exposing a common aircrack-ng API. As AircrackNg will run in background processes, and produce parseable output both in files and stdout, the most pythonical approach are context managers, cleaning up after

Installation

This library is available on Pypi, you can install it directly with pip:

pip install pycrack

Usage

This library exports a basic aircrack-ng API aiming to keep always a small readable codebase.

This has led to a simple library that executes each of the aircrack-ng’s suite commands and auto-detects its usage instructions. Based on that, it dinamically builds classes inheriting that usage as docstring and a run() method that accepts keyword parameters and arguments, and checks them BEFORE trying to run them.

You can find some example usages in examples/ directory:

async with pyrcrack.AircrackNg() as pcrack:
    await pcrack.run(sys.argv[1])
    # This also sets pcrack.proc as the running
    # process, wich is a `Process` instance.

    # get_result() is specific of AircrackNg class.
    print(await pcrack.get_result())

# This will create temporary files needed, and
# cleanup process after if required.

There are some syntactic sugar methods, like “result_updater” on pyrcrack class.

The following example will automatically keep updating, for 10 seconds, a meta[“results”] property on pdump:

import pyrcrack
import sys
import asyncio
from async_timeout import timeout

async def test(max_timeout):
    async with pyrcrack.AirodumpNg() as pdump:
        with suppress(asyncio.TimeoutError):
            async with timeout(max_timeout):
                await pdump.run(sys.argv[1])
                while True:
                    await asyncio.sleep(1)
                    print(pdump.meta)
        return await pdump.proc.terminate()


asyncio.run(test(10))

You can also list all available airmon interfaces, like so:

async with pyrcrack.AirmonZc() as airmon:
    print(await airmon.list_wifis())

This will return a nice dict with all information as is returned by airmon-zc