flexmeasures.api.common.schemas.sensors

Classes

class flexmeasures.api.common.schemas.sensors.SensorField(entity_type: str = 'sensor', fm_scheme: str = 'fm1', *args, **kwargs)

Field that de-serializes to a Sensor, and serializes a Sensor into an entity address (string).

__init__(entity_type: str = 'sensor', fm_scheme: str = 'fm1', *args, **kwargs)
Parameters:

  • entity_type – “sensor” (in the future, possibly also another type of resource that is assigned an entity address)

  • fm_scheme – “fm0” or “fm1”

_deserialize(value, attr, obj, **kwargs) → Sensor

De-serialize to a Sensor.

_serialize(value: Sensor, attr, data, **kwargs)

Serialize to an entity address.

class flexmeasures.api.common.schemas.sensors.SensorIdField(*, strict: bool = False, **kwargs)

Field that represents a sensor ID. It de-serializes from the sensor id to a sensor instance.

_deserialize(sensor_id: int, attr, obj, **kwargs) → Sensor

Deserialize value. Concrete Field classes should implement this method.

Parameters:

  • value – The value to be deserialized.

  • attr – The attribute/key in data to be deserialized.

  • data – The raw input data passed to the Schema.load.

  • kwargs – Field-specific keyword arguments.

Raises:

ValidationError – In case of formatting or validation failure.

Returns:

The deserialized value.

Changed in version 2.0.0: Added attr and data parameters.

Changed in version 3.0.0: Added **kwargs to signature.

_serialize(sensor: Sensor, attr, data, **kwargs) → int

Return a string if self.as_string=True, otherwise return this field’s num_type.

Exceptions

exception flexmeasures.api.common.schemas.sensors.EntityAddressValidationError(message: str | list | dict, field_name: str = '_schema', data: Mapping[str, Any] | Iterable[Mapping[str, Any]] | None = None, valid_data: list[dict[str, Any]] | dict[str, Any] | None = None, **kwargs)