pydase/src/pyDataService/components/number_slider.py
2023-08-02 12:06:22 +02:00

66 lines
1.8 KiB
Python

from typing import Any, Literal
from loguru import logger
from ..data_service.data_service import DataService
class NumberSlider(DataService):
"""
This class models a UI slider for a data service, allowing for adjustments of a
parameter within a specified range and increments.
Parameters:
-----------
value (float | int, optional):
The initial value of the slider. Defaults to 0.
min (int, optional):
The minimum value of the slider. Defaults to 0.
max (int, optional):
The maximum value of the slider. Defaults to 100.
step_size (float, optional):
The increment/decrement step size of the slider. Defaults to 1.0.
type (Literal["int"] | Literal["float"], optional):
The type of the slider value. Determines if the value is an integer or float.
Defaults to "float".
Example:
--------
```python
class MyService(DataService):
voltage = NumberSlider(1, 0, 10, 0.1, "int")
# Modifying or accessing the voltage value:
my_service = MyService()
my_service.voltage.value = 5
print(my_service.voltage.value) # Output: 5
```
"""
def __init__(
self,
value: float | int = 0,
min: int = 0,
max: int = 100,
step_size: float = 1.0,
type: Literal["int"] | Literal["float"] = "float",
) -> None:
self.min = min
self.max = max
self.step_size = step_size
if type not in {"float", "int"}:
logger.error(f"Unknown type '{type}'. Using 'float'.")
type = "float"
self._type = type
self.value = value
super().__init__()
def __setattr__(self, name: str, value: Any) -> None:
if name == "value":
value = int(value) if self._type == "int" else float(value)
return super().__setattr__(name, value)