Skip to main content

A Dynamic test tool for Splunk Apps and Add-ons

Project description

PyPI version Python versions

A Dynamic test tool for Splunk Apps and Add-ons

Features

  • Generate tests for Splunk Knowledge objects in your Splunk Technology Add-ons

  • Validate your add-ons using Splunk + Docker and this test tool

Requirements

  • Docker or an external single instance Splunk deployment

Installation

You can install “pytest-splunk-addon” via pip from PyPI:

$ pip install pytest-splunk-addon

Developing

Note: Must install docker desktop, vscode or pycharm pro optional

Note2: Appinspect requires libmagic verify this has been installed correctly each time a new workstation/vm is used https://dev.splunk.com/enterprise/docs/releaseapps/appinspect/splunkappinspectclitool/installappinspect

$ #setup python venv must be 3.7 $ git clone –recurse-submodules -j8 git@github.com:splunk/pytest-splunk-addon.git

$ /Library/Frameworks/Python.framework/Versions/3.7/bin/python3 -m venv .venv

$ source .venv/bin/activate

$ pip3 install -r requirements_dev.txt

$ pip3 install https://download.splunk.com/misc/appinspect/splunk-appinspect-latest.tar.gz

$ python setup.py develop

Usage

Installation for external Splunk

pip install pytest-splunk-addon

Installation with built in docker orchestration

pip install pytest-splunk-addon[docker]

Basic project structure

The tool assumes the Splunk Add-on is located in a folder “package” in the project root

Triggering the tool:

Create a test file in the tests folder

from pytest_splunk_addon.standard_lib.addon_basic import Basic
    class Test_App(Basic):
        def empty_method():
            pass

Create a Dockerfile-splunk file

ARG SPLUNK_VERSION=latest
FROM splunk/splunk:$SPLUNK_VERSION
ARG SPLUNK_APP=TA_UNKNOWN
ARG SPLUNK_APP_PACKAGE=package
COPY deps/apps /opt/splunk/etc/apps/

COPY $SPLUNK_APP_PACKAGE /opt/splunk/etc/apps/$SPLUNK_APP

Create a docker-compose.yml update the value of SPLUNK_APP

version: "3.7"
services:
splunk:
    build:
    context: .
    dockerfile: Dockerfile-splunk
    args:
        - SPLUNK_APP=xxxxxxx
    ports:
    - "8000"
    - "8089"
    environment:
    - SPLUNK_PASSWORD=Changed@11
    - SPLUNK_START_ARGS=--accept-license

Run pytest with the add-on and SA-eventgen installed and enabled in an external Splunk deployment

Run pytest with the add-on and SA-eventgen installed and enabled in docker

Contributing

Contributions are very welcome. Tests can be run with pytest, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the Apache Software License 2.0 license, “pytest-splunk-addon” is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pytest-splunk-addon-1.2.3a10.tar.gz (155.7 kB view details)

Uploaded Source

Built Distribution

pytest_splunk_addon-1.2.3a10-py2.py3-none-any.whl (211.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pytest-splunk-addon-1.2.3a10.tar.gz.

File metadata

  • Download URL: pytest-splunk-addon-1.2.3a10.tar.gz
  • Upload date:
  • Size: 155.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.8.0 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for pytest-splunk-addon-1.2.3a10.tar.gz
Algorithm Hash digest
SHA256 05298b813680f9b8bd7d6d92fb1b8b682705bfcbc097198d03cf003e67633654
MD5 4463df235cf48c20680eca15fcb18976
BLAKE2b-256 b81d7b8c80d52c6d85fcaa681d419f6b529ed26fbe29e609754bc5acb5f03bb4

See more details on using hashes here.

File details

Details for the file pytest_splunk_addon-1.2.3a10-py2.py3-none-any.whl.

File metadata

  • Download URL: pytest_splunk_addon-1.2.3a10-py2.py3-none-any.whl
  • Upload date:
  • Size: 211.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.8.0 tqdm/4.48.0 CPython/3.7.8

File hashes

Hashes for pytest_splunk_addon-1.2.3a10-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 789c10c5efc133ad4679046a9a8d1e75ccbd1a552e3503922cfea2d3cbe06cb7
MD5 064b583f68213ca4ce105f3b75986c4b
BLAKE2b-256 f97741008f969d348a9c01056e13d7e0e570afb212ee98f57978e7b07d0f0e1a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page