Python LabVIEW File Parser
Project description
pylavi
Python LabVIEW VI file checker
Notice
This code is not endorsed, supported, or encouraged by National Instruments (NI). This is a clean-room examiniation of LabVIEW files and using information from pylabview by mefistotelis. There is no guarantee of this tool working as designed with any particular LabVIEW files. You should validate that this tool will work for your use case and re-verify with each new version of LabVIEW.
Description
This tool is designed to quickly validate large groups of VIs for common problems. This could be used in a Pull Request build to verify the LabVIEW files are saved in the correct version.
You could perform the same check using LabVIEW, but this tool can often verify thousands of files in the time it takes to launch LabVIEW (~1,200 files/second on an M2 macBook Pro while LabVIEW takes 1.8 seconds to launch and quit). For a Pull Request build, you want to make sure your builds are as short as possible, hence, this tool.
Validating VIs
Install
pip3 install pylavi
Validate VIs
vi_validate --path lv_source --no_beta --gt 21.0
This command will validate that all LabVIEW files in this directory (deep scan) were saved in a LabVIEW version greater than 21.0.0f0. If any VIs were saved in a previous version, it will print the path to the VI and return a non-zero exit code.
You can validate the following:
- version greater than, less than, or equal to a specific version (any part of the version not specified is assumed to be zero or f (final))
- version phase disallow VIs saved in developer, alpha, beta, or release version of LabVIEW.
- code disallow VIs with or without the
Separate compiled code from source file
setting (--no-code means only allow VIs with separated compiled code set) - breakpoints disallow VIs with breakpoints saved
- locked require all VIs to be locked (with or without a password) or not locked
- password require VIs to be locked with a password or not locked with a password or require the be locked with a specific password
- clear indicators require VIs be saved with the
Clear indiciators when called
or require they not be saved with this setting - run on open require VIs be saved with the
Run when opened
or require they not be saved with this setting - suspend on run require VIs be saved with the
Suspend when called
or require they not be saved with this setting - debuggable require VIs be saved with the
Allow debugging
or require they not be saved with this setting - autoerror require VIs have the
Enable automatic error handling
flag be turned off - path length require that the path to the VI (including the
--path
length) be less than the given length
If none of these are specified, then the following settings are defaulted: --no-beta
--no-alpha
--no-development
--no-invalid
--path-length 260
You may specify multiple --path
or --skip
. --path
will never override --skip
.
usage: vi_validate [-h] [-l LT] [-g GT] [-e EQ] [-r] [-b] [-a] [-d] [-i] [-c] [--code] [--breakpoints] [--locked]
[--not-locked] [--password-match PASSWORD_MATCH] [--password] [--no-password] [--clear-indicators]
[--no-clear-indicators] [--run-on-open] [--no-run-on-open] [--suspend-on-run] [--no-suspend-on-run]
[--debuggable] [--not-debuggable] [--autoerror] [--path-length PATH_LENGTH] [-p PATH] [-s SKIP]
[-x EXTENSION] [-q]
Validates LabVIEW resource files
optional arguments:
-h, --help show this help message and exit
-l LT, --lt LT LabVIEW version must be less than this
-g GT, --gt GT LabVIEW version must be greater than this
-e EQ, --eq EQ LabVIEW version must this
-r, --no-release LabVIEW version must not be release
-b, --no-beta LabVIEW version must not be beta
-a, --no-alpha LabVIEW version must not be alpha
-d, --no-development LabVIEW version must not be development
-i, --no-invalid LabVIEW version must be a valid phase
-c, --no-code Saved without code
--code Saved with code
--breakpoints Not saved with breakpoints
--locked File is locked (maybe with password)
--not-locked File is not locked
--password-match PASSWORD_MATCH
Ensure the password is exactly
--password File is locked with a password
--no-password File is not saved with a password
--clear-indicators VI will clear indicators on run
--no-clear-indicators
VI will not clear indicators on run
--run-on-open VI will run when opened
--no-run-on-open VI will not run when opened
--suspend-on-run VI will suspend on run
--no-suspend-on-run VI will not suspend on run
--debuggable VI is debuggable
--not-debuggable VI is not debuggable
--autoerror Not saved with auto error handling turned on
--path-length PATH_LENGTH
Maximum number of characters for the path
-p PATH, --path PATH Path to scan for files (or a file path) (defaults to current directory)
-s SKIP, --skip SKIP Path to not scan for files (or a file to ignore)
-x EXTENSION, --extension EXTENSION
File extensions to evaluate (defaults to all known)
-q, --quiet Reduce the output (multiple times reduces output more)
Credits
This project was inspired by pylabview by mefistotelis (which was originally forked from pylabview by jcreigh).
The idea was to reverse engineer the LabVIEW VI file format.
The pylavi
project is designed to be a reboot, taking the incredible discovery done by the pylabview
projects and simplifying the structure of the code.
This starts with a conceptual model of the LabVIEW resource file and treats the binary resources files as just collections of resources. Once the API for working with the file format itself is solidified, then code can be added to work with resources of specific types.
Along the way discoveries will be documented.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.