kismet-rest 2020.5.1

Simplified Python API for the Kismet REST interface

kismet_rest

Python wrapper for Kismet REST interface.

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

v2020.05.01

Changes

• Add support for datasource open/close [ohad83]

• Switch to itjson endpoints [Mike Kershaw / Dragorn]

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]