# engine/_py_processors.py # Copyright (C) 2010-2024 the SQLAlchemy authors and contributors # # Copyright (C) 2010 Gaetan de Menten gdementen@gmail.com # # This module is part of SQLAlchemy and is released under # the MIT License: https://www.opensource.org/licenses/mit-license.php """defines generic type conversion functions, as used in bind and result processors. They all share one common characteristic: None is passed through unchanged. """ from __future__ import annotations import datetime from datetime import date as date_cls from datetime import datetime as datetime_cls from datetime import time as time_cls from decimal import Decimal import typing from typing import Any from typing import Callable from typing import Optional from typing import Type from typing import TypeVar from typing import Union _DT = TypeVar( "_DT", bound=Union[datetime.datetime, datetime.time, datetime.date] ) def str_to_datetime_processor_factory( regexp: typing.Pattern[str], type_: Callable[..., _DT] ) -> Callable[[Optional[str]], Optional[_DT]]: rmatch = regexp.match # Even on python2.6 datetime.strptime is both slower than this code # and it does not support microseconds. has_named_groups = bool(regexp.groupindex) def process(value: Optional[str]) -> Optional[_DT]: if value is None: return None else: try: m = rmatch(value) except TypeError as err: raise ValueError( "Couldn't parse %s string '%r' " "- value is not a string." % (type_.__name__, value) ) from err if m is None: raise ValueError( "Couldn't parse %s string: " "'%s'" % (type_.__name__, value) ) if has_named_groups: groups = m.groupdict(0) return type_( **dict( list( zip( iter(groups.keys()), list(map(int, iter(groups.values()))), ) ) ) ) else: return type_(*list(map(int, m.groups(0)))) return process def to_decimal_processor_factory( target_class: Type[Decimal], scale: int ) -> Callable[[Optional[float]], Optional[Decimal]]: fstring = "%%.%df" % scale def process(value: Optional[float]) -> Optional[Decimal]: if value is None: return None else: return target_class(fstring % value) return process def to_float(value: Optional[Union[int, float]]) -> Optional[float]: if value is None: return None else: return float(value) def to_str(value: Optional[Any]) -> Optional[str]: if value is None: return None else: return str(value) def int_to_boolean(value: Optional[int]) -> Optional[bool]: if value is None: return None else: return bool(value) def str_to_datetime(value: Optional[str]) -> Optional[datetime.datetime]: if value is not None: dt_value = datetime_cls.fromisoformat(value) else: dt_value = None return dt_value def str_to_time(value: Optional[str]) -> Optional[datetime.time]: if value is not None: dt_value = time_cls.fromisoformat(value) else: dt_value = None return dt_value def str_to_date(value: Optional[str]) -> Optional[datetime.date]: if value is not None: dt_value = date_cls.fromisoformat(value) else: dt_value = None return dt_value