pip install cc-inspyTo check your install in command line run:
inspy --versionAnd as always you can get help:
inspy --helpTo interface an instrument using USB on Windows, install Keysight IO Libraries Suite.
If you are running InsPy on Linux and want to connect your device via USB, then you also have to do the following:
sudo tee /etc/udev/rules.d/99-inspy.rules > /dev/null <<'EOF'
SUBSYSTEM=="usb", ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="xxxx", MODE="0660", GROUP="plugdev"
EOF
sudo usermod -aG plugdev "$USER"
sudo udevadm control --reload-rules && sudo udevadm triggerThis is to make it so that inspy (and pyVISA) can see your USB device.
- Download the wheel from the InsPy Releases page.
pip install cc-inspy-*-py3-none-any.whl
Add 'inspy' to the list of dependencies, for example:
[project]
dependencies = [
"cc-inspy"
]
Add the following to your requirements.txt:
cc-inspy==1.0.0
(replace the version number with the desired version - versions can be identified via the tags)
- Add InsPy as a project dependency
uv add cc-inspy. - Run
uv syncto install all dependencies.
See below for information on how to setup a local development environment, contribute to the project, run tests, and build documentation.
To get setup using InsPy:
- Clone this repository:
git clone https://github.com/cambridgeconsultants/inspy.git - Navigate back to the inspy repo and install:
cd inspy
uv sync-
Reload your IDE (VSCode:
Ctrl+Shift+Pand enterDeveloper: Reload Window) (this may be required when you make changes to your editable) -
Check editable installed by entering the following terminal command - the inspy version should be returned:
uv run inspy --versionAnd you should see it auto complete will the modules in the package. If not, check the correct venv is selected (Ctrl+Shift+P Python: Select Interpreter)
To add instruments and develop on this project, please follow the instructions in CONTRIBUTING.md in the repository root.
We use pytest for writing and running tests. Tests should live in a separate file for each instrument, and separately from the development code.
Test files and test functions must start with the prefix test_, for
example test_oscilloscope_<model_no>.py, containing test_get_voltage.
Example:
# test_oscilloscope_<model_no>.py
def test_get_voltage():
"""Dummy test."""
assert True
You can run these tests using the commands:
uv run pytestto run all test files in the project (bear in mind many tests need real instruments to be connected so they may fail) - not recommended.uv run pytest test_file_name.pyto run all tests in a specific file. This can be run on multiple files in one line too.uv run pytest test_file_name.py::test_funcfor a specific test in that file.
When there's a commit to main signifying a release, a versioned tag will be added e.g., v2.0. The built package is then stored in the GitHub releases using the versioned release tag.
sphinx-build -b html ./docs ./docs/_build/html -W
You can then open _build/html/index.html in your browser. In windows you can run:
start docs/_build/html/index.html
Now you have installed InsPy, check out the quick start guide
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.