Skip to main content

spvirit-tools

Command-line tools for EPICS PVAccess, built on the pure-Rust spvirit stack. No EPICS base installation required.

Install

pip install spvirit-tools

The tools also arrive as a dependency of the Python bindings, so pip install spvirit puts all of them on your PATH as well.

With a Rust toolchain:

cargo install spvirit-tools

Tools

Thirteen binaries ship in the default build and the pip wheel (plus two packet-capture tools behind the scry feature, below). They are named sp* rather than pv* so they can sit alongside an EPICS Base installation without shadowing pvget, pvput, and friends.

Tool Kind What it does
spget client read a PV once
spput client write a PV
spmonitor client subscribe to changes
spinfo client print a PV's type structure
splist client discover servers and their PVs
spexplore client, TUI browse a server interactively
spsearch client, TUI passively watch PVA search traffic
spsine client drive a PV with a sine wave
spget_compare offline compare a captured GET exchange against spvirit's encoders
spserver server serve a .db file
sptable server, TUI an interactive spreadsheet IOC
spdodeca server serve a rotating wireframe as an image
spgateway client, server p4p-compatible PVAccess gateway

spload is an internal load driver used by the loadtest/ harness. It is not a user-facing tool and is not in the wheel or a default build (--features load builds it).

Each accepts --help.

Packet capture: spvirit-scry

Two more binaries, folded in from the former spvirit-scry crate, capture and decode live PVAccess traffic off a network interface:

Tool Kind What it does
spvirit-scry capture, TUI passively capture and decode PVA traffic
spvirit-scry_influx_collector capture the same capture, exported to InfluxDB and Loki

They are behind the optional scry feature and are not in the pip wheel or a default build, because they link against libpcap (Linux, libpcap-dev) or the Npcap SDK (Windows, found automatically or via NPCAP_SDK):

cargo install spvirit-tools --features scry

Capturing needs sudo/CAP_NET_RAW on Linux or administrator rights on Windows. The book's spvirit-scry chapter covers flags, source fingerprinting and the collector's configuration.

Documentation

The spvirit book covers the tools in detail, along with the client and server libraries. The root README is the shortest route in.

License

BSD-3-Clause.

Metadata

Release files for spvirit-tools 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spvirit-tools 0.4.0
File Size Uploaded Provenance
spvirit_tools-0.4.0.tar.gz 995.2 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for spvirit-tools 0.4.0
File
spvirit_tools-0.4.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
spvirit_tools-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
spvirit_tools-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
spvirit_tools-0.4.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
spvirit_tools-0.4.0-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details

Total release size: 67.4 MB

Release files / spvirit_tools-0.4.0.tar.gz

Download URL spvirit_tools-0.4.0.tar.gz
Size 995.2 kB
Tags Source
SHA-256 checksum
How to use checksums
498e1d7e69dec6f4dcd5ca2cd12e581bf2611e89b34b58832c3358d4850d4a54
BLAKE2b-256 checksum
How to use checksums
3e0b2435a8e361ef898ca569ce67b6870f89a443d36280affe1fc6b502d8cce9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / spvirit_tools-0.4.0-py3-none-win_amd64.whl

Download URL spvirit_tools-0.4.0-py3-none-win_amd64.whl
Size 11.0 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e80e17552471cfa13d4942c580dcd1ad0e2b3611186e77bf0a6f3c842a35f99a
BLAKE2b-256 checksum
How to use checksums
6e2f67b1fdbe70842dd6227acc26092575789acee3244cd3dfa284dd60284035
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / spvirit_tools-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL spvirit_tools-0.4.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 14.7 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
14cd1d55973b05c018d50b0b1ca8672052e071b5b7aa32fe52b7ff4b829331e2
BLAKE2b-256 checksum
How to use checksums
9142e9eef5475ad591e594f477732bfa1e732c8b5abd0cfdacff10b2e2604b3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / spvirit_tools-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL spvirit_tools-0.4.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 14.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
1d867e5c124319c88fb9f7174eb74d74b9b9d68ce099d5525f5260ac0cf8707e
BLAKE2b-256 checksum
How to use checksums
2ed089d36d0d123fd89ecb2144c552b81fbc08ed4893dbd9a0bcd5ea634388e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / spvirit_tools-0.4.0-py3-none-macosx_11_0_arm64.whl

Download URL spvirit_tools-0.4.0-py3-none-macosx_11_0_arm64.whl
Size 13.1 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
3da1bf91b7240f7a1e6ee4278f92c75a0228191b7f71443f8076a545d6b0309d
BLAKE2b-256 checksum
How to use checksums
2aef9585c2eb6f909b521edeadfa852bd24dc3f523557ddaef5de6b2a2baeacc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / spvirit_tools-0.4.0-py3-none-macosx_10_12_x86_64.whl

Download URL spvirit_tools-0.4.0-py3-none-macosx_10_12_x86_64.whl
Size 13.4 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
c6cb29952c205b138a0e1873ac770bcc8dc87bbd10f54703b1422a57860714e4
BLAKE2b-256 checksum
How to use checksums
f000e4c1d5b872a2a376a4a492e38884aea7b129ffe1506f7ae32eb150cd8c5d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Security for spvirit-tools 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for spvirit_tools-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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