kismet_rest

Python wrapper for Kismet REST interface.

Documentation Status

Installing from PyPI

pip install kismet_rest

Installing from source

git clone https://github.com/kismetwireless/python-kismet-rest
cd python-kismet-rest && pip install .

Usage examples

Legacy functionality (KismetConnector):

import kismet_rest
conn = kismet_rest.KismetConnector(username="my_user", password="my_pass")
for device in conn.device_summary():
    pprint.pprint(device)

Alerts since 2019-01-01:

import kismet_rest
alerts = kismet_rest.Alerts()
for alert in alerts.all(ts_sec=1546300800):
    print(alert)

Devices last observed since 2019-01-01:

import kismet_rest
devices = kismet_rest.Devices()
for device in devices.all(ts=1546300800):
    print(device)

Developer notes:

  • Formatting commit messages: * Correctly-formatted commit messages will be organized in CHANGELOG.rst * Commit messages are formatted like this type: audience: message !tag * Type is for the type of change (new, chg) * Audience is for the audience of the commit note(usr,``test``,``doc``) * The message part is pretty self-explanatory. * The optional tag allows you to flag a commit for exclusion from CHANGELOG.rst.(minor or wip) * A commit message like this: new: usr: Made a new widget. will appear in CHANGELOG.rst, under the appropriate release, under the “New” section. * More info on message formatting: https://github.com/vaab/gitchangelog
  • Updating CHANGELOG.rst: * Install gitchangelog: pip3 install gitchangelog * Make sure that __version__ is correct in kismet_rest/__init__.py * Build the new changelog: gitchangelog > CHANGELOG.rst

Changelog

v2019.05.02

Changes

  • Support Python 3.5. [ashmastaflash]
  • Add MANIFEST.in. [ashmastaflash]

2019.05.01 (2019-05-20)

New

  • Refactor complete. [ashmastaflash]

    Closes #1

Changes

  • Add developer notes to README.rst. [ashmastaflash]
  • Add configs for gitchangelog and rtd. [ashmastaflash]

Other

  • Update docs. [Mike Kershaw / Dragorn]
  • Start extracting module. [Mike Kershaw / Dragorn]
  • Started repo. [Mike Kershaw / Dragorn]

Indices and tables