detail

gurume.detail

Course dataclass

Course(
    name: str,
    price: str | None = None,
    description: str | None = None,
    items: list[str] = list(),
)

Course information.

MenuItem dataclass

MenuItem(
    name: str,
    price: str | None = None,
    description: str | None = None,
    category: str | None = None,
)

Menu item.

RestaurantDetail dataclass

RestaurantDetail(
    restaurant: Restaurant,
    reviews: list[Review] = list(),
    menu_items: list[MenuItem] = list(),
    courses: list[Course] = list(),
)

Restaurant detail information.

RestaurantDetailRequest dataclass

RestaurantDetailRequest(
    restaurant_url: str,
    fetch_reviews: bool = True,
    fetch_menu: bool = True,
    fetch_courses: bool = True,
    max_review_pages: int = 1,
)

Restaurant detail request.

fetch async

fetch() -> RestaurantDetail

Fetch restaurant details asynchronously.

Source code in src/gurume/detail.py

async def fetch(self) -> RestaurantDetail:
    """Fetch restaurant details asynchronously."""
    base_url = self._get_base_url()

    reviews = []
    menu_items = []
    courses = []

    async with requests.AsyncSession(
        timeout=30.0,
        allow_redirects=True,
        impersonate=DEFAULT_IMPERSONATE,
    ) as client:
        main_resp = await client.get(base_url)
        main_resp.raise_for_status()
        restaurant = self._parse_restaurant(main_resp.text, base_url)

        # Fetch reviews.
        if self.fetch_reviews:
            for page in range(1, self.max_review_pages + 1):
                review_url = f"{base_url}/dtlrvwlst/"
                if page > 1:
                    review_url += f"?PG={page}"

                resp = await client.get(review_url)
                resp.raise_for_status()
                reviews.extend(self._parse_reviews(resp.text))

        # Fetch menu items.
        if self.fetch_menu:
            menu_url = f"{base_url}/dtlmenu/"
            if menu_html := await self._fetch_optional_async(client, menu_url):
                menu_items = self._parse_menu_items(menu_html)

        # Fetch courses.
        if self.fetch_courses:
            course_url = f"{base_url}/party/"
            if course_html := await self._fetch_optional_async(client, course_url):
                courses = self._parse_courses(course_html)

    return RestaurantDetail(
        restaurant=restaurant,
        reviews=reviews,
        menu_items=menu_items,
        courses=courses,
    )

fetch_sync

fetch_sync() -> RestaurantDetail

Fetch restaurant details synchronously.

Source code in src/gurume/detail.py

def fetch_sync(self) -> RestaurantDetail:
    """Fetch restaurant details synchronously."""
    base_url = self._get_base_url()

    main_resp = requests.get(
        base_url,
        timeout=30.0,
        allow_redirects=True,
        impersonate=DEFAULT_IMPERSONATE,
    )
    main_resp.raise_for_status()
    restaurant = self._parse_restaurant(main_resp.text, base_url)

    reviews = []
    menu_items = []
    courses = []

    # Fetch reviews.
    if self.fetch_reviews:
        for page in range(1, self.max_review_pages + 1):
            review_url = f"{base_url}/dtlrvwlst/"
            if page > 1:
                review_url += f"?PG={page}"

            resp = requests.get(
                review_url,
                timeout=30.0,
                allow_redirects=True,
                impersonate=DEFAULT_IMPERSONATE,
            )
            resp.raise_for_status()
            reviews.extend(self._parse_reviews(resp.text))

    # Fetch menu items.
    if self.fetch_menu:
        menu_url = f"{base_url}/dtlmenu/"
        if menu_html := self._fetch_optional_sync(menu_url):
            menu_items = self._parse_menu_items(menu_html)

    # Fetch courses.
    if self.fetch_courses:
        course_url = f"{base_url}/party/"
        if course_html := self._fetch_optional_sync(course_url):
            courses = self._parse_courses(course_html)

    return RestaurantDetail(
        restaurant=restaurant,
        reviews=reviews,
        menu_items=menu_items,
        courses=courses,
    )

Review dataclass

Review(
    reviewer: str,
    content: str,
    rating: float | None = None,
    visit_date: str | None = None,
    title: str | None = None,
    helpful_count: int | None = None,
)

Review information.