pycontw-mail-handler 使用手冊

建立信件內容

[OPTIONS] --mails_path PATH [default: mails_to_sent]：儲存信件內容位置，預設會新增於當前目錄下新增的 mails_to_sent 的資料夾中 --separator ' TEXT '：設定輸出信件檔名分隔符號/文字
TEMPLATE_PATH：內容基本格式檔案位置，接受 .j2 檔案
RECEIVER_DATA：需替換的輸入資料檔案位置，接受 .json 檔案
- 預設需有以下格式資訊 { "common_data": {}, "unique_data": [ {"receiver_email": "somerec@somedomain"} ] }
- common_data：每封 email 共用之資料
- unique_data：每封 email 所需特定資料

修改 template 文件（可參考 sponsors_invite.j2 撰寫）
欲使用 HTML 寄出信件，可參考 reviewer_html.j2 編寫
修改 receiver data 文件（可參考 sponsors_invite 撰寫）
使用 render_mail 輸出信件內容 render_mail templates/sponsorship/spam_sponsors_2020 examples/sponsorship/spam_sponsors_2020.json
- templates 的資料夾下可參考範例 jinja 格式檔案
- examples 資料夾下可參考 receiver data 範例 json 格式檔案
- 如添加 --separator '-'，則輸出信件檔名為 {receiveremail}-{receviername} render_mail --separator '-' <TEMPLATE_PATH> <RECEIVER_DATA>
完成後會在目錄下建立一個 mails_to_sent 的資料夾，內有以receiver_email 為檔名之檔案，確認輸出無誤
若為 HTML 格式的信件會帶有 .html 的副檔名；若為純文字的信件則會帶有 .txt 的副檔名
確認內文

[OPTIONS] --mails_path PATH [default: mails_to_sent]：信件內容檔案夾位置，預設為 mails_to_sent，如非預設位置才使用 --attachment_file PATH：如需夾帶附件可使用此填寫附件檔案位置 --separator ' TEXT '：render_mail 如有使用到 separator 則此也必須加上相同項目
CONFIG_PATH：寄件者資料設定檔，接受 .json 檔案
- 需具備以下格式資訊，以 , 分隔多個收件者 { "Subject": "some subject", "From": "somebody@somedomain", "SenderName": "your name", "CC": "somebody1@somedomain, somebody2@somedomain" }
- 欲使用自訂 SMTP Server ，在此設定檔內新增 { ... "SMTP": { "Host": "some smtp server", "Port": 465 } }

修改 config 檔案內容（可參考 mail_config.json 撰寫。如欲使用自訂 SMTP server，請參考 mail_config_smtp.json。）
使用 send_mail 寄送 mail_to_sent 資料夾內之信件 send_mail examples/sponsorship/spam_sponsors_2020_mail_config.json
- 如在 render_mail 時有使用到 --separator 須加上相同參數 send_mail --separator '-' <CONFIG_FILE_PATH>
系統詢問是否確認寄出，輸入 y You are about to send the mails under "mails_to_sent". Do you want to continue? [y/N]: y
系統提示使用預設 Gmail SMTP server 或是自訂 SMTP server
預設 Using default Gmail SMTP server...
自訂 Using configured SMTP server "some smtp server:465"...
輸入寄件者 email account (欲使用預設 Gmail SMTP server 請輸入 gmail 帳號) Please enter your mail account: xxxxxxxx@gmail.com
輸入設定過的 password (設定方式請參考驗證問題部分進行設定) Please enter you mail password: xxxxxxxx
寄送成功系統會顯示以下資訊 Email sent to xxxxxxxx@gmail.com!
收件者收到的透過 mail handler 寄送的信件