485 lines
17 KiB
Python
485 lines
17 KiB
Python
"""Identify busy events and gaps when nothing is scheduled."""
|
|
|
|
import itertools
|
|
import typing
|
|
from datetime import date, datetime, timedelta
|
|
|
|
import flask
|
|
import pycountry
|
|
|
|
from . import events_yaml, get_country, travel
|
|
from .event import Event
|
|
from .types import StrDict, Trip
|
|
|
|
NEARBY_BALKAN_COUNTRIES = {
|
|
"GR",
|
|
"AL",
|
|
"XK",
|
|
"HR",
|
|
"SI",
|
|
"MK",
|
|
"BA",
|
|
"ME",
|
|
"RS",
|
|
"BG",
|
|
"RO",
|
|
}
|
|
|
|
|
|
def busy_event(e: Event) -> bool:
|
|
"""Busy."""
|
|
if e.name not in {
|
|
"event",
|
|
"accommodation",
|
|
"conference",
|
|
"transport",
|
|
"meetup",
|
|
"party",
|
|
"trip",
|
|
"hackathon",
|
|
}:
|
|
return False
|
|
|
|
if e.title in ("IA UK board meeting", "Mill Road Winter Fair"):
|
|
return False
|
|
|
|
if e.name == "conference" and not e.going:
|
|
return False
|
|
if not e.title:
|
|
return True
|
|
if e.title == "LHG Run Club" or "Third Thursday Social" in e.title:
|
|
return False
|
|
|
|
lc_title = e.title.lower()
|
|
return (
|
|
"rebels" not in lc_title
|
|
and "south west data social" not in lc_title
|
|
and "dorkbot" not in lc_title
|
|
)
|
|
|
|
|
|
def get_busy_events(
|
|
start: date, config: flask.config.Config, trips: list[Trip]
|
|
) -> list[Event]:
|
|
"""Find busy events from a year ago to two years in the future."""
|
|
last_year = start - timedelta(days=365)
|
|
next_year = start + timedelta(days=2 * 365)
|
|
|
|
my_data = config["PERSONAL_DATA"]
|
|
events = events_yaml.read(my_data, last_year, next_year, skip_trips=True)
|
|
|
|
for trip in trips:
|
|
event_type = "trip"
|
|
if trip.events and not trip.conferences:
|
|
event_type = trip.events[0]["name"]
|
|
elif len(trip.conferences) == 1 and trip.conferences[0].get("hackathon"):
|
|
event_type = "hackathon"
|
|
events.append(
|
|
Event(
|
|
name=event_type,
|
|
title=trip.title + " " + trip.country_flags,
|
|
date=trip.start,
|
|
end_date=trip.end,
|
|
url=flask.url_for("trip_page", start=trip.start.isoformat()),
|
|
)
|
|
)
|
|
|
|
busy_events = [
|
|
e
|
|
for e in sorted(events, key=lambda e: e.as_date)
|
|
if (e.as_date >= start or (e.end_date and e.end_as_date >= start))
|
|
and e.as_date < next_year
|
|
and busy_event(e)
|
|
]
|
|
|
|
return busy_events
|
|
|
|
|
|
def _parse_datetime_field(datetime_obj: datetime | date) -> tuple[datetime, date]:
|
|
"""Parse a datetime field that could be datetime object or string."""
|
|
if hasattr(datetime_obj, "date"):
|
|
return datetime_obj, datetime_obj.date()
|
|
elif isinstance(datetime_obj, str):
|
|
dt = datetime.fromisoformat(datetime_obj.replace("Z", "+00:00"))
|
|
return dt, dt.date()
|
|
else:
|
|
raise ValueError(f"Invalid datetime format: {datetime_obj}")
|
|
|
|
|
|
def _get_airport_location(
|
|
airport_code: str, airports: StrDict, uk_airports: set[str], on_trip: bool = False
|
|
) -> tuple[str | None, pycountry.db.Country | None]:
|
|
"""Get location from airport code."""
|
|
if airport_code in uk_airports:
|
|
if on_trip:
|
|
# When on a trip, show the actual location even for UK airports
|
|
airport_info = airports.get(airport_code)
|
|
if airport_info:
|
|
location_name = airport_info.get(
|
|
"city", airport_info.get("name", "London")
|
|
)
|
|
return (location_name, get_country("gb"))
|
|
else:
|
|
return ("London", get_country("gb"))
|
|
else:
|
|
# When not on a trip, UK airports mean home
|
|
return (None, get_country("gb"))
|
|
else:
|
|
# Non-UK airports
|
|
airport_info = airports.get(airport_code)
|
|
if airport_info:
|
|
location_name = airport_info.get(
|
|
"city", airport_info.get("name", airport_code)
|
|
)
|
|
return (location_name, get_country(airport_info.get("country", "gb")))
|
|
else:
|
|
return (airport_code, get_country("gb"))
|
|
|
|
|
|
def _get_accommodation_location(
|
|
acc: StrDict, on_trip: bool = False
|
|
) -> tuple[str | None, pycountry.db.Country | None]:
|
|
"""Get location from accommodation data."""
|
|
if acc.get("country") == "gb":
|
|
if on_trip:
|
|
# When on a trip, show the actual location even for UK accommodations
|
|
return (acc.get("location", "London"), get_country("gb"))
|
|
else:
|
|
# When not on a trip, UK accommodation means home
|
|
return (None, get_country("gb"))
|
|
else:
|
|
return (acc.get("location", "Unknown"), get_country(acc.get("country", "gb")))
|
|
|
|
|
|
def _find_most_recent_travel_within_trip(
|
|
trip: Trip,
|
|
target_date: date,
|
|
bookings: list[StrDict],
|
|
accommodations: list[StrDict],
|
|
airports: StrDict,
|
|
) -> tuple[str | None, pycountry.db.Country | None] | None:
|
|
"""Find the most recent travel location within a trip."""
|
|
uk_airports = {"LHR", "LGW", "STN", "LTN", "BRS", "BHX", "MAN", "EDI", "GLA"}
|
|
|
|
trip_most_recent_date = None
|
|
trip_most_recent_location = None
|
|
trip_most_recent_datetime = None
|
|
|
|
# Check flights within trip period
|
|
for booking in bookings:
|
|
for flight in booking.get("flights", []):
|
|
if "arrive" in flight:
|
|
try:
|
|
arrive_datetime, arrive_date = _parse_datetime_field(
|
|
flight["arrive"]
|
|
)
|
|
except ValueError:
|
|
continue
|
|
|
|
# Only consider flights within this trip and before target date
|
|
if trip.start <= arrive_date <= target_date:
|
|
# Compare both date and time to handle same-day flights correctly
|
|
if (
|
|
trip_most_recent_date is None
|
|
or arrive_date > trip_most_recent_date
|
|
or (
|
|
arrive_date == trip_most_recent_date
|
|
and (
|
|
trip_most_recent_datetime is None
|
|
or arrive_datetime > trip_most_recent_datetime
|
|
)
|
|
)
|
|
):
|
|
trip_most_recent_date = arrive_date
|
|
trip_most_recent_datetime = arrive_datetime
|
|
destination_airport = flight["to"]
|
|
trip_most_recent_location = _get_airport_location(
|
|
destination_airport, airports, uk_airports, on_trip=True
|
|
)
|
|
|
|
# Check accommodations within trip period
|
|
for acc in accommodations:
|
|
if "from" in acc:
|
|
try:
|
|
_, acc_date = _parse_datetime_field(acc["from"])
|
|
except ValueError:
|
|
continue
|
|
|
|
# Only consider accommodations within this trip and before/on target date
|
|
if trip.start <= acc_date <= target_date:
|
|
# Accommodation takes precedence over flights on the same date
|
|
# or if it's genuinely more recent
|
|
if (
|
|
trip_most_recent_date is None
|
|
or acc_date > trip_most_recent_date
|
|
or acc_date == trip_most_recent_date
|
|
):
|
|
trip_most_recent_date = acc_date
|
|
trip_most_recent_location = _get_accommodation_location(
|
|
acc, on_trip=True
|
|
)
|
|
|
|
return trip_most_recent_location
|
|
|
|
|
|
def _get_trip_location_by_progression(
|
|
trip: Trip, target_date: date
|
|
) -> tuple[str | None, pycountry.db.Country | None] | None:
|
|
"""Determine location based on trip progression and date."""
|
|
locations = trip.locations()
|
|
if not locations:
|
|
return None
|
|
|
|
# If only one location, use it (when on a trip, always show the location)
|
|
if len(locations) == 1:
|
|
city, country = locations[0]
|
|
return (city, country)
|
|
|
|
# Multiple locations: use progression through the trip
|
|
trip_duration = (trip.end - trip.start).days + 1
|
|
days_into_trip = (target_date - trip.start).days
|
|
|
|
# Simple progression: first half at first location, second half at last location
|
|
if days_into_trip <= trip_duration // 2:
|
|
city, country = locations[0]
|
|
else:
|
|
city, country = locations[-1]
|
|
|
|
return (city, country)
|
|
|
|
|
|
def _find_most_recent_travel_before_date(
|
|
target_date: date,
|
|
bookings: list[StrDict],
|
|
accommodations: list[StrDict],
|
|
airports: StrDict,
|
|
) -> tuple[str | None, pycountry.db.Country | None] | None:
|
|
"""Find the most recent travel location before a given date."""
|
|
uk_airports = {"LHR", "LGW", "STN", "LTN", "BRS", "BHX", "MAN", "EDI", "GLA"}
|
|
|
|
most_recent_location = None
|
|
most_recent_date = None
|
|
most_recent_datetime = None
|
|
|
|
# Check flights
|
|
for booking in bookings:
|
|
for flight in booking.get("flights", []):
|
|
if "arrive" in flight:
|
|
try:
|
|
arrive_datetime, arrive_date = _parse_datetime_field(
|
|
flight["arrive"]
|
|
)
|
|
except ValueError:
|
|
continue
|
|
|
|
if arrive_date <= target_date:
|
|
# Compare both date and time to handle same-day flights correctly
|
|
if (
|
|
most_recent_date is None
|
|
or arrive_date > most_recent_date
|
|
or (
|
|
arrive_date == most_recent_date
|
|
and (
|
|
most_recent_datetime is None
|
|
or arrive_datetime > most_recent_datetime
|
|
)
|
|
)
|
|
):
|
|
most_recent_date = arrive_date
|
|
most_recent_datetime = arrive_datetime
|
|
destination_airport = flight["to"]
|
|
most_recent_location = _get_airport_location(
|
|
destination_airport, airports, uk_airports, on_trip=False
|
|
)
|
|
|
|
# Check accommodation - only override if accommodation is more recent
|
|
for acc in accommodations:
|
|
if "from" in acc:
|
|
try:
|
|
_, acc_date = _parse_datetime_field(acc["from"])
|
|
except ValueError:
|
|
continue
|
|
|
|
if acc_date <= target_date:
|
|
# Only update if this accommodation is more recent than existing result
|
|
if most_recent_date is None or acc_date > most_recent_date:
|
|
most_recent_date = acc_date
|
|
most_recent_location = _get_accommodation_location(
|
|
acc, on_trip=False
|
|
)
|
|
|
|
return most_recent_location
|
|
|
|
|
|
def _check_return_home_heuristic(
|
|
target_date: date, trips: list[Trip]
|
|
) -> tuple[str | None, pycountry.db.Country | None] | None:
|
|
"""Check if should return home based on recent trips that have ended."""
|
|
for trip in trips:
|
|
if trip.end and trip.end < target_date:
|
|
locations = trip.locations()
|
|
if locations:
|
|
final_city, final_country = locations[-1]
|
|
final_alpha_2 = final_country.alpha_2
|
|
days_since_trip = (target_date - trip.end).days
|
|
|
|
# If trip ended in UK, you should be home now
|
|
if hasattr(final_country, "alpha_2") and final_country.alpha_2 == "GB":
|
|
return (None, get_country("gb"))
|
|
|
|
# For short trips to nearby countries or international trips
|
|
# (ended >=1 day ago), assume returned home if no subsequent travel data
|
|
if days_since_trip >= 1 and (
|
|
# European countries (close by rail/ferry)
|
|
final_alpha_2 in {"BE", "NL", "FR", "DE", "CH", "AT", "IT", "ES"}
|
|
# Nearby Balkan countries
|
|
or final_alpha_2 in NEARBY_BALKAN_COUNTRIES
|
|
# International trips (assume return home after trip ends)
|
|
or final_alpha_2
|
|
in {"US", "CA", "IN", "JP", "CN", "AU", "NZ", "BR", "AR", "ZA"}
|
|
):
|
|
return (None, get_country("gb"))
|
|
|
|
return None
|
|
|
|
|
|
def get_location_for_date(
|
|
target_date: date,
|
|
trips: list[Trip],
|
|
bookings: list[StrDict],
|
|
accommodations: list[StrDict],
|
|
airports: StrDict,
|
|
) -> tuple[str | None, pycountry.db.Country | None]:
|
|
"""Get location (city, country) for a specific date using travel history."""
|
|
# First check if currently on a trip
|
|
for trip in trips:
|
|
if trip.start <= target_date <= (trip.end or trip.start):
|
|
# For trips, find the most recent flight or accommodation within the trip period
|
|
trip_location = _find_most_recent_travel_within_trip(
|
|
trip, target_date, bookings, accommodations, airports
|
|
)
|
|
if trip_location:
|
|
return trip_location
|
|
|
|
# Fallback: determine location based on trip progression and date
|
|
progression_location = _get_trip_location_by_progression(trip, target_date)
|
|
if progression_location:
|
|
return progression_location
|
|
|
|
# Find most recent flight or accommodation before this date
|
|
recent_travel = _find_most_recent_travel_before_date(
|
|
target_date, bookings, accommodations, airports
|
|
)
|
|
|
|
# Check for recent trips that have ended - prioritize this over individual travel data
|
|
# This handles cases where you're traveling home after a trip (e.g. stopovers, connections)
|
|
return_home = _check_return_home_heuristic(target_date, trips)
|
|
if return_home:
|
|
return return_home
|
|
|
|
# Return most recent location or default to home
|
|
if recent_travel:
|
|
return recent_travel
|
|
|
|
return (None, get_country("gb"))
|
|
|
|
|
|
def weekends(
|
|
start: date, busy_events: list[Event], trips: list[Trip], data_dir: str
|
|
) -> typing.Sequence[StrDict]:
|
|
"""Next ten weekends."""
|
|
weekday = start.weekday()
|
|
|
|
# Calculate the difference to the next or previous Saturday
|
|
if weekday == 6: # Sunday
|
|
start_date = start - timedelta(days=1)
|
|
else:
|
|
start_date = start + timedelta(days=(5 - weekday))
|
|
|
|
# Parse YAML files once for all location lookups
|
|
bookings = travel.parse_yaml("flights", data_dir)
|
|
accommodations = travel.parse_yaml("accommodation", data_dir)
|
|
airports = travel.parse_yaml("airports", data_dir)
|
|
|
|
weekends_info = []
|
|
for i in range(52):
|
|
saturday = start_date + timedelta(weeks=i)
|
|
sunday = saturday + timedelta(days=1)
|
|
|
|
saturday_events = [
|
|
event
|
|
for event in busy_events
|
|
if event.end_date and event.as_date <= saturday <= event.end_as_date
|
|
]
|
|
sunday_events = [
|
|
event
|
|
for event in busy_events
|
|
if event.end_date and event.as_date <= sunday <= event.end_as_date
|
|
]
|
|
|
|
saturday_location = get_location_for_date(
|
|
saturday, trips, bookings, accommodations, airports
|
|
)
|
|
sunday_location = get_location_for_date(
|
|
sunday, trips, bookings, accommodations, airports
|
|
)
|
|
|
|
weekends_info.append(
|
|
{
|
|
"date": saturday,
|
|
"saturday": saturday_events,
|
|
"sunday": sunday_events,
|
|
"saturday_location": saturday_location,
|
|
"sunday_location": sunday_location,
|
|
}
|
|
)
|
|
|
|
return weekends_info
|
|
|
|
|
|
def find_gaps(events: list[Event], min_gap_days: int = 3) -> list[StrDict]:
|
|
"""Gaps of at least `min_gap_days` between events in a list of events."""
|
|
# Sort events by start date
|
|
|
|
gaps: list[tuple[date, date]] = []
|
|
previous_event_end = None
|
|
|
|
by_start_date = {
|
|
d: list(on_day)
|
|
for d, on_day in itertools.groupby(events, key=lambda e: e.as_date)
|
|
}
|
|
|
|
by_end_date = {
|
|
d: list(on_day)
|
|
for d, on_day in itertools.groupby(events, key=lambda e: e.end_as_date)
|
|
}
|
|
|
|
for event in events:
|
|
# Use start date for current event
|
|
start_date = event.as_date
|
|
|
|
# If previous event exists, calculate the gap
|
|
if previous_event_end:
|
|
gap_days = (start_date - previous_event_end).days
|
|
if gap_days >= (min_gap_days + 2):
|
|
start_end = (
|
|
previous_event_end + timedelta(days=1),
|
|
start_date - timedelta(days=1),
|
|
)
|
|
gaps.append(start_end)
|
|
|
|
# Update previous event end date
|
|
end = event.end_as_date
|
|
if not previous_event_end or end > previous_event_end:
|
|
previous_event_end = end
|
|
|
|
return [
|
|
{
|
|
"start": gap_start,
|
|
"end": gap_end,
|
|
"after": by_start_date[gap_end + timedelta(days=1)],
|
|
"before": by_end_date[gap_start - timedelta(days=1)],
|
|
}
|
|
for gap_start, gap_end in gaps
|
|
]
|