python-qdairlines-helper 0.0.6__py3-none-any.whl

qdairlines_helper/po/home_page.py

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     home_page.py
+# Description:  首页页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from playwright.async_api import Page
+from playwright_helper.libs.base_po import BasePo
+import qdairlines_helper.config.url_const as url_const
+
+
+class HomePage(BasePo):
+    url: str = url_const.home_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.home_url)
+        self.__page = page

qdairlines_helper/po/login_page.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     login_page.py
+# Description:  登录页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+import qdairlines_helper.config.url_const as url_const
+
+
+class LoginPage(BasePo):
+    url: str = url_const.login_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.login_url)
+        self.__page = page
+
+    async def get_login_username_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取登录页面的会员卡号输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//input[@id="username"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_login_password_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取登录页面的密码输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//input[@id="password"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_check_logo_icon(self, timeout: float = 5.0) -> Locator:
+        """
+        获取易盾校验logo图标
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[@class="yidun_intelli-icon"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_check_pass_text(self, timeout: float = 5.0) -> str:
+        """
+        点击易盾校验logo图标后，获取验证成功的文案
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//span[@class="yidun_tips__text yidun-fallback__tip" and contains(text(), "验证成功")]'
+        locator = await self.get_locator(selector=selector, timeout=timeout)
+        return (await locator.inner_text()).strip()
+
+    async def get_login_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取登录按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//button[@class="search_btn"]'
+        return await self.get_locator(selector=selector, timeout=timeout)

qdairlines_helper/po/nhlms_cash_desk_page.py

@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     nhlms_cash_desk_page.py
+# Description:  汇付天下收银台页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional, Any
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+import qdairlines_helper.config.url_const as url_const
+from playwright_helper.utils.type_utils import safe_convert_advanced
+
+
+class NhlmsCashDeskPage(BasePo):
+    url: str = url_const.nhlms_cashdesk_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.nhlms_cashdesk_url)
+        self.__page = page
+
+    async def get_order_amount(self, timeout: float = 5.0) -> Any:
+        """
+        获取汇付天下收银台页的支付金额
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="form-text-info recharge"]'
+        locator: Locator = await self.get_locator(selector=selector, timeout=timeout)
+        return safe_convert_advanced((await locator.inner_text()).strip())
+
+    async def get_order_transaction(self, timeout: float = 5.0) -> str:
+        """
+        获取汇付天下收银台页的订单流水
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="mer-info"]//span[contains(text(), "订单号")]//span'
+        locator: Locator = await self.get_locator(selector=selector, timeout=timeout)
+        return (await locator.inner_text()).strip()
+
+    async def get_payment_type_tab(self, payment_type: str = "付款账户支付", timeout: float = 5.0) -> Locator:
+        """
+        获取汇付天下收银台页的付款方式tab
+        :param payment_type: 付款方式，包括：付款账户支付|保理账户支付|个人网银|企业网银|快捷支付
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if payment_type == '付款账户支付':
+            value = "ap"
+        elif payment_type == "保理账户支付":
+            value = "bl"
+        elif payment_type == "个人网银":
+            value = "user"
+        elif payment_type == "企业网银":
+            value = "mer"
+        elif payment_type == "快捷支付":
+            value = "fp"
+        else:
+            raise EnvironmentError(f"汇付天下收银台暂不支持<{payment_type}>的付款方式")
+        selector: str = f'//div[@class="content-bottom network-recharge"]//li[@value="{value}"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_username_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取汇付天下收银台页的操作员号输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="content-bottom network-recharge"]//input[@id="userId"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_password_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取汇付天下收银台页的密码输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="content-bottom network-recharge"]//input[@id="usrPw"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_confirm_payment_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取汇付天下收银台页中的【确认支付】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="content-bottom network-recharge"]//button[@id="submitBtn"]'
+        return await self.get_locator(selector=selector, timeout=timeout)

qdairlines_helper/po/order_verify_page.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     order_verify_page.py
+# Description:  订单校验页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from playwright.async_api import Error as PlaywrightError, TimeoutError as PlaywrightTimeoutError
+
+
+class OrderVerifyPage(BasePo):
+    url: str = url_const.order_verify_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.order_verify_url)
+        self.__page = page
+
+    async def get_order_info_plane(self, timeout: float = 5.0, refresh_attempt: int = 3) -> Locator:
+        """
+        获取订单校验页中的订单信息版面，注意这里有个小坑，经常出现已经进入了该页面，但是订单信息没有加载出来，需要不断尝试刷新页面
+        :param timeout: 超时时间（秒）
+        :param refresh_attempt: 尝试刷新次数
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        attempt = 0
+        selector: str = 'xpath=//div[@class="order_info"]'
+        while attempt <= refresh_attempt:
+            try:
+                await self.__page.reload(timeout=timeout)
+                return await self.get_locator(selector=selector, timeout=timeout)
+            except (PlaywrightError, PlaywrightTimeoutError, EnvironmentError, RuntimeError, Exception) as e:
+                attempt += 1
+                logger.error(f"订单校验页面，第<{attempt}>次尝试刷新加载订单数据失败，原因：{e}")
+        raise RuntimeError("订单校验页面中的订单信息加载出现异常，可能是网络拥塞或者用户被风控")
+
+    async def get_agree_checkbox(self, timeout: float = 5.0) -> Locator:
+        """
+        获取订单校验页中的【同意条款】单选框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//span[@class="el-checkbox__inner"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_next_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的【下一步】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//span[contains(text(), "立即购票")]'
+        return await self.get_locator(selector=selector, timeout=timeout)

qdairlines_helper/utils/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     __init__.py
+# Description:  工具包
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

qdairlines_helper/utils/exception_utils.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     exception_utils.py
+# Description:  异常工具模块
+# Author:       ASUS
+# CreateDate:   2026/01/07
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+
+
+class DuplicatePaymentError(Exception):
+    def __init__(self, order_id: int):
+        self.order_id = order_id
+        super().__init__(f"订单<{order_id}>重复支付错误")

qdairlines_helper/utils/log_utils.py

@@ -0,0 +1,14 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     log_utils.py
+# Description:  日志模块
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from logging import getLogger
+
+logger = getLogger("root")

qdairlines_helper/utils/po_utils.py

@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     po_utils.py
+# Description:  页面工具模块
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional, List, Dict, Any
+import qdairlines_helper.config.url_const as url_const
+from playwright.async_api import Page, Locator, Error as PlaywrightError, TimeoutError as PlaywrightTimeoutError
+
+
+async def get_ip_access_blocked_msg(page: Page, timeout: float = 60.0) -> Optional[str]:
+    selector: str = '//h3[contains(text(), "您的IP")]'
+    locator: Locator = page.locator(selector=selector)
+    try:
+        await locator.first.wait_for(state='visible', timeout=timeout * 1000)
+        return (await locator.inner_text()).strip()
+    except (PlaywrightTimeoutError, PlaywrightError, Exception):
+        return
+
+
+def parse_user_info_from_page_response(network_logs: List[Dict[str, Any]]) -> dict:
+    user_info = dict()
+    for network_log in network_logs:
+        try:
+            if network_log.get('type') == 'response':
+                if url_const.auth_form_api_url in (network_log.get("url") or ""):
+                    body = network_log.get("body")
+                    result = body.get('result')
+                    user_info["access_token"] = result.get('access_token')
+                    user_info["expires"] = result.get('expires_in')
+                elif url_const.login_after_api_url in (network_log.get("url") or ""):
+                    body = network_log.get("body")
+                    result = body.get('result')
+                    user_info["user_id"] = result.get('userId')
+                    user_info["id"] = result.get('id')
+            elif network_log.get('type') == 'request':
+                if url_const.login_after_api_url in (network_log.get("url") or ""):
+                    headers = network_log.get('headers')
+                    headers.pop("referer", None)
+                    headers.pop("timestamp", None)
+                    user_info["headers"] = headers
+        except (Exception,):
+            pass
+    return user_info