# -*- coding: utf-8 -*-
"""Common routines for data in glucometers."""
__author__ = 'Diego Elio Pettenò'
__email__ = 'flameeyes@flameeyes.eu'
__copyright__ = 'Copyright © 2013, Diego Elio Pettenò'
__license__ = 'MIT'
import collections
import enum
import textwrap
import attr
from glucometerutils import exceptions
class Unit(enum.Enum):
MG_DL = 'mg/dL'
MMOL_L = 'mmol/L'
# Constants for meal information
class Meal(enum.Enum):
NONE = ''
BEFORE = 'Before Meal'
AFTER = 'After Meal'
# Constants for measure method
class MeasurementMethod(enum.Enum):
BLOOD_SAMPLE = 'blood sample'
CGM = 'CGM' # Continuous Glucose Monitoring
def convert_glucose_unit(value, from_unit, to_unit):
"""Convert the given value of glucose level between units.
Args:
value: The value of glucose in the current unit
from_unit: The unit value is currently expressed in
to_unit: The unit to conver the value to: the other if empty.
Returns:
The converted representation of the blood glucose level.
"""
from_unit = Unit(from_unit)
to_unit = Unit(to_unit)
if from_unit == to_unit:
return value
if from_unit == Unit.MG_DL:
return round(value / 18.0, 2)
else:
return round(value * 18.0, 0)
_ReadingBase = collections.namedtuple(
'_ReadingBase', ['timestamp', 'value', 'comment', 'measure_method'])
class GlucoseReading(_ReadingBase):
def __new__(cls, timestamp, value, meal=Meal.NONE, comment='',
measure_method=MeasurementMethod.BLOOD_SAMPLE):
"""Constructor for the glucose reading object.
Args:
timestamp: (datetime) Timestamp of the reading as reported by the meter.
value: (float) Value of the reading, in mg/dL.
meal: (string) Meal-relativeness as reported by the reader, if any.
comment: (string) Comment reported by the reader, if any.
measure_method: (string) Measure method as reported by the reader if any,
assuming blood sample otherwise.
The value is stored in mg/dL, even though this is not the standard value,
because at least most of the LifeScan devices report the raw data in this
format.
"""
instance = super(GlucoseReading, cls).__new__(
cls, timestamp=timestamp, value=value, comment=comment,
measure_method=measure_method)
setattr(instance, 'meal', meal)
return instance
def get_value_as(self, to_unit):
"""Returns the reading value as the given unit.
Args:
to_unit: (Unit) The unit to return the value to.
"""
return convert_glucose_unit(self.value, Unit.MG_DL, to_unit)
def as_csv(self, unit):
"""Returns the reading as a formatted comma-separated value string."""
return '"%s","%.2f","%s","%s","%s"' % (
self.timestamp, self.get_value_as(unit), self.meal.value,
self.measure_method.value, self.comment)
class KetoneReading(_ReadingBase):
def __new__(cls, timestamp, value, comment='', **kwargs):
"""Constructor for the ketone reading object.
Args:
timestamp: (datetime) Timestamp of the reading as reported by the meter.
value: (float) Value of the reading, in mmol/L.
comment: (string) Comment reported by the reader, if any.
The value is stored in mg/dL, even though this is not the standard value,
because at least most of the LifeScan devices report the raw data in this
format.
"""
return super(KetoneReading, cls).__new__(
cls, timestamp=timestamp, value=value, comment=comment,
measure_method=MeasurementMethod.BLOOD_SAMPLE)
def get_value_as(self, *args):
"""Returns the reading value in mmol/L."""
return self.value
def as_csv(self, unit):
"""Returns the reading as a formatted comma-separated value string."""
return '"%s","%.2f","%s","%s"' % (
self.timestamp, self.get_value_as(unit), self.measure_method.value,
self.comment)
@attr.s
class MeterInfo:
"""General information aobut the meter, such as model, serial number and unit.
Attributes:
model: Human readable model name, chosen by the driver.
serial_number: Serial number identified for the reader (or N/A if not
available in the protocol.)
version_info: List of strings with any version information available about
the device. It can include hardware and software version.
native_unite: One of the Unit values to identify the meter native unit.
"""
model = attr.ib()
serial_number = attr.ib(default='N/A')
version_info = attr.ib(default=())
native_unit = attr.ib(default=Unit.MG_DL, validator=attr.validators.in_(Unit))
def __str__(self):
version_information_string = 'N/A'
if self.version_info:
version_information_string = '\n '.join(self.version_info).strip()
return textwrap.dedent("""\
{model}
Serial Number: {serial_number}
Version Information:
{version_information_string}
Native Unit: {native_unit}
""").format(model=self.model, serial_number=self.serial_number,
version_information_string=version_information_string,
native_unit=self.native_unit.value)
