VIP - Verified Installation of Posit

An open-source, extensible test suite that validates Posit Team deployments are installed correctly and functioning properly.

VIP uses BDD-style tests (pytest-bdd + Playwright) to verify Connect, Workbench, and Package Manager. Results are compiled into a Quarto report that can be published to a Connect server.

Quick start

git clone https://github.com/posit-dev/vip.git
cd vip
uv sync && uv run playwright install chromium

cp vip.toml.example vip.toml     # edit with your deployment details
uv run pytest                     # run all tests
uv run pytest -m connect          # run tests for a single product

Shiny app (graphical test runner)

VIP includes a Shiny for Python app that lets you select test categories, run tests, and view the report — all from a browser. This is especially convenient inside a Posit Workbench session (RStudio or Positron) where the app opens in the Viewer pane.

uv sync
uv run vip app

See the Shiny App guide for details.

Documentation

Guide	Description
Getting Started	Prerequisites, installation, and first run
Configuration	vip.toml settings and environment variables
Authentication	Password, LDAP, OIDC, and interactive auth flows
Deployment Verification	vip verify, cluster setup, and K8s integration
Test Categories	Test markers, version gating, and extensibility
Reporting	Generating and publishing the Quarto report
Shiny App	Graphical test runner for RStudio and Positron
Development	Dev setup, linting, formatting, and design principles

License

MIT — see LICENSE.