Skip to content

Commit

Permalink
優化程式碼架構
Browse files Browse the repository at this point in the history
  • Loading branch information
@AlanJui
AlanJui committed Jan 10, 2025
1 parent f797b96 commit bb16592
Show file tree
Hide file tree
Showing 4 changed files with 114 additions and 20 deletions.
100 changes: 80 additions & 20 deletions a701_作業中活頁檔填入漢字.py
View file
Original file line number Diff line number Diff line change
@@ -1,88 +1,148 @@
import logging
import os
import sys
from pathlib import Path

# 載入第三方套件
import xlwings as xw
from dotenv import load_dotenv

# 載入自訂模組
from mod_file_access import get_han_ji_khoo, get_sound_type, save_as_new_file
from p701_Clear_Cells import clear_han_ji_kap_piau_im
from p702_Ca_Han_Ji_Thak_Im import ca_han_ji_thak_im
from p709_reset_han_ji_cells import reset_han_ji_cells
from p710_thiam_han_ji import fill_hanji_in_cells

# =========================================================================
# 載入環境變數
# =========================================================================
load_dotenv()

# 預設檔案名稱從環境變數讀取
DB_HO_LOK_UE = os.getenv('DB_HO_LOK_UE', 'Ho_Lok_Ue.db')
DB_KONG_UN = os.getenv('DB_KONG_UN', 'Kong_Un.db')

# =========================================================================
# 設定日誌
# =========================================================================
logging.basicConfig(
filename='process_log.txt',
level=logging.INFO,
format='%(asctime)s - %(levelname)s - %(message)s'
)

# =========================================================================
# 定義 Exit Code
# =========================================================================
EXIT_CODE_SUCCESS = 0 # 成功
EXIT_CODE_NO_FILE = 1 # 無法找到檔案
EXIT_CODE_INVALID_INPUT = 2 # 輸入錯誤
EXIT_CODE_PROCESS_FAILURE = 3 # 過程失敗
EXIT_CODE_UNKNOWN_ERROR = 99 # 未知錯誤


def main():
logging.info("作業開始")

# =========================================================================
# (1) 取得專案根目錄
# =========================================================================
current_file_path = Path(__file__).resolve()
project_root = current_file_path.parent
print(f"專案根目錄為: {project_root}")
logging.info(f"專案根目錄為: {project_root}")

# =========================================================================
# (2) 若無指定輸入檔案，則獲取當前作用中的 Excel 檔案並另存新檔
# (2) 嘗試獲取當前作用中的 Excel 工作簿
# =========================================================================
wb = None
try:
wb = xw.apps.active.books.active
except Exception as e:
print(f"發生錯誤: {e}")
logging.error(f"無法找到作用中的 Excel 工作簿: {e}", exc_info=True)
print("無法找到作用中的 Excel 工作簿")
return EXIT_CODE_NO_FILE

if not wb:
print("無法作業，原因可能為：(1) 未指定輸入檔案；(2) 未找到作用中的 Excel 工作簿！")
logging.error("無法作業，未指定輸入檔案或 Excel 無效。")
return EXIT_CODE_NO_FILE

try:
# =========================================================================
# (3) 讀取儲存格資料
# =========================================================================
cell_value = wb.sheets['漢字注音'].range('V3').value

# 判斷是否為 None 並執行處理
if cell_value is None:
print("【待注音漢字】儲存格未填入文字，作業無法繼續。")
logging.warning("【待注音漢字】儲存格為空")
return EXIT_CODE_INVALID_INPUT
else:
value_length = len(cell_value.strip())
print(f"【待注音漢字】總字數為: {value_length}")

# 將儲存格已填入之漢字及標音清除
value_length = len(cell_value.strip())
print(f"【待注音漢字】總字數為: {value_length}")
logging.info(f"【待注音漢字】總字數為: {value_length}")

# =========================================================================
# (4) 執行 Excel 作業
# =========================================================================
print("正在清除儲存格...")
clear_han_ji_kap_piau_im(wb)
logging.info("儲存格清除完畢")

# 將待注音的【漢字儲存格】重設格式
print("重設格式...")
reset_han_ji_cells(wb)
logging.info("儲存格格式重設完畢")

# 將待注音的漢字填入
print("填入待注音漢字...")
fill_hanji_in_cells(wb)
logging.info("填入待注音漢字完成")

# A731: 自動為漢字查找讀音
# =========================================================================
# (5) 自動查找讀音
# =========================================================================
type = get_sound_type(wb)
han_ji_khoo = get_han_ji_khoo(wb)
if han_ji_khoo == "河洛話" and type in ["白話音", "文讀音"]:
ca_han_ji_thak_im(wb, sheet_name='漢字注音', cell='V3', hue_im=type, han_ji_khoo="河洛話",
db_name='Ho_Lok_Ue.db', module_name='mod_河洛話', function_name='han_ji_ca_piau_im')
elif han_ji_khoo == "廣韻":
ca_han_ji_thak_im(wb, sheet_name='漢字注音', cell='V3', hue_im="文讀音", han_ji_khoo="廣韻",
db_name='Kong_Un.db', module_name='mod_廣韻', function_name='han_ji_ca_piau_im')

if han_ji_khoo in ["河洛話", "廣韻"]:
db_name = DB_HO_LOK_UE if han_ji_khoo == "河洛話" else DB_KONG_UN
module_name = 'mod_河洛話' if han_ji_khoo == "河洛話" else 'mod_廣韻'
hue_im = type if han_ji_khoo == "河洛話" else "文讀音"

logging.info(f"開始標音作業 - {han_ji_khoo}: {type}")
ca_han_ji_thak_im(wb, sheet_name='漢字注音', cell='V3', hue_im=hue_im,
han_ji_khoo=han_ji_khoo, db_name=db_name,
module_name=module_name, function_name='han_ji_ca_piau_im')
logging.info(f"標音作業完成 - {han_ji_khoo}: {type}")
else:
print("無法執行漢字標音作業，請確認【env】工作表【語音類型】及【漢字庫】欄位的設定是否正確！")
print("無法執行漢字標音作業，請確認設定是否正確！")
logging.warning("無法執行標音作業，檢查【env】設定。")
return EXIT_CODE_PROCESS_FAILURE

# 將檔案存放路徑設為【專案根目錄】之下
# =========================================================================
# (6) 儲存檔案
# =========================================================================
print("儲存檔案...")
save_as_new_file(wb=wb)
logging.info("檔案已成功儲存")

except Exception as e:
print(f"執行過程中發生未知錯誤: {e}")
logging.error(f"執行過程中發生未知錯誤: {e}", exc_info=True)
return EXIT_CODE_UNKNOWN_ERROR

return EXIT_CODE_SUCCESS
finally:
if wb:
# 是否關閉 Excel 視窗可根據需求決定
xw.apps.active.quit() # 確保 Excel 被釋放資源，避免開啟殘留

return EXIT_CODE_SUCCESS


if __name__ == "__main__":
exit_code = main()
if exit_code == 0:
if exit_code == EXIT_CODE_SUCCESS:
print("作業成功完成！")
else:
print(f"程式結束，代碼: {exit_code}")
Expand Down
Binary file modified output7/working.xlsx
View file
Binary file not shown.
Binary file modified output7/【河洛白話注音-雅俗通】《尚有力量的每日祈禱文》.xlsx
View file
Binary file not shown.
34 changes: 34 additions & 0 deletions process_log.txt
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
2025-01-10 13:16:10,153 - INFO - 作業開始
2025-01-10 13:16:10,154 - INFO - 專案根目錄為: C:\work\Piau-Im
2025-01-10 13:16:10,192 - INFO - 【待注音漢字】總字數為: 143
2025-01-10 13:16:10,286 - ERROR - 執行過程中發生未知錯誤: (-2147352567, '發生例外狀況。', (0, None, None, None, 0, -2146827284), None)
Traceback (most recent call last):
File "a701_作業中活頁檔填入漢字.py", line 91, in main
clear_han_ji_kap_piau_im(wb)
~~~~~~~~~~~~~~~~~~~~~~~~^^^^
File "c:\work\Piau-Im\p701_Clear_Cells.py", line 15, in clear_han_ji_kap_piau_im
sheet.range(cells_range).clear_contents() # 清除 C3:R{end_of_row} 範圍的內容
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
File "c:\work\Piau-Im\.venv\Lib\site-packages\xlwings\main.py", line 2048, in clear_contents
return self.impl.clear_contents()
~~~~~~~~~~~~~~~~~~~~~~~~^^
File "c:\work\Piau-Im\.venv\Lib\site-packages\xlwings\_xlwindows.py", line 1213, in clear_contents
self.xl.ClearContents()
~~~~~~~~~~~~~~~~~~~~~^^
File "c:\work\Piau-Im\.venv\Lib\site-packages\xlwings\_xlwindows.py", line 122, in __call__
v = self.__method(*args, **kwargs)
File "<COMObject Range>", line 2, in ClearContents
File "c:\work\Piau-Im\.venv\Lib\site-packages\win32com\client\dynamic.py", line 355, in _ApplyTypes_
result = self._oleobj_.InvokeTypes(
*(dispid, LCID, wFlags, retType, argTypes) + args
)
pywintypes.com_error: (-2147352567, '發生例外狀況。', (0, None, None, None, 0, -2146827284), None)
2025-01-10 13:17:02,147 - INFO - 作業開始
2025-01-10 13:17:02,148 - INFO - 專案根目錄為: C:\work\Piau-Im
2025-01-10 13:17:02,184 - INFO - 【待注音漢字】總字數為: 143
2025-01-10 13:17:02,368 - INFO - 儲存格清除完畢
2025-01-10 13:17:10,237 - INFO - 儲存格格式重設完畢
2025-01-10 13:17:26,865 - INFO - 填入待注音漢字完成
2025-01-10 13:17:26,908 - INFO - 開始標音作業 - 河洛話: 白話音
2025-01-10 13:17:46,412 - INFO - 標音作業完成 - 河洛話: 白話音
2025-01-10 13:17:46,761 - INFO - 檔案已成功儲存

0 comments on commit bb16592

Please sign in to comment.