mns-common 1.3.9.9__py3-none-any.whl → 1.6.1.4__py3-none-any.whl

mns_common/component/proxies/proxy_common_api.py

@@ -12,79 +12,89 @@ import mns_common.utils.data_frame_util as data_frame_util
 from mns_common.db.MongodbUtil import MongodbUtil
 import mns_common.constant.db_name_constant as db_name_constant
 import datetime
-import requests
 import time
 from loguru import logger
 from functools import lru_cache
+import mns_common.api.em.real_time.east_money_stock_a_api as east_money_stock_a_api
+import threading
 
 mongodb_util = MongodbUtil('27017')
 
+IP_POOL = 'ip_pool'
+ONE_IP = 'one_ip'
+query_one = {'ip_type': ONE_IP}
+query_pool = {'ip_type': IP_POOL}
+
 
 def query_liu_guan_proxy_ip():
-    ip_proxy_pool = mongodb_util.find_all_data(db_name_constant.IP_PROXY_POOL)
+    ip_proxy_pool = mongodb_util.find_query_data(db_name_constant.IP_PROXY_POOL, query_one)
     return ip_proxy_pool
 
 
-def remove_proxy_ip():
-    mongodb_util.remove_data({}, db_name_constant.IP_PROXY_POOL)
+def remove_one_proxy_ip():
+    mongodb_util.remove_data(query_one, db_name_constant.IP_PROXY_POOL)
 
 
 def check_valid(ip_proxy_pool):
     effect_time = list(ip_proxy_pool['effect_time'])[0]
-
     now_date = datetime.datetime.now()
-
     str_now_date = now_date.strftime('%Y-%m-%d %H:%M:%S')
-
     if effect_time > str_now_date:
         return True
     else:
-        remove_proxy_ip()
+        remove_one_proxy_ip()
         return False
 
 
 @lru_cache(maxsize=None)
 def get_account_cache():
-    query = {"type": "liu_guan_proxy", }
+    query = {"type": "liu_guan_proxy"}
     return mongodb_util.find_query_data(db_name_constant.STOCK_ACCOUNT_INFO, query)
 
 
 def generate_proxy_ip_api(minutes):
-    stock_account_info = get_account_cache()
-    order_id = list(stock_account_info['password'])[0]
-    secret = list(stock_account_info['account'])[0]
-    # 获取10分钟动态ip
-    ip = liu_guan_proxy_api.get_proxy_api(order_id, secret, str(60 * minutes))
-    return ip
+    try_numer = 3
+    while try_numer > 0:
+        try:
+            stock_account_info = get_account_cache()
+            order_id = list(stock_account_info['password'])[0]
+            secret = list(stock_account_info['account'])[0]
+            # 获取10分钟动态ip
+            liu_guan_ip = liu_guan_proxy_api.get_proxy_api(order_id, secret, str(60 * minutes))
+            try_numer = try_numer
+            logger.info("生成新的ip:{}", liu_guan_ip)
+            return liu_guan_ip
+        except BaseException as e:
+            logger.error("获取ip失败:{}", str(e))
+            time.sleep(1)
+            continue
 
 
 def generate_proxy_ip(minutes):
-    ip_proxy_pool = mongodb_util.find_all_data(db_name_constant.IP_PROXY_POOL)
+    ip_proxy_pool = query_liu_guan_proxy_ip()
     if data_frame_util.is_not_empty(ip_proxy_pool):
         return list(ip_proxy_pool['ip'])[0]
     else:
-        remove_proxy_ip()
+        remove_one_proxy_ip()
         now_date = datetime.datetime.now()
         # 加上分钟
         time_to_add = datetime.timedelta(minutes=minutes)
         new_date = now_date + time_to_add
         str_now_date = new_date.strftime('%Y-%m-%d %H:%M:%S')
+        try:
+            ip_proxy = generate_proxy_ip_api(minutes)
 
-        # 获取10分钟动态ip
-        while True:
-            ip = generate_proxy_ip_api(minutes)
-            if check_proxy(ip, timeout=2):
-                break
-            else:
-                time.sleep(0.5)
-        result_dict = {"_id": ip,
-                       'effect_time': str_now_date,
-                       'ip': ip}
-        result_df = pd.DataFrame(result_dict, index=[1])
+            result_dict = {"_id": ip_proxy,
+                           'ip_type': ONE_IP,
+                           'effect_time': str_now_date,
+                           'ip': ip_proxy}
+            result_df = pd.DataFrame(result_dict, index=[1])
 
-        mongodb_util.insert_mongo(result_df, db_name_constant.IP_PROXY_POOL)
+            mongodb_util.insert_mongo(result_df, db_name_constant.IP_PROXY_POOL)
+        except BaseException as e:
+            logger.error("获取ip失败:{}", str(e))
 
-        return ip
+        return ip_proxy
 
 
 def get_proxy_ip(minutes):
@@ -98,95 +108,145 @@ def get_proxy_ip(minutes):
             return generate_proxy_ip(minutes)
 
 
-def check_baidu_proxy(proxy_ip, timeout=2):
-    """
-    检测代理IP是否能访问百度
-    :param proxy_ip: 代理IP地址
-    :param proxy_port: 代理端口
-    :param timeout: 超时时间(秒)
-    :return: (是否可用, 响应时间, 检测结果信息)
-    """
-    # 构造代理地址
+#
+# def check_proxy(proxy_ip):
+#     try:
+#         # 两秒超时
+#         test_df = call_with_timeout(get_em_real_time_data, proxy_ip, timeout=2)
+#         if data_frame_util.is_not_empty(test_df):
+#             logger.info("可用代理ip:{}", proxy_ip)
+#             return True
+#         else:
+#             return False
+#     except Exception as e:
+#         logger.error("代理ip不可用:{},{}", proxy_ip, e)
+#         return False
+
+
+# 查询ip池子
+def query_liu_guan_proxy_ip_pool():
+    ip_proxy_pool = mongodb_util.find_query_data(db_name_constant.IP_PROXY_POOL, query_pool)
+    return ip_proxy_pool
 
-    # 设置代理参数
-    proxies = {
-        "http": proxy_ip,
-        "https": proxy_ip
-    }
 
-    # 模拟浏览器请求头
-    headers = {
-        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
-        "Accept-Language": "zh-CN,zh;q=0.9",
-        "Connection": "keep-alive"
-    }
+def remove_proxy_ip_pool():
+    mongodb_util.remove_data(query_pool, db_name_constant.IP_PROXY_POOL)
+
+
+def generate_proxy_ip_pool_api(minutes, ip_num):
+    stock_account_info = get_account_cache()
+    order_id = list(stock_account_info['password'])[0]
+    secret = list(stock_account_info['account'])[0]
+    # 获取10分钟动态ip
+    ip_pool = liu_guan_proxy_api.get_proxy_pool_api(order_id, secret, str(60 * minutes), ip_num)
+    return ip_pool
 
-    try:
-        # 记录开始时间
-        start_time = time.time()
-
-        # 发送请求到百度
-        response = requests.get(
-            url="https://www.baidu.com",
-            proxies=proxies,
-            headers=headers,
-            timeout=timeout,
-            allow_redirects=True  # 允许重定向
-        )
-
-        # 计算响应时间
-        response_time = round((time.time() - start_time) * 1000)  # 毫秒
-        # 检查响应状态和内容
-        if response.status_code == 200:
-            # 验证是否返回百度页面
-            if "百度一下" in response.text and "baidu.com" in response.text:
-                logger.info("代理ip可用:{},响应时间:{}", proxy_ip, response_time)
-                return True
-            else:
-                logger.error("代理ip不可用:{},响应时间:{}", proxy_ip, response_time)
-                return False
+
+def get_proxy_ip_pool(minutes, seconds, ip_num):
+    ip_proxy_pool = query_liu_guan_proxy_ip_pool()
+    if data_frame_util.is_empty(ip_proxy_pool):
+        return generate_proxy_ip_pool(minutes, seconds, ip_num)
+    else:
+        if check_valid(ip_proxy_pool):
+            ip_pool = list(ip_proxy_pool['ip_pool'])[0]
+            effect_time = list(ip_proxy_pool['effect_time'])[0]
+            result = {'ip_pool': ip_pool,
+                      'effect_time': effect_time}
+            return result
         else:
-            logger.error("代理ip不可用:{},响应时间:{},HTTP状态码异常:{}", proxy_ip, response_time, response.status_code)
-            return False
-    except requests.exceptions.ConnectTimeout:
-        logger.error("代理ip不可用:{},连接超时", proxy_ip, response_time)
-        return False
-    except requests.exceptions.ProxyError:
-        logger.error("代理ip不可用:{},代理拒绝连接", proxy_ip, response_time)
-        return False
-    except requests.exceptions.SSLError:
-        logger.error("代理ip不可用:{},SSL证书错误", proxy_ip, response_time)
-        return False
-    except requests.exceptions.RequestException as e:
-        logger.error("代理ip不可用:{},网络错误:{}", proxy_ip, str(e))
-        return False
+            # 已经失效 移除ip pool
+            remove_proxy_ip_pool()
+            # 重新生成
+            return generate_proxy_ip_pool(minutes, seconds, ip_num)
+
+
+# seconds 有效秒数,minutes 需要减1
+def generate_proxy_ip_pool(minutes, seconds, ip_num):
+    ip_proxy_pool = query_liu_guan_proxy_ip_pool()
+    if data_frame_util.is_not_empty(ip_proxy_pool):
+        ip_pool = list(ip_proxy_pool['ip_pool'])[0]
+        effect_time = list(ip_proxy_pool['effect_time'])[0]
+
+
+    else:
+        remove_proxy_ip_pool()
+        now_date = datetime.datetime.now()
+        # 加上分钟 少10秒
+        time_to_add = datetime.timedelta(minutes=minutes - 1, seconds=seconds)
+        new_date = now_date + time_to_add
+        effect_time = new_date.strftime('%Y-%m-%d %H:%M:%S')
+        ip_pool = generate_proxy_ip_pool_api(minutes, ip_num)
+        result_dict = {
+            "_id": [IP_POOL],
+            'ip_type': [IP_POOL],
+            'effect_time': [effect_time],
+            'ip_pool': [ip_pool]  # 每个字段都包装成列表
+        }
+        result_df = pd.DataFrame(result_dict)
+
+        mongodb_util.insert_mongo(result_df, db_name_constant.IP_PROXY_POOL)
+    result = {'ip_pool': ip_pool,
+              'effect_time': effect_time}
+    return result
 
 
-def check_proxy(proxy_ip, timeout=2):
+def get_em_real_time_data(proxy_ip):
     proxies = {
         "http": proxy_ip,
         "https": proxy_ip
     }
-    try:
-        # 测试请求（httpbin.org 返回请求的IP）
-        response = requests.get(
-            "http://httpbin.org/ip",
-            proxies=proxies,
-            timeout=timeout  # 超时时间
-        )
-        if response.status_code == 200:
-            return True
-        else:
-            logger.error("代理ip不可用:{}", proxy_ip)
-            return False
-    except Exception as e:
-        logger.error("代理ip不可用:{},{}", proxy_ip, e)
-        return False
+    return east_money_stock_a_api.get_stock_page_data(1, proxies, 20, 10)
+
+
+# 定义一个带超时的函数调用
+def call_with_timeout(func, *args, timeout=2, **kwargs):
+    # 用于存储函数执行结果
+    result = None
+    exception = None
+
+    # 定义一个线程目标函数
+    def target():
+        nonlocal result, exception
+        try:
+            result = func(*args, **kwargs)
+        except Exception as e:
+            exception = e
+
+    # 创建线程并启动
+    thread = threading.Thread(target=target)
+    thread.start()
+
+    # 等待线程完成，最多等待 timeout 秒
+    thread.join(timeout)
+
+    # 如果线程仍然存活，说明函数超时了
+    if thread.is_alive():
+        raise TimeoutError(f"Function exceeded timeout of {timeout} seconds")
+
+    # 如果函数抛出了异常，重新抛出
+    if exception is not None:
+        raise exception
+    return result
+
+
+@lru_cache(maxsize=None)
+def query_province_and_city_info():
+    return mongodb_util.find_all_data(db_name_constant.IP_PROXY_CITY_PROVINCE)
+
+
+def import_province_and_city():
+    # 设置文件夹路径
+    folder_path = r'E:\province-and-city.xlsx'
+    df = pd.read_excel(folder_path)
+    df['_id'] = df['cid']
+
+    mongodb_util.save_mongo(df, db_name_constant.IP_PROXY_CITY_PROVINCE)
+    return df
 
 
 if __name__ == "__main__":
-    target_ip = "112.28.228.67:35528"  # Google DNS
-    if check_proxy(target_ip, 2):
-        print(f"{target_ip} 可以访问")
-    else:
-        print(f"{target_ip} 无法访问")
+    stock_account_info_test = get_account_cache()
+    order_id_test = list(stock_account_info_test['password'])[0]
+    secret_test = list(stock_account_info_test['account'])[0]
+    # 获取10分钟动态ip
+    ip = liu_guan_proxy_api.get_proxy_api(order_id_test, secret_test, str(60 * 1))

mns_common/component/tfp/stock_tfp_api.py

@@ -5,7 +5,6 @@ file_path = os.path.abspath(__file__)
 end = file_path.index('mns') + 16
 project_path = file_path[0:end]
 sys.path.append(project_path)
-import akshare as ak
 import mns_common.utils.date_handle_util as date_handle_util
 from loguru import logger
 import mns_common.utils.data_frame_util as data_frame_util
@@ -15,20 +14,87 @@ import mns_common.constant.db_name_constant as db_name_constant
 
 mongodb_util = MongodbUtil('27017')
 
+"""
+Date: 2024/4/29 15:00
+Desc: 东方财富网-数据中心-特色数据-停复牌信息
+https://data.eastmoney.com/tfpxx/
+"""
+
+import pandas as pd
+import requests
+
+
+def stock_tfp_em(date: str = "20240426") -> pd.DataFrame:
+    """
+    东方财富网-数据中心-特色数据-停复牌信息
+    https://data.eastmoney.com/tfpxx/
+    :param date: specific date as "2020-03-19"
+    :type date: str
+    :return: 停复牌信息表
+    :rtype: pandas.DataFrame
+    """
+    url = "https://datacenter-web.eastmoney.com/api/data/v1/get"
+    params = {
+        "sortColumns": "SUSPEND_START_DATE",
+        "sortTypes": "-1",
+        "pageSize": "500",
+        "pageNumber": "1",
+        "reportName": "RPT_CUSTOM_SUSPEND_DATA_INTERFACE",
+        "columns": "ALL",
+        "source": "WEB",
+        "client": "WEB",
+        "filter": f"""(MARKET="全部")(DATETIME='{"-".join([date[:4], date[4:6], date[6:]])}')""",
+    }
+    r = requests.get(url, params=params)
+    data_json = r.json()
+    total_page = data_json["result"]["pages"]
+    big_df = pd.DataFrame()
+    for page in range(1, total_page + 1):
+        params.update({"pageNumber": page})
+        r = requests.get(url, params=params)
+        data_json = r.json()
+        temp_df = pd.DataFrame(data_json["result"]["data"])
+        big_df = pd.concat(objs=[big_df, temp_df], ignore_index=True)
+
+    big_df.reset_index(inplace=True)
+
+    big_df["SUSPEND_START_TIME"] = pd.to_datetime(big_df["SUSPEND_START_TIME"], errors="coerce").dt.date
+    big_df["SUSPEND_END_TIME"] = pd.to_datetime(
+        big_df["SUSPEND_END_TIME"], errors="coerce"
+    ).dt.date
+
+    big_df["SUSPEND_START_DATE"] = pd.to_datetime(
+        big_df["SUSPEND_START_DATE"], errors="coerce"
+    ).dt.date
+    big_df["PREDICT_RESUME_DATE"] = pd.to_datetime(
+        big_df["PREDICT_RESUME_DATE"], errors="coerce"
+    ).dt.date
+
+    big_df = big_df[['index', 'SECURITY_CODE', 'SECURITY_NAME_ABBR', 'SUSPEND_START_TIME',
+                     'SUSPEND_END_TIME', 'SUSPEND_EXPIRE', 'SUSPEND_REASON', 'TRADE_MARKET',
+                     'SUSPEND_START_DATE',
+                     'PREDICT_RESUME_DATE'
+                     ]]
+
+    return big_df
+
 
 def get_stock_tfp_by_day(str_day):
-    stock_tfp_em_df = ak.stock_tfp_em(date_handle_util.no_slash_date(str_day))
+    stock_tfp_em_df = stock_tfp_em(date_handle_util.no_slash_date(str_day))
     stock_tfp_em_df = stock_tfp_em_df.rename(
-        columns={'序号': 'index',
-                 '代码': 'symbol',
-                 '名称': 'name',
-                 '停牌时间': 'sus_begin_time',
-                 '停牌截止时间': 'sus_end_time',
-                 '停牌截止时间': 'sus_end_time',
-                 '停牌期限': 'sus_period',
-                 '停牌原因': 'sus_reason',
-                 '所属市场': 'market',
-                 '预计复牌时间': 'resume_time'
+        columns={'index': 'index',
+                 'SECURITY_CODE': 'symbol',
+                 'SECURITY_NAME_ABBR': 'name',
+                 'SUSPEND_START_TIME': 'sus_begin_time',
+                 'SUSPEND_END_TIME': 'sus_end_time',
+
+                 'SUSPEND_START_DATE': 'sus_begin_date',
+                 'PREDICT_RESUME_DATE': 'resume_time',
+
+                 'SUSPEND_EXPIRE': 'sus_period',
+                 'SUSPEND_REASON': 'sus_reason',
+                 'TRADE_MARKET': 'market',
+
                  })
     return stock_tfp_em_df
 
@@ -60,3 +126,7 @@ def get_stock_tfp_symbol_from_db(str_day):
     except BaseException as e:
         logger.error("获取停牌信息异常:{}", e)
         return ['666666']
+
+
+if __name__ == '__main__':
+    get_stock_tfp_symbol_list_by_day('2025-06-21')

mns_common/component/us/__init__.py

@@ -0,0 +1,7 @@
+import sys
+import os
+
+file_path = os.path.abspath(__file__)
+end = file_path.index('mns') + 16
+project_path = file_path[0:end]
+sys.path.append(project_path)

mns_common/component/us/us_stock_etf_info_api.py

@@ -0,0 +1,130 @@
+import sys
+import os
+
+file_path = os.path.abspath(__file__)
+end = file_path.index('mns') + 21
+project_path = file_path[0:end]
+sys.path.append(project_path)
+from loguru import logger
+import csv
+import requests
+import pandas as pd
+import mns_common.component.em.em_stock_info_api as em_stock_info_api
+from functools import lru_cache
+import mns_common.utils.data_frame_util as data_frame_util
+
+
+@lru_cache()
+def get_us_stock_info():
+    # 东财美股列表
+    em_us_stock_info_df = em_stock_info_api.get_us_stock_info()
+    em_us_stock_info_df['symbol'] = em_us_stock_info_df['symbol'].str.replace('_', '-')
+    em_us_stock_info_df = em_us_stock_info_df.loc[em_us_stock_info_df['total_mv'] != 0]
+
+    if data_frame_util.is_not_empty(em_us_stock_info_df):
+        em_us_stock_info_df.fillna({'list_date': 10000101}, inplace=True)
+        em_us_stock_info_df = em_us_stock_info_df[['symbol', 'name', 'list_date']]
+
+    # alpha 股票名单
+    alpha_us_stock_info = get_us_alpha_stock_list()
+    alpha_us_stock_info = alpha_us_stock_info.loc[alpha_us_stock_info['assetType'] == 'Stock']
+    if data_frame_util.is_not_empty(alpha_us_stock_info):
+        alpha_us_stock_info.fillna({'list_date': '1000-01-01'}, inplace=True)
+        alpha_us_stock_info = alpha_us_stock_info[['symbol', 'name', 'list_date']]
+
+        alpha_us_stock_info['list_date'] = alpha_us_stock_info['list_date'].astype(str).str.replace('-', '').astype(int)
+
+    us_stock_result_df = pd.concat([alpha_us_stock_info, em_us_stock_info_df])
+    us_stock_result_df.drop_duplicates(subset=['symbol'], inplace=True)
+
+    return us_stock_result_df
+
+
+@lru_cache()
+def get_us_etf_info():
+    us_etf_info_df = em_stock_info_api.get_us_etf_info()
+    if data_frame_util.is_not_empty(us_etf_info_df):
+        us_etf_info_df.fillna({'list_date': 10000101}, inplace=True)
+        us_etf_info_df = us_etf_info_df[['symbol', 'name', 'list_date']]
+
+    # alpha ETF名单
+    alpha_us_etf_info = get_us_alpha_stock_list()
+    alpha_us_etf_info = alpha_us_etf_info.loc[alpha_us_etf_info['assetType'] == 'ETF']
+    if data_frame_util.is_not_empty(alpha_us_etf_info):
+        alpha_us_etf_info.fillna({'list_date': '1000-01-01'}, inplace=True)
+        alpha_us_etf_info = alpha_us_etf_info[['symbol', 'name', 'list_date']]
+
+        alpha_us_etf_info['list_date'] = alpha_us_etf_info['list_date'].astype(str).str.replace('-', '').astype(int)
+    us_etf_result_df = pd.concat([us_etf_info_df, alpha_us_etf_info])
+    us_etf_result_df.drop_duplicates(subset=['symbol'], inplace=True)
+
+    return us_etf_result_df
+
+
+# 退市 https://www.alphavantage.co/query?function=LISTING_STATUS&date=2012-07-10&state=delisted&apikey=QODR3TBYB2U4M9YR
+@lru_cache()
+def get_us_alpha_stock_list(apikey):
+    try:
+        # replace the "demo" apikey below with your own key from https://www.alphavantage.co/support/#api-key
+        CSV_URL = 'https://www.alphavantage.co/query?function=LISTING_STATUS&apikey=' + apikey
+        with requests.Session() as s:
+            download = s.get(CSV_URL)
+            decoded_content = download.content.decode('utf-8')
+            cr = csv.reader(decoded_content.splitlines(), delimiter=',')
+            my_list = list(cr)
+            # 提取列名（第1行）
+            columns = my_list[0]
+            # 提取数据（第2行及以后）
+            values = my_list[1:]
+
+            # 转换为 DataFrame
+            df = pd.DataFrame(values, columns=columns)
+            df = df.rename(columns={'ipoDate': 'list_date'})
+            if data_frame_util.is_not_empty(df):
+                df.to_csv(r'D:\mns\mns-common\mns_common\component\us\listing_status.csv', index=False, encoding='gbk')
+            else:
+                df = pd.read_csv(r'D:\mns\mns-common\mns_common\component\us\listing_status.csv', encoding='utf-8')
+            return df
+    except BaseException as e:
+        logger.error("下载出现异常:{},", e)
+        df = pd.read_csv(r'D:\mns\mns-common\mns_common\component\us\listing_status.csv', encoding='utf-8')
+        df = df.rename(columns={'ipoDate': 'list_date'})
+        return df
+
+
+def get_us_alpha_stock_de_list(apikey):
+    try:
+        # replace the "demo" apikey below with your own key from https://www.alphavantage.co/support/#api-key
+        CSV_URL = 'https://www.alphavantage.co/query?function=LISTING_STATUS&state=delisted&apikey=' + apikey
+        with requests.Session() as s:
+            download = s.get(CSV_URL)
+            decoded_content = download.content.decode('utf-8')
+            cr = csv.reader(decoded_content.splitlines(), delimiter=',')
+            my_list = list(cr)
+            # 提取列名（第1行）
+            columns = my_list[0]
+            # 提取数据（第2行及以后）
+            values = my_list[1:]
+
+            # 转换为 DataFrame
+            df = pd.DataFrame(values, columns=columns)
+            df = df.rename(columns={'ipoDate': 'list_date'})
+            if data_frame_util.is_not_empty(df):
+                df.to_csv(r'D:\mns\mns-common\mns_common\component\us\de_list_status.csv', index=False, encoding='gbk')
+            else:
+                df = pd.read_csv(r'D:\mns\mns-common\mns_common\component\us\de_list_status.csv', encoding='utf-8')
+            return df
+    except BaseException as e:
+        logger.error("下载出现异常:{},", e)
+        df = pd.read_csv(r'D:\mns\mns-common\mns_common\component\us\de_list_status.csv', encoding='utf-8')
+        df = df.rename(columns={'ipoDate': 'list_date'})
+        return df
+
+
+if __name__ == '__main__':
+    # get_us_alpha_stock_de_list()
+    get_us_alpha_stock_de_list()
+    df_test = get_us_stock_info()
+    df_test.drop_duplicates(subset=['symbol'], inplace=True)
+    print(df_test)
+    get_us_alpha_stock_de_list()