219 lines
7 KiB
Python
219 lines
7 KiB
Python
'''
|
|
Timezone data provider, guesses timezone based on location data (e.g. GPS)
|
|
'''
|
|
REQUIRES = [
|
|
# for determining timezone by coordinate
|
|
'timezonefinder',
|
|
]
|
|
|
|
|
|
from my.config import time
|
|
from my.core import dataclass
|
|
|
|
|
|
@dataclass
|
|
class config(time.tz.via_location):
|
|
# less precise, but faster
|
|
fast: bool = True
|
|
|
|
# if the accuracy for the location is more than 5km, don't use
|
|
require_accuracy: float = 5_000
|
|
|
|
|
|
from collections import Counter
|
|
from datetime import date, datetime
|
|
from functools import lru_cache
|
|
from itertools import groupby
|
|
from typing import Iterator, NamedTuple, Optional, Tuple, Any, List
|
|
|
|
from more_itertools import seekable
|
|
import pytz
|
|
|
|
from my.core.common import LazyLogger, mcachew, tzdatetime
|
|
|
|
logger = LazyLogger(__name__, level='warning')
|
|
|
|
@lru_cache(2)
|
|
def _timezone_finder(fast: bool) -> Any:
|
|
if fast:
|
|
# less precise, but faster
|
|
from timezonefinder import TimezoneFinderL as Finder # type: ignore
|
|
else:
|
|
from timezonefinder import TimezoneFinder as Finder # type: ignore
|
|
return Finder(in_memory=True)
|
|
|
|
|
|
# todo move to common?
|
|
Zone = str
|
|
|
|
|
|
# NOTE: for now only daily resolution is supported... later will implement something more efficient
|
|
class DayWithZone(NamedTuple):
|
|
day: date
|
|
zone: Zone
|
|
|
|
|
|
from my.location.common import LatLon
|
|
|
|
# for backwards compatibility
|
|
def _locations() -> Iterator[Tuple[LatLon, datetime]]:
|
|
try:
|
|
import my.location.all
|
|
for loc in my.location.all.locations():
|
|
if loc.accuracy is not None and loc.accuracy > config.require_accuracy:
|
|
continue
|
|
yield ((loc.lat, loc.lon), loc.dt)
|
|
|
|
except Exception as e:
|
|
from my.core.warnings import high
|
|
logger.exception("Could not setup via_location using my.location.all provider, falling back to legacy google implemetation", exc_info=e)
|
|
high("Setup my.google.takeout.parser, then my.location.all for better google takeout/location data")
|
|
|
|
import my.location.google
|
|
|
|
for gloc in my.location.google.locations():
|
|
yield ((gloc.lat, gloc.lon), gloc.dt)
|
|
|
|
# TODO: could use heapmerge or sort the underlying iterators somehow?
|
|
# see https://github.com/karlicoss/HPI/pull/237#discussion_r858372934
|
|
def _sorted_locations() -> List[Tuple[LatLon, datetime]]:
|
|
return list(sorted(_locations(), key=lambda x: x[1]))
|
|
|
|
|
|
# Note: this takes a while, as the upstream since _locations isn't sorted, so this
|
|
# has to do an iterative sort of the entire my.locations.all list
|
|
def _iter_local_dates() -> Iterator[DayWithZone]:
|
|
finder = _timezone_finder(fast=config.fast) # rely on the default
|
|
#pdt = None
|
|
# TODO: warnings doesnt actually warn?
|
|
warnings = []
|
|
# todo allow to skip if not noo many errors in row?
|
|
for (lat, lon), dt in _sorted_locations():
|
|
# TODO right. its _very_ slow...
|
|
zone = finder.timezone_at(lat=lat, lng=lon)
|
|
if zone is None:
|
|
warnings.append(f"Couldn't figure out tz for {lat}, {lon}")
|
|
continue
|
|
tz = pytz.timezone(zone)
|
|
# TODO this is probably a bit expensive... test & benchmark
|
|
ldt = dt.astimezone(tz)
|
|
ndate = ldt.date()
|
|
#if pdt is not None and ndate < pdt.date():
|
|
# # TODO for now just drop and collect the stats
|
|
# # I guess we'd have minor drops while air travel...
|
|
# warnings.append("local time goes backwards {ldt} ({tz}) < {pdt}")
|
|
# continue
|
|
#pdt = ldt
|
|
z = tz.zone; assert z is not None
|
|
yield DayWithZone(day=ndate, zone=z)
|
|
|
|
|
|
def most_common(lst: List[DayWithZone]) -> DayWithZone:
|
|
res, _ = Counter(lst).most_common(1)[0] # type: ignore[var-annotated]
|
|
return res
|
|
|
|
|
|
def _iter_tz_depends_on() -> str:
|
|
"""
|
|
Since you might get new data which specifies a new timezone sometime
|
|
in the day, this causes _iter_tzs to refresh every 6 hours, like:
|
|
2022-04-26_00
|
|
2022-04-26_06
|
|
2022-04-26_12
|
|
2022-04-26_18
|
|
"""
|
|
day = str(date.today())
|
|
hr = datetime.now().hour
|
|
hr_truncated = hr // 6 * 6
|
|
return "{}_{}".format(day, hr_truncated)
|
|
|
|
|
|
# refresh _iter_tzs every 6 hours -- don't think a better depends_on is possible dynamically
|
|
@mcachew(logger=logger, depends_on=_iter_tz_depends_on)
|
|
def _iter_tzs() -> Iterator[DayWithZone]:
|
|
# since we have no control over what order the locations are returned,
|
|
# we need to sort them first before we can do a groupby
|
|
local_dates: List[DayWithZone] = list(_iter_local_dates())
|
|
local_dates.sort(key=lambda p: p.day)
|
|
for d, gr in groupby(local_dates, key=lambda p: p.day):
|
|
logger.info('processed %s', d)
|
|
zone = most_common(list(gr)).zone
|
|
yield DayWithZone(day=d, zone=zone)
|
|
|
|
|
|
@lru_cache(1)
|
|
def loc_tz_getter() -> Iterator[DayWithZone]:
|
|
# seekable makes it cache the emitted values
|
|
return seekable(_iter_tzs())
|
|
|
|
|
|
# todo expose zone names too?
|
|
@lru_cache(maxsize=None)
|
|
def _get_day_tz(d: date) -> Optional[pytz.BaseTzInfo]:
|
|
sit = loc_tz_getter()
|
|
# todo hmm. seeking is not super efficient... might need to use some smarter dict-based cache
|
|
# hopefully, this method itself caches stuff forthe users, so won't be too bad
|
|
sit.seek(0) # type: ignore
|
|
|
|
zone: Optional[str] = None
|
|
for x, tz in sit:
|
|
if x == d:
|
|
zone = tz
|
|
if x >= d:
|
|
break
|
|
return None if zone is None else pytz.timezone(zone)
|
|
|
|
|
|
# ok to cache, there are only a few home locations?
|
|
@lru_cache(maxsize=None)
|
|
def _get_home_tz(loc) -> Optional[pytz.BaseTzInfo]:
|
|
(lat, lng) = loc
|
|
finder = _timezone_finder(fast=False) # ok to use slow here for better precision
|
|
zone = finder.timezone_at(lat=lat, lng=lng)
|
|
if zone is None:
|
|
# TODO shouldn't really happen, warn?
|
|
return None
|
|
else:
|
|
return pytz.timezone(zone)
|
|
|
|
|
|
def _get_tz(dt: datetime) -> Optional[pytz.BaseTzInfo]:
|
|
'''
|
|
Given a datetime, returns the timezone for that date.
|
|
'''
|
|
res = _get_day_tz(d=dt.date())
|
|
if res is not None:
|
|
return res
|
|
# fallback to home tz
|
|
from ...location import home
|
|
loc = home.get_location(dt)
|
|
return _get_home_tz(loc=loc)
|
|
|
|
# expose as 'public' function
|
|
get_tz = _get_tz
|
|
|
|
|
|
def localize(dt: datetime) -> tzdatetime:
|
|
tz = _get_tz(dt)
|
|
if tz is None:
|
|
# TODO -- this shouldn't really happen.. think about it carefully later
|
|
return dt
|
|
else:
|
|
return tz.localize(dt)
|
|
|
|
|
|
from ...core import stat, Stats
|
|
def stats() -> Stats:
|
|
# TODO not sure what would be a good stat() for this module...
|
|
# might be nice to print some actual timezones?
|
|
# there aren't really any great iterables to expose
|
|
import os
|
|
VIA_LOCATION_START_YEAR = int(os.environ.get("VIA_LOCATION_START_YEAR", 1990))
|
|
def localized_years():
|
|
last = datetime.now().year + 2
|
|
# note: deliberately take + 2 years, so the iterator exhausts. otherwise stuff might never get cached
|
|
# need to think about it...
|
|
for Y in range(VIA_LOCATION_START_YEAR, last):
|
|
dt = datetime.fromisoformat(f'{Y}-01-01 01:01:01')
|
|
yield localize(dt)
|
|
return stat(localized_years)
|