python-qlv-helper 0.2.0__py3-none-any.whl

qlv_helper/controller/order_table.py

@@ -0,0 +1,145 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     order_table.py
+# Description:  订单列表页面控制器
+# Author:       ASUS
+# CreateDate:   2025/12/01
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import asyncio
+from aiohttp import CookieJar
+from typing import Optional, Dict, Any, Callable, List
+from http_helper.client.async_proxy import HttpClientFactory
+from qlv_helper.utils.html_utils import parse_pagination_info
+from qlv_helper.http.order_table_page import get_domestic_activity_order_page_html, get_domestic_ticket_outed_page_html, \
+    parse_order_table
+
+
+async def _get_paginated_order_table(
+        *,
+        domain: str,
+        protocol: str,
+        retry: int,
+        timeout: int,
+        enable_log: bool,
+        cookie_jar: Optional[CookieJar],
+        playwright_state: Dict[str, Any],
+        table_state: str,
+        fetch_page_fn: Callable[..., Any],   # 拿到第一页/分页 HTML 的函数
+) -> Dict[str, Any]:
+    """通用分页表格抓取（支持并发）"""
+
+    order_http_client = HttpClientFactory(
+        protocol=protocol if protocol == "http" else "https",
+        domain=domain,
+        timeout=timeout,
+        retry=retry,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state
+    )
+
+    # --- 1. 先拿第一页(串行) ---
+    response = await fetch_page_fn(
+        domain=domain, protocol=protocol, retry=retry, timeout=timeout,
+        enable_log=enable_log, cookie_jar=cookie_jar, playwright_state=playwright_state,
+        order_http_client=order_http_client, is_end=True
+    )
+    if response.get("code") != 200:
+        return response
+
+    html = response["data"]
+    table_data: List[Dict[str, Any]] = parse_order_table(html=html, table_state=table_state)
+
+    pagination_info = parse_pagination_info(html)
+    pages = pagination_info.get("pages", 1)
+
+    # --- 2. 如果只有 1 页，直接返回 ---
+    if pages <= 1:
+        pagination_info.update({
+            "data": table_data,
+            "is_next_page": False,
+            "page_size": len(table_data),
+            "pages": 1
+        })
+        response["data"] = pagination_info
+        return response
+
+    # --- 3. 多页：并发抓取第 2~pages 页 ---
+    async def fetch_page(client: HttpClientFactory, page: int) -> List[Optional[Dict[str, Any]]]:
+        """单页抓取任务，用于并发调度"""
+        try:
+            resp = await fetch_page_fn(
+                domain=domain, protocol=protocol, retry=retry, timeout=timeout,
+                enable_log=enable_log, cookie_jar=cookie_jar, playwright_state=playwright_state,
+                order_http_client=client, current_page=page, pages=pages, is_end=(page == pages)
+            )
+            if resp.get("code") == 200:
+                return parse_order_table(html=resp["data"], table_state=table_state)
+        except (Exception, ):
+            return list()  # 抓取失败则返回空，不影响整体
+        return list()
+
+    # 🔥 并发：一口气抓全部分页
+    order_http_client = HttpClientFactory(
+        protocol=protocol if protocol == "http" else "https",
+        domain=domain,
+        timeout=timeout,
+        retry=retry,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state
+    )
+    tasks = [fetch_page(client=order_http_client, page=page) for page in range(2, pages + 1)]
+    results = await asyncio.gather(*tasks)
+
+    # 合并表格数据
+    for r in results:
+        if r:
+            table_data.extend(r)
+
+    # --- 4. 构造最终返回数据 ---
+    pagination_info.update({
+        "data": table_data,
+        "is_next_page": False,
+        "page_size": len(table_data),
+        "pages": 1
+    })
+    response["data"] = pagination_info
+    return response
+
+async def get_domestic_activity_order_table(
+        domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[CookieJar] = None, playwright_state: Dict[str, Any] = None
+) -> Dict[str, Any]:
+    return await _get_paginated_order_table(
+        domain=domain,
+        protocol=protocol,
+        retry=retry,
+        timeout=timeout,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state,
+        table_state="proccessing",
+        fetch_page_fn=get_domestic_activity_order_page_html
+    )
+
+
+async def get_domestic_ticket_outed_table(
+        domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[CookieJar] = None, playwright_state: Dict[str, Any] = None
+) -> Dict[str, Any]:
+    return await _get_paginated_order_table(
+        domain=domain,
+        protocol=protocol,
+        retry=retry,
+        timeout=timeout,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state,
+        table_state="completed",
+        fetch_page_fn=get_domestic_ticket_outed_page_html
+    )

qlv_helper/controller/user_login.py

@@ -0,0 +1,119 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     user_login.py
+# Description:  用户登录页面控制器
+# Author:       ASUS
+# CreateDate:   2025/11/25
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import asyncio
+from typing import Tuple
+from qlv_helper.po.login_page import LoginPage
+from playwright.async_api import BrowserContext
+from qlv_helper.po.wechat_auth_page import WechatAuthPage
+from qlv_helper.utils.browser_utils import switch_for_table_window
+from qlv_helper.utils.po_utils import on_click_locator, locator_input_element
+
+
+async def _username_login(login_po: LoginPage, username: str, password: str, timeout: float = 5.0) -> Tuple[bool, str]:
+    # 1. 输入用户名
+    is_success, username_input = await login_po.get_login_username_input(timeout=timeout)
+    if is_success is False:
+        return is_success, username_input
+    await locator_input_element(locator=username_input, text=username.strip())
+
+    # 2. 输入密码
+    is_success, password_input = await login_po.get_login_password_input(timeout=timeout)
+    if is_success is False:
+        return is_success, username_input
+    await locator_input_element(locator=password_input, text=password.strip())
+
+    # 3. 获取一层验证码
+    is_success, code_str = await login_po.get_number_code(timeout=timeout)
+    if is_success is False:
+        return is_success, code_str
+
+    # 4. 输入一层验证码
+    is_success, code_input = await login_po.get_login_number_code_input(timeout=timeout)
+    if is_success is False:
+        return is_success, code_input
+    await locator_input_element(locator=code_input, text=code_str.lower())
+
+    # 5. 点击登录
+    is_success, login_btn = await login_po.get_login_btn(timeout=timeout)
+    if is_success is False:
+        return is_success, login_btn
+    await on_click_locator(locator=login_btn)
+
+
+async def _wechat_login(browser: BrowserContext, login_po: LoginPage, timeout: float = 5.0) -> Tuple[bool, str]:
+    # 1. 点击微信登录快捷入口
+    is_success, wechat_entrance = await login_po.get_wechat_entrance(timeout=timeout)
+    if is_success is False:
+        return is_success, wechat_entrance
+    await on_click_locator(locator=wechat_entrance)
+
+    page_new = await switch_for_table_window(browser=browser, url_keyword="open.weixin.qq.com", wait_time=int(timeout))
+    wachat_po = WechatAuthPage(page=page_new)
+
+    # 2. 点击【微信快捷登录】按钮
+    is_success, wechat_quick_login_btn = await wachat_po.get_wechat_quick_login_btn(timeout=timeout)
+    if is_success is False:
+        return is_success, wechat_quick_login_btn
+    await on_click_locator(locator=wechat_quick_login_btn)
+
+    # 3. 点击微信弹框的中【允许】按钮
+    return await wachat_po.on_click_allow_btn(timeout=int(timeout) * 3)
+
+
+async def username_login(
+        login_po: LoginPage, username: str, password: str, timeout: float = 5.0, retry: int = 3
+) -> Tuple[bool, str]:
+    # 1. 第一次全流程的登录
+    await _username_login(login_po=login_po, username=username, password=password, timeout=timeout)
+    for _ in range(retry):
+        # 2. 判断是否为当前页
+        if login_po.is_current_page() is False:
+            return True, f"账号:{username} 登录成功"
+
+        # 3. 判断是否存在登录警告，存在的话，继续输入验证码，再次登录
+        is_warn: bool = await login_po.is_exist_login_warn(timeout=timeout)
+        if is_warn is True:
+            # 4. 获取一层验证码
+            is_success, code_str = await login_po.get_number_code(timeout=timeout)
+            if is_success is False:
+                return is_success, code_str
+
+            # 5. 输入一层验证码
+            is_success, code_input = await login_po.get_login_number_code_input(timeout=timeout)
+            if is_success is False:
+                return is_success, code_input
+            await locator_input_element(locator=code_input, text=code_str.lower())
+
+            # 6. 点击登录
+            is_success, login_btn = await login_po.get_login_btn(timeout=timeout)
+            if is_success is False:
+                return is_success, login_btn
+            await on_click_locator(locator=login_btn)
+        else:
+            # 7. 重复一次全流程的登录
+            await _username_login(login_po=login_po, username=username, password=password, timeout=timeout)
+
+        await asyncio.sleep(delay=timeout)
+
+    return True, f"账号:{username} 一次登录流程结束"
+
+
+async def wechat_login(
+        browser: BrowserContext, login_po: LoginPage, timeout: float = 5.0, retry: int = 3
+) -> Tuple[bool, str]:
+    for index in range(retry):
+        # 全流程的登录
+        is_success, message = await _wechat_login(browser=browser, login_po=login_po, timeout=timeout)
+
+        # 判断是否为当前页
+        if is_success is True or index == retry - 1:
+            return is_success, message

qlv_helper/http/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     __init__.py
+# Description:  http协议相关的处理包
+# Author:       ASUS
+# CreateDate:   2025/11/28
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

qlv_helper/http/main_page.py

@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     main_page.py
+# Description:  首页的HTTP响应处理模块
+# Author:       ASUS
+# CreateDate:   2025/11/29
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import aiohttp
+from bs4 import BeautifulSoup
+from typing import Dict, Any, Optional
+from http_helper.client.async_proxy import HttpClientFactory
+
+
+async def get_main_page_html(
+        domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[aiohttp.CookieJar] = None, playwright_state: Dict[str, Any] = None
+) -> Dict[str, Any]:
+    order_http_client = HttpClientFactory(
+        protocol=protocol if protocol == "http" else "https",
+        domain=domain,
+        timeout=timeout,
+        retry=retry,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state
+    )
+    return await order_http_client.request(method="get", url="/", is_end=True)
+
+
+def parser_head_title(html: str) -> str:
+    soup = BeautifulSoup(html, "html.parser")
+    # 提取 title 文本
+    title_tag = soup.find('title')
+    if title_tag:
+        return title_tag.get_text().strip()
+    else:
+        return ""

qlv_helper/http/order_page.py

@@ -0,0 +1,313 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     order_page.py
+# Description:  订单页的HTTP响应处理模块
+# Author:       ASUS
+# CreateDate:   2025/11/28
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import re
+import aiohttp
+from datetime import datetime
+from bs4 import BeautifulSoup, Tag
+from collections import OrderedDict
+from typing import Dict, Any, Optional, List
+from qlv_helper.utils.type_utils import convert_cn_to_en
+from http_helper.client.async_proxy import HttpClientFactory
+from qlv_helper.utils.datetime_utils import get_current_dtstr
+from qlv_helper.utils.type_utils import get_key_by_index, get_value_by_index, safe_convert_advanced
+
+
+async def get_order_page_html(
+        order_id: int, domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[aiohttp.CookieJar] = None, playwright_state: Dict[str, Any] = None
+) -> Dict[str, Any]:
+    order_http_client = HttpClientFactory(
+        protocol=protocol if protocol == "http" else "https",
+        domain=domain,
+        timeout=timeout,
+        retry=retry,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state
+    )
+    return await order_http_client.request(
+        method="get",
+        url=f"/OrderProcessing/NewTicket_show/{order_id}?&r={get_current_dtstr()}",
+        is_end=True
+    )
+
+
+def order_info_static_headers() -> OrderedDict[str, str]:
+    return OrderedDict([
+        ("receipted_ota", "OTA实收"),  # 0
+        ("kickback", "佣金"),  # 1
+        ("raw_order_no", "平台订单号"),  # 2
+        ("trip_type", "行程类型"),  # 3
+        ("id", "订单号"),  # 4
+        ("stat_opration", "订单操作"),  # 5
+        ("stat_order", "订单状态")  # 6
+    ])
+
+
+def parser_order_info(html: str) -> Dict[str, Any]:
+    soup = BeautifulSoup(html, "html.parser")
+    # 找到目标 table
+    table = soup.find("table", class_="table no_border")
+    if not table:
+        return {}
+
+    # 所有 td
+    tds = table.find_all("td")
+    result = {}
+
+    for td in tds:
+        text = td.get_text(strip=True)
+        # 如果 td 内没有冒号、也不是按钮，跳过
+        if "：" not in text:
+            continue
+        # 按 "：" 进行分割
+        try:
+            key, value = text.split("：", 1)
+        except (Exception, ValueError):
+            continue
+        # 去掉换行符、空格
+        key = key.strip()
+        value = value.strip()
+
+        # 如果 value 为空，尝试取 <b> 或其他控件内文本
+        if not value:
+            b = td.find("b")
+            if b:
+                value = b.get_text(strip=True)
+
+        # 去掉尾部不需要的空格
+        value = value.replace("\u00a0", "").strip()
+        value = value[1:] if isinstance(value, str) and value.startswith("[") else value
+        value = value[:-1] if isinstance(value, str) and value.endswith("]") else value
+        result[key] = safe_convert_advanced(value)
+    return convert_cn_to_en(data=result, header_map=order_info_static_headers())
+
+
+def flight_static_headers() -> OrderedDict[str, str]:
+    return OrderedDict([
+        ("ticket_state", "票状态"),  # 0
+        ("passenger_info", "乘客信息"),  # 1
+        ("price_std", "票面价"),  # 2
+        ("price_sell", "销售价"),  # 3
+        ("tax_air", "机建费"),  # 4
+        ("tax_fuel", "燃油费"),  # 5
+        ("pnr", "PNR"),  # 6
+        ("itinerary", "行程"),  # 7
+        ("ticket_no", "票号"),  # 8
+        ("itinerary_no", "行程单号"),  # 9
+    ])
+
+
+def flight_extend_headers() -> OrderedDict[str, str]:
+    return OrderedDict([
+        ("p_name", "姓名"),  # 0
+        ("p_type", "类型"),  # 1
+        ("id_type", "证件类型"),  # 2
+        ("id_no", "身份证"),  # 3
+        ("birth_day", "出生年月"),  # 4
+        ("age", "年龄"),  # 5
+        ("gender", "性别"),  # 6
+        ("new_nation", "国籍"),  # 7
+        ("card_issue_place", "签发国"),  # 8
+        ("id_valid_dat", " 证件有效期"),  # 9
+        ("code_dep", " 起飞机场"),  # 10
+        ("code_arr", " 抵达机场"),  # 11
+    ])
+
+
+def parse_order_flight_table_headers(html: Tag) -> OrderedDict[str, str]:
+    """解析航班表表头"""
+    headers = OrderedDict()
+    for th in html.find_all("th"):
+        # 获取直接文本，不要子标签中的内容
+        direct_texts = th.find_all(text=True, recursive=False)
+        header = "".join(t.strip() for t in direct_texts if t.strip()) or th.get_text(strip=True)
+        headers[header] = header
+    return headers
+
+
+def clean_order_flight_table(html: Tag) -> str:
+    """清理航班表html内容多余的信息"""
+    # 移除 script / style / hidden
+    for tag in html.find_all(["script", "style"]):
+        tag.extract()
+
+    # 尝试去掉 display:none 的标签
+    for tag in html.find_all(style=True):
+        style = tag["style"].replace(" ", "").lower()
+        if "display:none" in style:
+            tag.extract()
+
+    return html.get_text(strip=True)
+
+
+def parse_order_flight_table_passenger_info(raw: Tag, headers: OrderedDict[str, str]) -> Dict[str, Any]:
+    """
+    解析包含 copyFn(...) 的乘客信息 TD，返回 dict
+    """
+    # -------------------------------
+    # 1. 解析 <img onclick="copyFn('吴世勇||身份证|140104194702241336|男||1947/2/24 0:00:00||1900/1/1 0:00:00')" src="/images/nav_assistant.png" style="width:20px; height:20px; margin:0px;"/>
+    # -------------------------------
+    img = raw.find("img", onclick=True)
+    if not img:
+        return {}
+
+    # 提取里面的参数内容
+    onclick = img["onclick"]
+    m = re.search(r"copyFn\('(.+?)'\)", onclick)
+    if not m:
+        return {}
+
+    group = m.group(1)  # "吴世勇||身份证|140104194702241336|男||1947/2/24 0:00:00||1900/1/1 0:00:00"
+    parts = group.split("|")
+
+    # 字段参考：
+    # 0: 姓名
+    # 1: 空
+    # 2: 证件类型
+    # 3: 证件号
+    # 4: 性别
+    # 5: 空
+    # 6: 出生日期
+    # 7: 空
+    # 8: 证件有效期（可能无）
+    name = parts[0]
+    id_type = parts[2]
+    id_no_raw = parts[3]
+    sex = parts[4]
+    birth_raw = parts[6]
+    id_valid_raw = parts[8] if len(parts) > 8 else ""
+
+    # -------------------------------
+    # 2. 证件号加掩码（如页面显示一致）
+    # -------------------------------
+    # if len(id_no_raw) >= 8:
+    #     id_no_masked = id_no_raw[:6] + "****" + id_no_raw[-4:]
+    # else:
+    #     id_no_masked = id_no_raw
+
+    # -------------------------------
+    # 3. 出生日期格式化 1947/2/24 → 1947-02-24
+    # -------------------------------
+    def fmt_date(value: str) -> str:
+        try:
+            dt = datetime.strptime(value.split(" ")[0], "%Y/%m/%d")
+            return dt.strftime("%Y-%m-%d")
+        except (Exception,):
+            return ""
+
+    birth = fmt_date(birth_raw)
+    id_valid = fmt_date(id_valid_raw)
+
+    # -------------------------------
+    # 4. 年龄计算
+    # -------------------------------
+    def calc_age(birth_str: str) -> Optional[int]:
+        try:
+            birthday = datetime.strptime(birth_str, "%Y-%m-%d")
+            today = datetime.today()
+            return today.year - birthday.year - ((today.month, today.day) < (birthday.month, birthday.day))
+        except (Exception,):
+            return None
+
+    age = calc_age(birth)
+
+    # -------------------------------
+    # 5. 类型（成人/儿童）需要从页面中取
+    # -------------------------------
+    type_span = raw.find(name="span", text=re.compile(r"(成人|儿童|婴儿)"))
+    ptype = ""
+    if type_span:
+        ptype = type_span.get_text(strip=True).replace("【", "").replace("】", "")
+
+    # -------------------------------
+    # 6. 国籍、签发国 从 name="guobie" 的两个 span 获取
+    # -------------------------------
+    guobies = raw.find_all("span", attrs={"name": "guobie"})
+    nationality = guobies[0].get_text(strip=True) if len(guobies) > 0 else ""
+    issue_country = guobies[1].get_text(strip=True) if len(guobies) > 1 else ""
+
+    return {
+        get_key_by_index(index=0, ordered_dict=headers): name,  # 姓名
+        get_key_by_index(index=1, ordered_dict=headers): ptype,  # 类型: 成人/儿童
+        get_key_by_index(index=2, ordered_dict=headers): id_type,  # 证件类型
+        get_key_by_index(index=3, ordered_dict=headers): id_no_raw,  # 身份证
+        get_key_by_index(index=4, ordered_dict=headers): birth,  # 出生年月
+        get_key_by_index(index=5, ordered_dict=headers): age,  # 年龄
+        get_key_by_index(index=6, ordered_dict=headers): sex,  # 性别
+        get_key_by_index(index=7, ordered_dict=headers): nationality,  # 国籍
+        get_key_by_index(index=8, ordered_dict=headers): issue_country,  # 签发国
+        get_key_by_index(index=9, ordered_dict=headers): id_valid  # 证件有效期
+    }
+
+
+def parse_order_flight_table_row(
+        tr: Tag, headers: OrderedDict, extend_headers: OrderedDict
+) -> Dict[str, Any]:
+    """解析航班表每一行的数据"""
+    tds = tr.find_all("td", recursive=False)
+    values = {}
+
+    for idx, td in enumerate(tds):
+        if idx >= len(headers):
+            continue
+
+        key = get_key_by_index(ordered_dict=headers, index=idx)
+        value = get_value_by_index(ordered_dict=headers, index=idx)
+        # 如果是 “乘客信息” → 使用结构化解析
+        if "乘客" in value or "乘客信息" in value:
+            passenger_info = parse_order_flight_table_passenger_info(raw=td, headers=extend_headers)
+            values.update(passenger_info)
+        else:
+            raw = clean_order_flight_table(html=td)
+            if "行程" in value:
+                code_dep_key = get_key_by_index(index=10, ordered_dict=extend_headers)
+                code_arr_key = get_key_by_index(index=11, ordered_dict=extend_headers)
+                raw_slice = raw.split("-")
+                if len(raw_slice) == 2:
+                    values[code_dep_key] = raw_slice[0]
+                    values[code_arr_key] = raw_slice[-1]
+            elif "PNR" in value:
+                values[key] = raw
+            else:
+                values[key] = safe_convert_advanced(raw)
+
+    return values
+
+
+def extract_structured_table_data(table: Tag) -> List[Optional[Dict[str, Any]]]:
+    """提取结构化的表格数据"""
+    # headers = parse_order_flight_table_headers(html=table)
+    headers = flight_static_headers()
+    extend = flight_extend_headers()
+    rows = list()
+    for tr in table.find_all("tr")[1:]:  # 跳过表头
+        rows.append(parse_order_flight_table_row(tr=tr, headers=headers, extend_headers=extend))
+
+    return rows
+
+
+def parser_order_flight_table(html: str) -> List[Optional[Dict[str, Any]]]:
+    """解析航班表"""
+    soup = BeautifulSoup(html, 'html.parser')
+    # 三个主要的order_sort div
+    order_sections = soup.find_all('div', class_='order_sort')
+    section = order_sections[3] if len(order_sections) > 3 else Tag(name="")
+    results = list()
+
+    tables = section.find_all('table', class_='table table_border table_center')
+    for table in tables:
+        table_data = extract_structured_table_data(table)
+        if table_data:
+            results.extend(table_data)
+
+    return results