bec/pxii_bec
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Init repo pxii_bec at template version v0.3.3

Browse Source
This commit is contained in:
perl_d
2025-05-07 14:34:14 +02:00
parent 15a9439b29
commit 08544f3f06
17 changed files with 261 additions and 177 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.copier-answers.yml
+10
View File
@@ -0,0 +1,10 @@
# Do not edit this file!
# It is needed to track the repo template version, and editing may break things.
# This file will be overwritten by copier on template updates.
_commit: v0.3.3
_src_path: https://gitea.psi.ch/bec/bec_plugin_copier_template.git
project_name: pxii_bec
widget_plugins_input:
- name: scan_history
use_ui: true
.gitlab-ci.yml
+1
View File
@@ -3,4 +3,5 @@ include:
inputs: inputs:
name: pxii_bec name: pxii_bec
target: pxii_bec target: pxii_bec
branch: $CHILD_PIPELINE_BRANCH
project: bec/awi_utils project: bec/awi_utils
LICENSE
+3 -2
View File
@@ -1,6 +1,7 @@
BSD 3-Clause License BSD 3-Clause License
Copyright (c) 2024, Paul Scherrer Institute Copyright (c) 2025, Paul Scherrer Institute
Redistribution and use in source and binary forms, with or without Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met: modification, are permitted provided that the following conditions are met:
@@ -25,4 +26,4 @@ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bin/.gitignore
+1
View File
@@ -0,0 +1 @@
# Add anything you don't want to check in to git, e.g. very large files
copier.yml
+84
View File
@@ -0,0 +1,84 @@
_exclude:
- ".gitea/"
- ".git/"
- "CHANGELOG.md"
# imports
_jinja_extensions:
- bec_lib.utils.copier_jinja_filters.CopierFilters
# predefined values
# make sure these have 'when: false' so that the questions are not asked and the items are not saved in answers.yml
test_directories:
type: str
multiselect: true
default: ["tests_bec_ipython_client", "tests_bec_widgets", "tests_dap_services", "tests_devices", "tests_file_writer", "tests_scans"]
when: false
copyright_year:
type: int
default: 2025
when: false
# questions
project_name:
type: str
help: What is your project name?
widget_plugins_input:
# Defines the list of plugin widgets, following:
# - name: widget name in snake case
# use_ui: whether to generate a .ui file
type: yaml
multiline: true
default: []
# derived from questions: single point of configuration for plugin class names etc.
widget_plugins:
type: yaml
multiline: true
default: >
{% if not widget_plugins_input %} []
{% else %}
{% for wp in widget_plugins_input %}
- module: {{ wp.name }} # Module name for the whole plugin
class: {{ wp.name | snake_to_pascal }} # Class name for the plugin widget
use_ui: {{ wp.use_ui }} # Whether to create a .ui file and import it
{% if wp.use_ui %}
ui_module: {{ wp.name }}_ui # Module name for the compiled python UI
ui_class: Ui_{{ wp.name | snake_to_pascal }} # Class name for the compiled python UI
{% endif %}
{% endfor %}
{% endif %}
when: false
# other configuration
ui_fileinfo: # would like to save this programatically when generated but don't see how
type: yaml
multiline: true
default: >
{% if not widget_plugins %} []
{% else %}
{% for wp in widget_plugins %}
{% if wp.use_ui %}
- ui_file: {{ project_name }}/bec_widgets/widgets/{{ wp.module }}/{{ wp.module }}.ui
out_file: {{ project_name }}/bec_widgets/widgets/{{ wp.module }}/{{ wp.ui_module }}.py
{% endif %}
{% endfor %}
{% endif %}
when: false
_tasks:
- "git init --initial-branch=main"
- >
{% if not ui_fileinfo %} echo "No .ui files to process"
{% else %}
{% for info in ui_fileinfo %}pyside6-uic {{ info.ui_file }} -o {{ info.out_file }};
{% endfor %}
{% endif %}
- "git add -A; git commit -a -m 'Init repo {{ project_name }} at template version {{ _commit }}'"
pxii_bec/bec_ipython_client/startup/pre_startup.py
+1 -8
View File
@@ -1,6 +1,6 @@
""" """
Pre-startup script for BEC client. This script is executed before the BEC client Pre-startup script for BEC client. This script is executed before the BEC client
is started. It can be used to add additional command line arguments. is started. It can be used to add additional command line arguments.
""" """
from bec_lib.service_config import ServiceConfig from bec_lib.service_config import ServiceConfig
@@ -14,10 +14,3 @@ def extend_command_line_args(parser):
# parser.add_argument("--session", help="Session name", type=str, default="cSAXS") # parser.add_argument("--session", help="Session name", type=str, default="cSAXS")
return parser return parser
# def get_config() -> ServiceConfig:
# """
# Create and return the service configuration.
# """
# return ServiceConfig(redis={"host": "localhost", "port": 6379})
pxii_bec/bec_widgets/widgets/scan_history/scan_history.ui
+5 -112
View File
@@ -1,115 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0"> <ui version="4.0">
<class>Form</class> <class>ScanHistory</class>
<widget class="QWidget" name="Form"> <widget class="QWidget" name="ScanHistory">
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>955</width>
<height>796</height>
</rect>
</property>
<property name="windowTitle">
<string>Form</string>
</property>
<layout class="QVBoxLayout" name="verticalLayout_2" stretch="9,3">
<item>
<widget class="Waveform" name="waveform">
<property name="sizePolicy">
<sizepolicy hsizetype="Preferred" vsizetype="Preferred">
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>0</width>
<height>0</height>
</size>
</property>
</widget> </widget>
</item> <resources />
<item> <connections />
<layout class="QHBoxLayout" name="horizontalLayout_2"> </ui>
<item>
<layout class="QVBoxLayout" name="verticalLayout">
<item>
<widget class="QLabel" name="monitor_label">
<property name="font">
<font/>
</property>
<property name="text">
<string>BPM Monitor</string>
</property>
</widget>
</item>
<item>
<widget class="DeviceComboBox" name="monitor_combobox"/>
</item>
<item>
<widget class="QLabel" name="history_label">
<property name="text">
<string>Scan History</string>
</property>
</widget>
</item>
<item>
<widget class="QSpinBox" name="history_spin_box"/>
</item>
<item>
<widget class="QPushButton" name="history_add">
<property name="text">
<string>Add scan</string>
</property>
</widget>
</item>
<item>
<widget class="QPushButton" name="history_clear">
<property name="text">
<string>clear all</string>
</property>
</widget>
</item>
</layout>
</item>
<item>
<widget class="TextBox" name="metadata_text_box">
<property name="sizePolicy">
<sizepolicy hsizetype="Preferred" vsizetype="MinimumExpanding">
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>795</width>
<height>191</height>
</size>
</property>
</widget>
</item>
</layout>
</item>
</layout>
</widget>
<customwidgets>
<customwidget>
<class>TextBox</class>
<extends>QWidget</extends>
<header>text_box</header>
</customwidget>
<customwidget>
<class>DeviceComboBox</class>
<extends>QComboBox</extends>
<header>device_combobox</header>
</customwidget>
<customwidget>
<class>Waveform</class>
<extends>QWidget</extends>
<header>waveform</header>
</customwidget>
</customwidgets>
<resources/>
<connections/>
</ui>
pxii_bec/bec_widgets/widgets/scan_history/scan_history_ui.py
+33
View File
@@ -0,0 +1,33 @@
# -*- coding: utf-8 -*-
################################################################################
## Form generated from reading UI file 'scan_history.ui'
##
## Created by: Qt User Interface Compiler version 6.8.2
##
## WARNING! All changes made in this file will be lost when recompiling UI file!
################################################################################
from PySide6.QtCore import (QCoreApplication, QDate, QDateTime, QLocale,
QMetaObject, QObject, QPoint, QRect,
QSize, QTime, QUrl, Qt)
from PySide6.QtGui import (QBrush, QColor, QConicalGradient, QCursor,
QFont, QFontDatabase, QGradient, QIcon,
QImage, QKeySequence, QLinearGradient, QPainter,
QPalette, QPixmap, QRadialGradient, QTransform)
from PySide6.QtWidgets import (QApplication, QSizePolicy, QWidget)
class Ui_ScanHistory(object):
def setupUi(self, ScanHistory):
if not ScanHistory.objectName():
ScanHistory.setObjectName(u"ScanHistory")
self.retranslateUi(ScanHistory)
QMetaObject.connectSlotsByName(ScanHistory)
# setupUi
def retranslateUi(self, ScanHistory):
pass
# retranslateUi
pxii_bec/scans/metadata_schema/metadata_schema_registry.py
+12
View File
@@ -0,0 +1,12 @@
# from .metadata_schema_template import ExampleSchema
METADATA_SCHEMA_REGISTRY = {
# Add models which should be used to validate scan metadata here.
# Make a model according to the template, and import it as above
# Then associate it with a scan like so:
# "example_scan": ExampleSchema
}
# Define a default schema type which should be used as the fallback for everything:
DEFAULT_SCHEMA = None
pxii_bec/scans/metadata_schema/metadata_schema_template.py
+34
View File
@@ -0,0 +1,34 @@
# # By inheriting from BasicScanMetadata you can define a schema by which metadata
# # supplied to a scan must be validated.
# # This schema is a Pydantic model: https://docs.pydantic.dev/latest/concepts/models/
# # but by default it will still allow you to add any arbitrary information to it.
# # That is to say, when you run a scan with which such a model has been associated in the
# # metadata_schema_registry, you can supply any python dictionary with strings as keys
# # and built-in python types (strings, integers, floats) as values, and these will be
# # added to the experiment metadata, but it *must* contain the keys and values of the
# # types defined in the schema class.
# #
# #
# # For example, say that you would like to enforce recording information about sample
# # pretreatment, you could define the following:
# #
#
# from bec_lib.metadata_schema import BasicScanMetadata
#
#
# class ExampleSchema(BasicScanMetadata):
# treatment_description: str
# treatment_temperature_k: int
#
#
# # If this was used according to the example in metadata_schema_registry.py,
# # then when calling the scan, the user would need to write something like:
# >>> scans.example_scan(
# >>> motor,
# >>> 1,
# >>> 2,
# >>> 3,
# >>> metadata={"treatment_description": "oven overnight", "treatment_temperature_k": 575},
# >>> )
#
# # And the additional metadata would be saved in the HDF5 file created for the scan.
pyproject.toml
+5 -1
View File
@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
[project] [project]
name = "pxii_bec" name = "pxii_bec"
version = "0.0.0" version = "0.0.0"
description = "Custom device implementations based on the ophyd hardware abstraction layer" description = "The PX-II plugin repository for BEC"
requires-python = ">=3.10" requires-python = ">=3.10"
classifiers = [ classifiers = [
"Development Status :: 3 - Alpha", "Development Status :: 3 - Alpha",
@@ -17,6 +17,7 @@ dependencies = ["pandas~=2.0", "matplotlib"]
[project.optional-dependencies] [project.optional-dependencies]
dev = [ dev = [
"black", "black",
"copier",
"isort", "isort",
"coverage", "coverage",
"pylint", "pylint",
@@ -38,6 +39,9 @@ plugin_file_writer = "pxii_bec.file_writer"
[project.entry-points."bec.scans"] [project.entry-points."bec.scans"]
plugin_scans = "pxii_bec.scans" plugin_scans = "pxii_bec.scans"
[project.entry-points."bec.scans.metadata_schema"]
plugin_metadata_schema = "pxii_bec.scans.metadata_schema"
[project.entry-points."bec.ipython_client_startup"] [project.entry-points."bec.ipython_client_startup"]
plugin_ipython_client_pre = "pxii_bec.bec_ipython_client.startup.pre_startup" plugin_ipython_client_pre = "pxii_bec.bec_ipython_client.startup.pre_startup"
plugin_ipython_client_post = "pxii_bec.bec_ipython_client.startup" plugin_ipython_client_post = "pxii_bec.bec_ipython_client.startup"
tests/tests_bec_ipython_client/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).
tests/tests_bec_widgets/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).
tests/tests_dap_services/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).
tests/tests_devices/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).
tests/tests_file_writer/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).
tests/tests_scans/README.md
+12 -9
View File
@@ -1,31 +1,34 @@
# Getting Started with Testing using pytest # Getting Started with Testing using pytest
BEC is using the [pytest](https://docs.pytest.org/en/8.0.x/) framework. BEC is using the [pytest](https://docs.pytest.org/en/latest/) framework.
It can be install via It can be installed via
``` bash
```bash
pip install pytest pip install pytest
``` ```
in your *python environment*.
in your _python environment_.
We note that pytest is part of the optional-dependencies `[dev]` of the plugin package. We note that pytest is part of the optional-dependencies `[dev]` of the plugin package.
## Introduction ## Introduction
Tests in this package should be stored in the `tests` directory. Tests in this package should be stored in the `tests` directory.
We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`. We suggest to sort tests of different submodules, i.e. `scans` or `devices` in the respective folder structure, and to folow a naming convention of `<test_module_name.py>`.
It is mandatory for test files to begin with `test_` for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command To run all tests, navigate to the directory of the plugin from the command line, and run the command
``` bash ```bash
pytest -v --random-order ./tests pytest -v --random-order ./tests
``` ```
Note, the python environment needs to be active. Note, the python environment needs to be active.
The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run. The additional arg `-v` allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines. The argument `--random-order` instructs pytest to run the tests in random order, which is the default in the CI pipelines.
## Test examples ## Test examples
Writing tests can be quite specific for the given function. Writing tests can be quite specific for the given function.
We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes.
A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html). A very useful class to enable isolated testing is [MagicMock](https://docs.python.org/3/library/unittest.mock.html).
In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html). In addition, we also recommend to take a look at the [How-to guides from pytest](https://docs.pytest.org/en/8.0.x/how-to/index.html).