Skip to content

pytest plugin for working with libiio contexts

License

Notifications You must be signed in to change notification settings

kimpaller/pytest-libiio

This branch is 94 commits behind tfcollins/pytest-libiio:master.

Folders and files

NameName
Last commit message
Last commit date
Oct 29, 2021
Oct 29, 2021
Nov 16, 2021
Oct 29, 2021
Oct 11, 2020
Sep 26, 2020
Sep 26, 2020
Sep 26, 2020
Oct 29, 2021
Jan 9, 2021
Sep 26, 2020
Oct 21, 2021
Aug 4, 2021
Nov 1, 2020
Sep 26, 2020
Oct 29, 2021
Oct 29, 2021

Repository files navigation

pytest-libiio

PyPI version Python versions See Build Status on Travis CI See Coverage Status on Coveralls Documentation Status

A pytest plugin to manage interfacing with libiio contexts


pytest-libiio is pytest plugin to manage interfacing with libiio contexts. This plugin is handy for leveraging the (new) zeroconf features of libiio to find, filter, and map libiio contexts to tests. It was created for pyadi-iio testing but is used in other applications that need an organized way to handle libiio contexts without hardcoding URIs or lots of boilerplate code.

Requirements

  • libiio and pylibiio
  • pytest
  • pyyaml

For development the following are also needed:

  • tox
  • pytest-mock
  • pre-commit
  • isort
  • flake8
  • codespell
  • black

Installation

You can install "pytest-libiio" via pip from PyPI:

$ pip install pytest-libiio

Usage

This plugin is used to make the access of libiio contexts easier and to provide a unified API through fixtures.

Accessing contexts

Get list of context descriptions of all found contained

import pytest
import iio


def test_libiio_device(context_desc):
    hardware = ["pluto", "adrv9361", "fmcomms2"]
    for ctx_desc in context_desc:
        if ctx_desc["hw"] in hardware:
            ctx = iio.Context(ctx_desc["uri"])
    if not ctx:
        pytest.skip("No required hardware found")

Require certain hardware through marks

import pytest
import iio


@pytest.mark.iio_hardware("adrv9361")
def test_libiio_device(context_desc):
    for ctx_desc in context_desc:
        ctx = iio.Context(ctx_desc["uri"])
        ...

Future ideas

Mock testing is common with libiio's python library since hardware is needed otherwise. In future releases we hope to extend features in pytest-mock through this plugin to make mocking libiio more streamlined.

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the BSD-3 license, "pytest-libiio" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

About

pytest plugin for working with libiio contexts

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 97.5%
  • Shell 2.5%