Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Python API for Kvasir

Project description

Python API to communicate with Kvasir.

At this time only the JSONRPC API is supported. RESTful API is in progress.

Features

  • Allows for third-party tools to communicate with multiple Kvasir instances
  • Builds content which can be used for reporting
  • Extend python scripts to access or update Kvasir data

Installation

Install using PIP:

$ pip install KvasirAPI

Or use the bleeding edge from github:

$ git clone https://github.com/KvasirSecurity/kvasirapi-python
$ cd kvasirapi-python
$ python setup.py install

Usage

  • Create a YAML configuration file:

    customer:
      id: 11-ACME-01
      full-name: ACME Widgets, Inc.
      short-name: ACME
      possessive: ACME Widget, Inc's
      short-capital: ACME
      possessive-capital: ACME's
    
    instances:
      test:
        url: "http://test:test@localhost:8000/kvasir/"
        name: Test Network
        test_type: internal
        start: May 2, 2011
        end: May 6, 2011
    
  • Load the API module:

    $ python
    >>> import KvasirAPI
    >>> kvasir = KvasirAPI.API('config.yml')
    
  • Access the API functions:

    >>> kvasir.configuration.customer_info()
    {'short-name': 'ACME', 'possessive': "ACME Widget, Inc's", 'full-name': 'ACME Widgets, Inc.',
     'short-capital': 'ACME', 'id': '11-ACME-01', 'possessive-capital': "ACME's"}
    >>> kvasir.configuration.instances()
    {'test': {'end': 'May 6, 2011', 'name': 'Test Network', 'url': 'http://test:test@localhost:8000/kvasir/',
     'test_type': 'internal', 'hostfilter': {}, 'start': 'May 2, 2011'}}
    >>> kvasir.call.test.hosts.list()
    

Contributing

  1. Fork the repository on Github
  2. Make a branch off of master and commit your changes to it.
  3. Ensure that your name is added to the end of the AUTHORS file using the format Name <email@domain.com> (url), where the (url) portion is optional.
  4. Submit a Pull Request to the master branch on GitHub.

Project details


Release history Release notifications

This version
History Node

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
KvasirAPI-1.0.0.tar.gz (10.8 kB) Copy SHA256 hash SHA256 Source None Aug 17, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page