Skip to content

Framework for hardware test fixtures and automatic test environments

License

Notifications You must be signed in to change notification settings

PyFixate/Fixate

Repository files navigation

Tests Docs

Fixate

Fixate is a Python library for testing real stuff. Fixate provides a framework for writing scripts in Python to test hardware. Providing drivers for equipment, support for switching, logging and a basic test runner UI. While Fixate is fairly simple, it is already being used to test real electronics products in real factories.

Getting Started

Fixate runs on Python 3.8 or greater.

Installing

Clone the repository using git or download a zip file and unzip the source. Then run setup.py to install. Alternatively, install from Pypi with 'pip install fixate'

Run the example scripts

There are a number of examples under the examples folder. You will need a clone fo the git repository to get the examples. For a minimal example try running tiny.py. For a more complicated example using multi-level tests, try running multi_level_design.py. The test runner is executed by calling the fixate package and passing in the test script to execute using the '-p' command line argument.

The following commands are for Windows:

git clone https://github.com/PyFixate/Fixate.git
cd Fixate
py -m venv .venv
.venv\Scripts\activate
py -m pip install .
py -m fixate -p examples\tiny.py

Make a script directly executable

For easier development, test scripts can be setup to call the fixate main as their own with some default parameters, as in:

python examples/tiny.py

Running the tests

In general, it is recommended to run the "core" set of tests. The "drivers" tests have a number of dependencies that are not required by default. Tests are run using pytest. The easiest way to run the test is using tox. To run the tests manually using pytest, excluding tests that required instruments, you can run pytest -m "not drivertest".

Check out the docs

https://fixate.readthedocs.io

Contributing

Contributions are welcome. Get in touch or create a new pull request.

Pull requests will need to pass code checks. You can run these most easily locally via pre-commit:

pip install pre-commit
pre-commit install --install-hooks 
pre-commit run --all-files # if not run before on your changes, otherwise leave off the flag

Authors

  • Ryan Parry-Jones - Original Developer - pazzarpj

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.txt file for details