Przejdź do treści

Klasa Reservation

Klasa Reservation reprezentuje pojedynczą rezerwację dokonaną przez gościa w systemie hotelowym.

Zawiera informacje o dacie zameldowania, wymeldowania, wybranym pokoju oraz osobie dokonującej rezerwacji.

Pozwala obliczyć łączny koszt pobytu, liczbę nocy oraz wygenerować podsumowanie rezerwacji.

Dokumentacja techniczna

Reprezentuje rezerwację dokonaną przez gościa hotelu.

Atrybuty

reservation_id (str): Unikalny identyfikator rezerwacji. guest (Guest): Gość hotelu dokonujący rezerwacji. room (Room): Pokój, który został zarezerwowany. check_in (date): Data zameldowania. check_out (date): Data wymeldowania.

Inicjalizuje obiekt klasy Reservation. Args: guest: Guest: Gość hotelu. room: Room: Pokój hotelowy. check_in: date: Data zameldowania. check_out: date: Data wymeldowania.

Raises:

Type Description
TypeError

Jeśli gość nie jest prawidłowym obiektem klasy Guest np. nie istnieje gość o danym imieniu i nazwisku,
TypeError

Jeśli pokój nie jest prawidłowym obiektem klasy Room np. podano pokój numer 101, gdy hotel posiada pokoje do numeru 100,
TypeError

Jeśli data została podana w nieprawidłowym formacie np. check_in = date(2025, 7, 23), zamiast check_in= „2025-07-23”,
ValueError

Jeśli data wymeldowania jest wcześniejsza niż zameldowania np. check_in = date(2025-07-23), check_out = date(2025-07-21).

Dzięki temu program nie przyjmie niepoprawnych danych i nie stworzy błędnej rezerwacji. Po sprawdzeniu poprawności danych, program tworzy nowy obiekt rezerwacji, zgodnie z zadeklarowanymi atrybutami, i przypisuje mu dane.

Source code in models/reservation.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
def __init__(self, guest: Guest, room: Room, check_in: date, check_out: date):
    """Inicjalizuje obiekt klasy Reservation.
    Args:
        guest: Guest: Gość hotelu.
        room: Room: Pokój hotelowy.
        check_in: date: Data zameldowania.
        check_out: date: Data wymeldowania.

    Raises:
        TypeError: Jeśli gość nie jest prawidłowym obiektem klasy Guest np. nie istnieje gość o danym imieniu i nazwisku,
        TypeError: Jeśli pokój nie jest prawidłowym obiektem klasy Room np. podano pokój numer 101, gdy hotel posiada pokoje do numeru 100,
        TypeError: Jeśli data została podana w nieprawidłowym formacie np. check_in = date(2025, 7, 23), zamiast check_in= „2025-07-23”,
        ValueError: Jeśli data wymeldowania jest wcześniejsza niż zameldowania np. check_in = date(2025-07-23), check_out = date(2025-07-21).
    Dzięki temu program nie przyjmie niepoprawnych danych i nie stworzy błędnej rezerwacji.
    Po sprawdzeniu poprawności danych, program tworzy nowy obiekt rezerwacji, zgodnie z zadeklarowanymi atrybutami, i przypisuje mu dane.
    """
    if not isinstance(guest, Guest):
        raise TypeError("Podany gość nie istnieje. Gość musi należeć do klasy Guest.")
    if not isinstance(room, Room):
        raise TypeError("Podany pokój nie istnieje. Pokój musi należeć do klasy Room.")
    if not isinstance(check_in, date) or not isinstance(check_out, date):
        raise TypeError("Data zameldowania i wymeldowania muszą mieć format daty (RRR-MM-DD).")
    if check_in >= check_out:
        raise ValueError("Data wymeldowania musi być późniejsza niż data zameldowania.")

    self.reservation_id: str = str(uuid.uuid4())
    self.guest: Guest = guest
    self.room: Room = room
    self.check_in: date = check_in
    self.check_out: date = check_out

get_duration()

Oblicza i zwraca liczbę nocy w ramach danej rezerwacji, Returns: int: różnica między datą zameldowania, a datą wymeldowania, z której wyciągnięto liczbę pełnych dni jako liczbę całkowitą.

Source code in models/reservation.py 
50
51
52
53
54
def get_duration(self) -> int:
    """Oblicza i zwraca liczbę nocy w ramach danej rezerwacji,
    Returns:
        int: różnica między datą zameldowania, a datą wymeldowania, z której wyciągnięto liczbę pełnych dni jako liczbę całkowitą. """
    return (self.check_out - self.check_in).days

get_summary()

Returns: Reservation_id – unikalny identyfikator rezerwacji Guest_name – metoda z klasy Guest, która zwraca imię i nazwisko gościa Room_number – unikalny numer pokoju, atrybut klasy Room Check_in – data zameldowania w formacie ISO (RRR-MM-DD) Check_out - data wymeldowania w formacie ISO (RRR-MM-DD) Nights – liczba nocy obliczona za pomocą get_duration() Total_price – całkowity koszt pobytu w hotelu obliczony za pomocą get_total_price()

Source code in models/reservation.py 
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
    def get_summary(self) -> Dict[str, Any]:
        """Returns:
            Reservation_id – unikalny identyfikator rezerwacji
            Guest_name – metoda z klasy Guest, która zwraca imię i nazwisko gościa
            Room_number – unikalny numer pokoju, atrybut klasy Room
            Check_in – data zameldowania w formacie ISO (RRR-MM-DD)
            Check_out - data wymeldowania w formacie ISO (RRR-MM-DD)
            Nights – liczba nocy obliczona za pomocą get_duration()
            Total_price – całkowity koszt pobytu w hotelu obliczony za pomocą get_total_price()
"""
        return {
            "reservation_id": self.reservation_id,
            "guest_name": self.guest.get_full_name(),
            "room_number": self.room.number,
            "check_in": self.check_in.isoformat(),
            "check_out": self.check_out.isoformat(),
            "nights": self.get_duration(),
            "total_price": self.get_total_price(),
        }

get_total_price()

Oblicza całkowity koszt pobytu w hotelu Returns: float: iloczyn w formie zmiennoprzecinkowej, obliczonej liczby nocy (get_duration) i ceny jednej nocy w danym pokoju (price_per_night) będącą atrybutem klasy Room

Source code in models/reservation.py 
56
57
58
59
60
61
def get_total_price(self) -> float:
    """Oblicza całkowity koszt pobytu w hotelu
    Returns:
        float: iloczyn w formie zmiennoprzecinkowej, obliczonej liczby nocy (get_duration) i ceny jednej nocy w danym pokoju (price_per_night) będącą atrybutem klasy Room
     """
    return self.get_duration() * self.room.price_per_night

Przykład użycia

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
from models.reservation import Reservation
from models.guest import Guest
from models.room import Room
from datetime import date

guest = Guest("Anna", "Nowak", "anna.nowak@email.com", "123456789")
room = Room("101", "double", 200.0, 2)
check_in = date(2025, 7, 23)
check_out = date(2025, 7, 26)

rezerwacja = Reservation(guest, room, check_in, check_out)

print(rezerwacja.get_duration())
print(rezerwacja.get_total_price())
print(rezerwacja.get_summary())