PyPI CI Python

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 deployments. Results can be viewed from the command-line output or compiled into an HTML report.

Documentation: https://posit-dev.github.io/vip/

Quick start

uv tool install posit-vip
vip install
vip verify --connect-url https://connect.example.com --interactive-auth

Reproducible install

uv tool install posit-vip resolves the newest versions each release allows. To install the exact set a release was tested against, pass that release's constraints file (attached to every GitHub release as constraints-<version>.txt):

uv tool install posit-vip \
  -c https://github.com/posit-dev/vip/releases/download/vX.Y.Z/constraints-X.Y.Z.txt

Replace X.Y.Z with the release you are installing (see the releases page).

For a fully pinned, batteries-included environment, use the container image, which installs from the committed uv.lock:

docker run --rm -v "$PWD/vip.toml:/app/vip.toml" ghcr.io/posit-dev/vip:latest

On a headless server (no display), use --headless-auth instead:

vip verify --config vip.toml --headless-auth

Run a specific test by name:

vip verify --connect-url https://connect.example.com --filter test_login

With a configuration file:

cp vip.toml.example vip.toml     # edit with your deployment details
vip verify --config vip.toml

Fast confidence check — skip the detailed/long-running checks:

vip verify --config vip.toml --basic

Uninstalling

To reverse what vip install (or just setup) did:

vip uninstall        # dry run; prints the full plan including any sudo command
vip uninstall --yes  # remove Playwright cache + manifest; prints the sudo command
                     # for any system packages so you can remove them yourself

uv tool uninstall posit-vip  # remove vip itself once you're done

vip uninstall only removes packages and files that vip install recorded in .vip-install.json; anything that was already on your machine before running vip install is left alone.

If a Connect URL is configured (in vip.toml or via --connect-url), vip uninstall chains vip cleanup first to remove _vip_test-tagged content from Connect.

CLI commands

Command Description
vip verify Run verification tests against a Posit Team deployment
vip status Quick health check for each configured product
vip cleanup Delete VIP _vip_test content from Connect
vip report Render the HTML report from test results (requires Quarto CLI)
vip auth Authentication tools (e.g. mint Connect API keys)
vip version Print the vip version and the minimum supported Posit Team version
vip --version Print the installed vip version

Run vip --help or vip <command> --help for full usage details.

CI / pipeline integration

VIP emits machine-readable output for security-ops and CI/CD pipelines.

vip verify always writes report/results.json (and report/failures.json on failures). Add JUnit XML and/or SARIF with --format:

vip verify --format json,junit,sarif
# report/results.json   (always)
# report/junit.xml       (--format junit)  -> CI test dashboards
# report/results.sarif   (--format sarif)  -> GitHub code scanning / secops

The --ci preset bundles all three formats with concise tracebacks (--tb=short) and overrides --format if both are given. Run it without --interactive-auth/ --headless-auth -- combining them is an error, since --ci is meant for non-interactive pipelines:

vip verify --ci

Container

An official image is published to ghcr.io/posit-dev/vip. The entrypoint is the vip CLI; the default subcommand is verify. Because docker run args replace the default command (they do not append to it), name the verify subcommand explicitly when passing verify flags:

# bare invocation runs `vip verify`:
docker run --rm -v "$PWD/vip.toml:/app/vip.toml" ghcr.io/posit-dev/vip
# CI preset (name the subcommand so args don't replace it):
docker run --rm -v "$PWD/vip.toml:/app/vip.toml" ghcr.io/posit-dev/vip verify --ci
# other subcommands are reachable too:
docker run --rm -v "$PWD/vip.toml:/app/vip.toml" ghcr.io/posit-dev/vip status --json

Development

See docs/development.md for dev setup, linting, and formatting.

For the test architecture and four-layer design, see docs/test-architecture.md.

License

MIT — see LICENSE.

Project links

Data verified by PyPI on Jul 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2026.8.3)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for ian-flores-siaca from gravatar.com ian-flores-siaca Avatar for statik from gravatar.com statik

Credits

Author: Elliot Murphy

GitHub Statistics

Data verified by PyPI on Jul 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

dev load report

Classifiers

Report project as malware

Download files

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

Source Distribution

posit_vip-0.58.6.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

posit_vip-0.58.6-py3-none-any.whl (367.7 kB view details)

Uploaded Python 3

File details

Details for the file posit_vip-0.58.6.tar.gz.

File metadata

  • Download URL: posit_vip-0.58.6.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for posit_vip-0.58.6.tar.gz
Algorithm Hash digest
SHA256 2d08aaac3ceeca9febc21e1907f2c8d65b9cd3f0e9e081f2eb769f1637a36eee
MD5 355ce31b89702abcdfde7449b50f45fe
BLAKE2b-256 189cfd94c6159fb1178e209e599f0e95b22459a0edb95c0da07f6de44294f4cc

See more details on using hashes here.

Provenance

The following attestation bundles were made for posit_vip-0.58.6.tar.gz:

Publisher: publish.yml on posit-dev/vip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file posit_vip-0.58.6-py3-none-any.whl.

File metadata

  • Download URL: posit_vip-0.58.6-py3-none-any.whl
  • Upload date:
  • Size: 367.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for posit_vip-0.58.6-py3-none-any.whl
Algorithm Hash digest
SHA256 bd5a60cbe32d1614835ae9d8a32e7e8763d789efa9ab10c6b8ef6e0e2a1abfb7
MD5 64e2d317d4420a9035e1ee81b0570e53
BLAKE2b-256 9e805087af3d8162eaf642f67e2f41566c9456d54c2576200857107770fc47e3

See more details on using hashes here.

Provenance

The following attestation bundles were made for posit_vip-0.58.6-py3-none-any.whl:

Publisher: publish.yml on posit-dev/vip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2026.8.3

2 files

2026.8.2

2 files

2026.8.1

2 files

2026.8.0

2 files

2026.7.0

2 files

0.58.18

2 files

0.58.17

2 files

0.58.16

2 files

0.58.15

2 files

0.58.14

2 files

0.58.13

2 files

0.58.12

2 files

0.58.11

2 files

0.58.10

2 files

0.58.9

2 files

0.58.8

2 files

0.58.7

2 files

This release

0.58.6 This release

2 files

0.58.5

2 files

0.58.4

2 files

0.58.3

2 files

0.58.2

2 files

0.58.1

2 files

0.58.0

2 files

0.57.1

2 files

0.57.0

2 files

0.56.0

2 files

0.55.3

2 files

0.55.2

2 files

0.55.1

2 files

0.55.0

2 files

0.54.8

2 files

0.54.7

2 files

0.54.6

2 files

0.54.5

2 files

0.54.4

2 files

0.54.3

2 files

0.54.2

2 files

0.54.1

2 files

0.54.0

2 files

0.53.1

2 files

0.53.0

2 files

0.52.4

2 files

0.52.3

2 files

0.52.2

2 files

0.52.1

2 files

0.52.0

2 files

0.51.0

2 files

0.50.1

2 files

0.50.0

2 files

0.49.2

2 files

0.49.1

2 files

0.49.0

2 files

0.48.3

2 files

0.48.2

2 files

0.48.1

2 files

0.48.0

2 files

0.47.0

2 files

0.46.3

2 files

0.46.2

2 files

0.46.1

2 files

0.46.0

2 files

0.45.0

2 files

0.44.0

2 files

0.43.0

2 files

0.42.0

2 files

0.41.3

2 files

0.41.2

2 files

0.41.1

2 files

0.41.0

2 files

0.40.0

2 files

0.39.1

2 files

0.39.0

2 files

0.38.0

2 files

0.37.0

2 files

0.36.7

2 files

0.36.6

2 files

0.36.5

2 files

0.36.4

2 files

0.36.3

2 files

0.36.2

2 files

0.36.1

2 files

0.36.0

2 files

0.35.2

2 files

0.35.1

2 files

0.35.0

2 files

0.34.1

2 files

0.34.0

2 files

0.33.1

2 files

0.33.0

2 files

0.32.1

2 files

0.32.0

2 files

0.31.2

2 files

0.31.1

2 files

0.31.0

2 files

0.30.1

2 files

0.30.0

2 files

0.29.1

2 files

0.29.0

2 files

0.28.0

2 files

0.27.0

2 files

0.26.8

2 files

0.26.7

2 files

0.26.6

2 files

0.26.5

2 files

0.26.4

2 files

0.26.3

2 files

0.26.2

2 files

0.26.0

2 files

0.25.0

2 files

0.24.10

2 files

0.24.9

2 files

0.24.8

2 files

0.24.7

2 files

0.24.6

2 files

0.24.5

2 files

0.24.4

2 files

0.24.3

2 files

0.24.2

2 files

0.24.1

2 files

0.24.0

2 files

0.23.0

2 files

0.22.0

2 files

0.21.1

2 files

0.21.0

2 files

0.20.1

2 files

0.20.0

2 files

0.19.1

2 files

0.19.0

2 files

0.18.0

2 files

0.17.0

2 files

0.16.0

2 files

0.15.0

2 files

0.14.0

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.2

2 files

0.12.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page