Skip to content

Dates

DateRangeError

Bases: Exception

This date is before the Divvy start.

Source code in lyft_bikes/historical/dates.py
class DateRangeError(Exception):
    """This date is before the Divvy start."""

DefaultDates

Source code in lyft_bikes/historical/dates.py
class DefaultDates:
    def check_valid(self, date: datetime.date) -> None:
        if date > self.last_date:
            raise DateRangeError(f"{date} data hasn't been released yet.")

    @property
    def last_date(self) -> datetime.date:
        """Latest available day in the historical dataset.

        Based on the releases of the historical trips. Seems to be safe to include
        the previous month.

        """
        previous_month = datetime.date.today().replace(day=1) - relativedelta(months=1)
        last_day_previous_month = monthrange(previous_month.year, previous_month.month)[
            1
        ]

        return previous_month.replace(day=last_day_previous_month)

    def create_date_range(self, start_date: str, end_date: str) -> List[datetime.date]:
        """Return list of dates from start to end"""
        dates = pd.date_range(
            str(self.first_of_month(start_date)),
            str(self.first_of_month(end_date)),
            freq="MS",
        )

        return [date.to_pydatetime().date() for date in dates]

    @staticmethod
    def first_of_month(date: str) -> datetime.date:
        return datetime.datetime.strptime(date, "%Y-%m-%d").date().replace(day=1)

    @staticmethod
    def to_date(year: int, month: int) -> datetime.date:
        return datetime.date(year, month, 1)

last_date: datetime.date property

Latest available day in the historical dataset.

Based on the releases of the historical trips. Seems to be safe to include the previous month.

create_date_range(start_date, end_date)

Return list of dates from start to end

Source code in lyft_bikes/historical/dates.py
def create_date_range(self, start_date: str, end_date: str) -> List[datetime.date]:
    """Return list of dates from start to end"""
    dates = pd.date_range(
        str(self.first_of_month(start_date)),
        str(self.first_of_month(end_date)),
        freq="MS",
    )

    return [date.to_pydatetime().date() for date in dates]

DivvyDates

Bases: DefaultDates

Class that stores and calculates different dates associated with the Divvy Program.

Source code in lyft_bikes/historical/dates.py
class DivvyDates(DefaultDates):
    """Class that stores and calculates different dates associated with the Divvy Program."""

    first_date = datetime.date(2020, 4, 1)
    electric_trials = datetime.date(2020, 7, 13)
    first_electric_date = datetime.date(2020, 7, 28)
    # Last day of the west of Western pricing
    end_of_waiver = datetime.date(2022, 5, 10)

    def check_valid(self, date: datetime.date) -> None:
        super().check_valid(date)

        if date < self.first_date:
            raise DateRangeError(f"{date} is before the historical trips.")