Skip to main content

A security telemetry engine for detection and response

Project description

VAST Python

The Python package of VAST provides a flexible control plane to integrate VAST with other security tools.

Note The Python effort is still highly experimental and subject to rapid change. Please do not consider it for production use.


To get started, clone the VAST repository and install the Python package via Poetry:

git clone
cd vast/python
poetry install


We recommend that you work with an editable installation, which is the default for poetry install.

Unit Tests

Run the unit tests via pytest:

poetry run pytest

Integration Tests

Run the integrations tests via Docker Compose and pytest:

./ pytest -v


The following instructions concern maintainers who want to publish the Python package to PyPI.

Note Our releasing scripts and CI run these steps automatically. You do not need to intervene anywhere. The instructions below merely document the steps taken.

Bump the version

Prior to releasing a new version, bump the version, e.g.:

poetry version 2.3.1

This updates the pyproject.toml file.

Publish to Test PyPI

  1. Add a Test PyPi repository:

    poetry config repositories.test-pypi
  2. Get the token from

  3. Store the token:

poetry config pypi-token.test-pypi pypi-XXXXXXXX
  1. Publish:

    poetry publish --build -r test-pypi

Publish to PyPI

  1. Get the token from

  2. Store the token:

poetry config pypi-token.pypi pypi-XXXXXXXX
  1. Publish

    poetry publish --build

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

pyvast-3.0.3.tar.gz (13.4 kB view hashes)

Uploaded Source

Built Distribution

pyvast-3.0.3-py3-none-any.whl (14.5 kB view hashes)

Uploaded Python 3

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