EA_with_Python/python_for_ea/.github/instructions/streamlit.instructions.md

applyTo

applyTo
app.py,pages/**/*.py,**/streamlit/**/*.py

Streamlit Instructions

Basic Rules

• UIとロジックを分離する。
• Streamlitページには画面表示、入力受付、結果表示を中心に書く。
• DBアクセス、ファイルI/O、集計処理は src/ 側に分離する。
• st.session_state は専用クラスまたは専用関数で管理する。
• ユーザー向けエラーと内部エラーを分離する。

Error Handling

• ユーザーに表示するメッセージは分かりやすくする。
• 詳細な例外情報は logging に出力する。
• 例外を握りつぶさない。
• 既存のユーザー向け例外クラスがある場合は、それを優先する。

Long Running Task

• 長時間処理をStreamlitのリクエスト内で直接実行しない。
• 時間がかかる処理はWorker、Job Queue、外部プロセスへの分離を検討する。
• Streamlit側はジョブ登録とステータス表示を担当する。