webull-openapi-python-sdk 1.0.6__tar.gz → 1.0.8__tar.gz

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webull-openapi-python-sdk
-Version: 1.0.6
+Version: 1.0.8
 Summary: Webull Python SDK.
 Home-page: 
 Author: Webull

webull_openapi_python_sdk-1.0.8/samples/__init__.py

@@ -0,0 +1 @@
+__version__ = '1.0.8'

webull_openapi_python_sdk-1.0.8/samples/account/account_client.py

@@ -0,0 +1,42 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import uuid
+from time import sleep
+
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    res = trade_client.account_v2.get_account_list()
+    if res.status_code == 200:
+        print('get account list:', res.json())

webull_openapi_python_sdk-1.0.8/samples/assets/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

webull_openapi_python_sdk-1.0.8/samples/assets/assets_client.py

@@ -0,0 +1,47 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import uuid
+from time import sleep
+
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    res = trade_client.account_v2.get_account_balance(account_id)
+    if res.status_code == 200:
+        print('get account balance info:', res.json())
+
+    res = trade_client.account_v2.get_account_position(account_id)
+    if res.status_code == 200:
+        print('get account positions info:', res.json())
+

webull_openapi_python_sdk-1.0.8/samples/data/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/data/data_client.py

@@ -24,9 +24,16 @@ optional_api_endpoint = "<api_endpoint>"
 your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
+
 if __name__ == '__main__':
     data_client = DataClient(api_client)
 

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/data/data_streaming_client.py

@@ -27,6 +27,11 @@ your_app_secret = "</your_app_secret>"
 optional_api_endpoint = "</optional_quotes_endpoint>"
 optional_quotes_endpoint = "</optional_quotes_endpoint>"
 region_id = '<region_id>'
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# data_streaming_client.set_token_dir(token_dir)
 
 session_id = uuid.uuid4().hex
 data_streaming_client = DataStreamingClient(your_app_key, your_app_secret, region_id, session_id,

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/data/data_streaming_client_async.py

@@ -27,6 +27,11 @@ your_app_secret = "</your_app_secret>"
 optional_api_endpoint = "</optional_quotes_endpoint>"
 optional_quotes_endpoint = "</optional_quotes_endpoint>"
 region_id = '<region_id>'
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# data_streaming_client.set_token_dir(token_dir)
 
 session_id = uuid.uuid4().hex
 data_streaming_client = DataStreamingClient(your_app_key, your_app_secret, region_id, session_id,

webull_openapi_python_sdk-1.0.8/samples/order/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

webull_openapi_python_sdk-1.0.8/samples/order/order_option_client.py

@@ -0,0 +1,92 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import uuid
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+    # Options
+    # For option order inquiries, please use the V2 query interface: api.order_v2.get_order_detail(account_id, client_order_id).
+    client_order_id = uuid.uuid4().hex
+    option_new_orders = [
+        {
+            "client_order_id": client_order_id,
+            "combo_type": "NORMAL",
+            "order_type": "LIMIT",
+            "quantity": "1",
+            "limit_price": "21.25",
+            "option_strategy": "SINGLE",
+            "side": "BUY",
+            "time_in_force": "GTC",
+            "entrust_type": "QTY",
+            "legs": [
+                {
+                    "side": "BUY",
+                    "quantity": "1",
+                    "symbol": "TSLA",
+                    "strike_price": "400",
+                    "option_expire_date": "2025-12-26",
+                    "instrument_type": "OPTION",
+                    "option_type": "CALL",
+                    "market": "US"
+                }
+            ]
+        }
+    ]
+
+    # preview
+    res = trade_client.order_v2.preview_option(account_id, option_new_orders)
+    if res.status_code == 200:
+        print("preview option res:", res.json())
+
+    # place
+    res = trade_client.order_v2.place_option(account_id, option_new_orders)
+    if res.status_code == 200:
+        print("place option res:" , res.json())
+
+    option_modify_orders = [
+        {
+            "client_order_id": client_order_id,
+            "quantity": "2",
+            "limit_price": "21.25"
+        }
+    ]
+    res = trade_client.order_v2.replace_option(account_id, option_modify_orders)
+    if res.status_code == 200:
+        print("Replace option order res:" , res.json())
+
+    res = trade_client.order_v2.cancel_option(account_id, client_order_id)
+    if res.status_code == 200:
+        print("Cancel option order res:" , res.json())
+
+    res = trade_client.order_v2.get_order_detail(account_id, client_order_id)
+    if res.status_code == 200:
+        print("Option order detail order res:" , res.json())

webull_openapi_python_sdk-1.0.8/samples/order/order_stock_client.py

@@ -0,0 +1,95 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import uuid
+from webull.core.client import ApiClient
+from webull.trade.trade_client import TradeClient
+
+optional_api_endpoint = "<api_endpoint>"
+your_app_key = "<your_app_key>"
+your_app_secret = "<your_app_secret>"
+region_id = "<region_id>" # hk or us
+account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
+api_client = ApiClient(your_app_key, your_app_secret, region_id)
+api_client.add_endpoint(region_id, optional_api_endpoint)
+
+
+if __name__ == '__main__':
+    trade_client = TradeClient(api_client)
+
+
+    # simple order
+    client_order_id = uuid.uuid4().hex
+    print('client order id:', client_order_id)
+    new_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "symbol": "BULL",
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "order_type": "LIMIT",
+            "limit_price": "26",
+            "quantity": "1",
+            "support_trading_session": "CORE",
+            "side": "BUY",
+            "time_in_force": "DAY",
+            "entrust_type": "QTY"
+        }
+    ]
+    new_hk_stock_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "symbol": "00700",
+            "instrument_type": "EQUITY",
+            "market": "HK",
+            "order_type": "ENHANCED_LIMIT",
+            "limit_price": "612",
+            "quantity": "100",
+            "side": "BUY",
+            "time_in_force": "DAY",
+            "entrust_type": "QTY"
+        }
+    ]
+    res = trade_client.order_v2.preview_order(account_id, new_simple_orders)
+    if res.status_code == 200:
+        print('preview order res:', res.json())
+
+    res = trade_client.order_v2.place_order(account_id, new_simple_orders)
+    if res.status_code == 200:
+        print('place order res:', res.json())
+
+    modify_simple_orders = [
+        {
+            "client_order_id": client_order_id,
+            "quantity": "2",
+            "limit_price": "25"
+        }
+    ]
+    res = trade_client.order_v2.replace_order(account_id, modify_simple_orders)
+    if res.status_code == 200:
+        print('replace order res:', res.json())
+
+    res = trade_client.order_v2.cancel_order(account_id, client_order_id)
+    if res.status_code == 200:
+        print('cancel order res:', res.json())
+
+    res = trade_client.order_v2.get_order_detail(account_id, client_order_id)
+    if res.status_code == 200:
+        print('order detail:', res.json())

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/trade/trade_client.py

@@ -25,6 +25,12 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/trade/trade_client_v2.py

@@ -24,10 +24,15 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
-
 if __name__ == '__main__':
     trade_client = TradeClient(api_client)
 

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/samples/trade/trade_client_v3.py

@@ -24,6 +24,12 @@ your_app_key = "<your_app_key>"
 your_app_secret = "<your_app_secret>"
 region_id = "<region_id>"
 account_id = "<your_account_id>"
+# The token_dir parameter can be used to specify the directory for storing the 2FA token. Both absolute and relative paths are supported and this option has the highest priority.
+# Alternatively, the storage directory can be configured via an environment variable with the key WEBULL_OPENAPI_TOKEN_DIR, which also supports both absolute and relative paths.
+# If neither is specified, the default configuration will be used, and the token will be stored at conf/token.txt under the current working directory.
+# token_dir = "<your_token_dir>"
+# api_client.set_token_dir(token_dir)
+
 api_client = ApiClient(your_app_key, your_app_secret, region_id)
 api_client.add_endpoint(region_id, optional_api_endpoint)
 
@@ -202,7 +208,38 @@ if __name__ == '__main__':
     if res.status_code == 200:
         print('get master order detail res:', res.json())
 
-
+    # batch place order
+    batch_place_orders = [
+        {
+            "combo_type": "NORMAL",
+            "client_order_id": uuid.uuid4().hex,
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "symbol": "AAPL",
+            "order_type": "MARKET",
+            "entrust_type": "QTY",
+            "support_trading_session": "CORE",
+            "time_in_force": "DAY",
+            "side": "BUY",
+            "quantity": "1"
+        },
+        {
+            "combo_type": "NORMAL",
+            "client_order_id": uuid.uuid4().hex,
+            "instrument_type": "EQUITY",
+            "market": "US",
+            "symbol": "TESL",
+            "order_type": "MARKET",
+            "entrust_type": "QTY",
+            "support_trading_session": "CORE",
+            "time_in_force": "DAY",
+            "side": "BUY",
+            "quantity": "1"
+        }
+    ]
+    res = trade_client.order_v3.batch_place_order(account_id, batch_place_orders)
+    if res.status_code == 200:
+        print('batch place normal equity order res:', res.json())
 
 
     # ============================================================

webull_openapi_python_sdk-1.0.8/webull/__init__.py

@@ -0,0 +1 @@
+__version__ = '1.0.8'

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/webull/core/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '1.0.6'
+__version__ = '1.0.8'
 
 import logging
 

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/webull/core/client.py

@@ -122,6 +122,7 @@ class ApiClient:
         self._token_check_duration_seconds = token_check_duration_seconds
         validation.assert_integer_positive(token_check_interval_seconds, "token_check_interval_seconds")
         self._token_check_interval_seconds = token_check_interval_seconds
+        self._token_dir = None
 
     def get_region_id(self):
         return self._region_id
@@ -164,6 +165,12 @@ class ApiClient:
     def get_token_check_interval_seconds(self):
         return self._token_check_interval_seconds
 
+    def set_token_dir(self, token_dir):
+        self._token_dir = token_dir
+
+    def get_token_dir(self):
+        return self._token_dir
+
     @staticmethod
     def user_agent_header():
         base = '%s (%s %s;%s)' \

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/webull/core/http/initializer/client_initializer.py

@@ -62,7 +62,7 @@ class ClientInitializer:
             if not ClientInitializer._check_token_enable(api_client):
                 return
 
-        token_manager = TokenManager()
+        token_manager = TokenManager(api_client.get_token_dir())
         token_manager.init_token(api_client)
 
     @staticmethod

{webull_openapi_python_sdk-1.0.6 → webull_openapi_python_sdk-1.0.8}/webull/core/http/initializer/token/token_manager.py

@@ -34,11 +34,10 @@
 # coding=utf-8
 
 import logging
-import os
 import time
-from pathlib import Path
 
 from webull.core import compat
+from webull.core.http.initializer.token.token_storage import TokenStorage
 from webull.core.utils import desensitize
 from webull.core.exception.exceptions import ClientException
 from webull.core.http.initializer.token.bean.access_token import AccessToken
@@ -47,13 +46,10 @@ from webull.core.http.initializer.token.token_operation import TokenOperation
 logger = logging.getLogger(__name__)
 
 class TokenManager:
-    TOKEN_FILE_NAME = "conf/token.txt"
-    CONF_ENV_TOKEN_DIR = os.getenv("WEBULL_OPENAPI_TOKEN_DIR")
-    DEFAULT_ENV_TOKEN_DIR = os.getcwd()
 
-    def __init__(self):
-        dir_path = Path(self.CONF_ENV_TOKEN_DIR) if self.CONF_ENV_TOKEN_DIR else Path(self.DEFAULT_ENV_TOKEN_DIR)
-        self.token_file_path = dir_path / self.TOKEN_FILE_NAME
+    def __init__(self, custom_token_dir=None):
+        token_storage = TokenStorage(custom_token_dir=custom_token_dir)
+        self.token_file_path = token_storage.get_token_file_path()
 
     def init_token(self, api_client):
         local_access_token = self.load_token_from_local()
@@ -100,7 +96,7 @@ class TokenManager:
     def save_token_to_local(self, server_access_token):
         try:
             logger.info("save_token_to_local writing token to local file. token:%s expires:%s status:%s",
-                        server_access_token.get("token"), server_access_token.get("expires"), server_access_token.get("status"))
+                        desensitize.desensitize_token(server_access_token.get("token")), server_access_token.get("expires"), server_access_token.get("status"))
             self.token_file_path.parent.mkdir(parents=True, exist_ok=True)
             with open(self.token_file_path, "w", encoding="utf-8") as f:
                 f.write(server_access_token.get("token") + "\n")

webull_openapi_python_sdk-1.0.8/webull/core/http/initializer/token/token_storage.py

@@ -0,0 +1,140 @@
+# Copyright 2022 Webull
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# 	http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+# coding=utf-8
+
+import logging
+import os
+import platform
+import re
+from pathlib import Path
+
+from webull.core.exception.exceptions import ClientException
+
+logger = logging.getLogger(__name__)
+
+class TokenStorage:
+
+    DEFAULT_TOKEN_PATH = "conf"
+    DEFAULT_TOKEN_FILE = "token.txt"
+    DEFAULT_ENV_TOKEN_DIR = "WEBULL_OPENAPI_TOKEN_DIR"
+
+    _INVALID_CHARS = {
+        "windows": re.compile(r'[<>"|?*]'),
+        "posix": re.compile(r'[\0]')
+    }
+
+    def __init__(self, custom_token_dir=None):
+        # Resolve the final storage directory (priority: custom direction > environment variable > default).
+        self.storage_token_dir = self._resolve_dir(custom_token_dir)
+        # Full path validation
+        self._validate_path()
+        # Ensure the directory exists
+        self._ensure_dir_exists()
+        # Full path
+        self.token_file = self.storage_token_dir / self.DEFAULT_TOKEN_FILE
+        logger.info("storage_token initialized path:%s.",self.token_file)
+        # Check file exists
+        self._check_file_exists()
+
+    def _resolve_dir(self, custom_token_dir=None) -> Path:
+        if custom_token_dir and custom_token_dir.strip():
+            # custom direction
+            raw_dir = custom_token_dir.strip()
+            logger.info("storage_token uses the custom configuration, token_dir:%s.", raw_dir)
+        elif env_dir := os.getenv(self.DEFAULT_ENV_TOKEN_DIR):
+            # environment variable
+            raw_dir = env_dir.strip()
+            logger.info("storage_token uses environment variable configuration, %s:%s.", self.DEFAULT_ENV_TOKEN_DIR, raw_dir)
+        else:
+            # default
+            raw_dir = self.DEFAULT_TOKEN_PATH
+            logger.info("storage_token uses the default configuration, %s.", raw_dir)
+
+        # Resolve path
+        normalized_token_dir = Path(raw_dir).expanduser().absolute()
+        return normalized_token_dir
+
+    def _validate_path(self):
+
+        dir_path = self.storage_token_dir
+        os_type = platform.system().lower()
+
+        self._validate_path_syntax(dir_path, os_type)
+        self._validate_path_access(dir_path)
+
+    def _validate_path_syntax(self, path: Path, os_type: str):
+        """Syntax validity check"""
+        invalid_pattern = self._INVALID_CHARS["windows"] if "windows" in os_type else self._INVALID_CHARS["posix"]
+        if invalid_pattern.search(str(path)):
+            msg = ("storage_token path contains illegal characters, path:%s." % (str(path)))
+            logger.warning(msg)
+
+    def _validate_path_access(self, path: Path):
+        """Accessibility/permission check"""
+        if path.exists():
+            if not path.is_dir():
+                msg = ("storage_token path already exists but is not a directory, path:%s." % (str(path)))
+                logger.warning(msg)
+                return
+            if not os.access(path, os.R_OK | os.W_OK):
+                msg = ("storage_token directory has no read/write permission. Please check the configuration, path:%s." % (str(path)))
+                logger.warning(msg)
+        else:
+            parent_dir = path.parent
+            if not parent_dir.exists():
+                msg = ("storage_token parent directory does not exist, unable to create directory. Please check the configuration, parent path:%s." % (str(parent_dir)))
+                logger.warning(msg)
+                return
+            if not os.access(parent_dir, os.R_OK | os.W_OK | os.X_OK):
+                msg = ("storage_token parent directory has no read/write permission. Please check the configuration, parent path:%s." % (str(parent_dir)))
+                logger.warning(msg)
+
+    def _ensure_dir_exists(self):
+        """Ensure the directory exists"""
+        try:
+            self.storage_token_dir.mkdir(parents=True, exist_ok=True)
+        except Exception as e:
+            msg = ("storage_token failed to create directory, file:%s." % (str(self.storage_token_dir)))
+            logger.error(msg)
+            raise ClientException("ERROR_STORAGE_TOKEN", str(e)) from e
+
+    def _check_file_exists(self):
+        """Check file exists"""
+        full_path = Path(self.token_file)
+        if full_path.is_file():
+            msg = ("storage_token Note: The token file already exists, the latest token configuration will be overwritten and written to the token file after successful 2FA verification. path:%s." % self.token_file)
+            logger.warning(msg)
+
+    def get_token_file_path(self):
+        return self.token_file

webull_openapi_python_sdk-1.0.8/webull/data/__init__.py

@@ -0,0 +1,3 @@
+# coding=utf-8
+
+__version__ = '1.0.8'