detail

gurume.detail

Course dataclass

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

套餐資訊

MenuItem dataclass

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

菜單項目

RestaurantDetail dataclass

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

餐廳詳細資訊

RestaurantDetailRequest dataclass

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

餐廳詳細資訊請求

fetch async

fetch() -> RestaurantDetail

異步抓取餐廳詳細資訊

Source code in src/gurume/detail.py

async def fetch(self) -> RestaurantDetail:
    """異步抓取餐廳詳細資訊"""
    headers = {"User-Agent": USER_AGENT}

    base_url = self._get_base_url()

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

    async with httpx.AsyncClient(timeout=30.0, follow_redirects=True) as client:
        main_resp = await client.get(base_url, headers=headers)
        main_resp.raise_for_status()
        restaurant = self._parse_restaurant(main_resp.text, base_url)

        # 抓取評論
        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, headers=headers)
                resp.raise_for_status()
                reviews.extend(self._parse_reviews(resp.text))

        # 抓取菜單
        if self.fetch_menu:
            menu_url = f"{base_url}/dtlmenu/"
            resp = await client.get(menu_url, headers=headers)
            resp.raise_for_status()
            menu_items = self._parse_menu_items(resp.text)

        # 抓取套餐
        if self.fetch_courses:
            course_url = f"{base_url}/party/"
            resp = await client.get(course_url, headers=headers)
            resp.raise_for_status()
            courses = self._parse_courses(resp.text)

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

fetch_sync

fetch_sync() -> RestaurantDetail

同步抓取餐廳詳細資訊

Source code in src/gurume/detail.py

def fetch_sync(self) -> RestaurantDetail:
    """同步抓取餐廳詳細資訊"""
    headers = {"User-Agent": USER_AGENT}

    base_url = self._get_base_url()

    main_resp = httpx.get(base_url, headers=headers, timeout=30.0, follow_redirects=True)
    main_resp.raise_for_status()
    restaurant = self._parse_restaurant(main_resp.text, base_url)

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

    # 抓取評論
    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 = httpx.get(review_url, headers=headers, timeout=30.0, follow_redirects=True)
            resp.raise_for_status()
            reviews.extend(self._parse_reviews(resp.text))

    # 抓取菜單
    if self.fetch_menu:
        menu_url = f"{base_url}/dtlmenu/"
        resp = httpx.get(menu_url, headers=headers, timeout=30.0, follow_redirects=True)
        resp.raise_for_status()
        menu_items = self._parse_menu_items(resp.text)

    # 抓取套餐
    if self.fetch_courses:
        course_url = f"{base_url}/party/"
        resp = httpx.get(course_url, headers=headers, timeout=30.0, follow_redirects=True)
        resp.raise_for_status()
        courses = self._parse_courses(resp.text)

    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,
)

評論資訊