Python エディタ

Python エディタは QuantCraft IDE の中核です(ワークスペースのレイアウト)。Files Sidebar でファイルを選択するか、エディタストリップでタブを開くたびに表示され、Python のトレーディング戦略を書くのに最適化された、完全でモダンなコーディング体験を提供します。ライブラリは Packages で管理し(依存関係)、コードは Run / Test で実行します(コードの実行)。

このページでは、最もよく使う 4 つの領域を扱います。

• 編集
• テーマ
• フォントサイズ
• Format Document

---

編集

ファイルを開くと、エディタは IDE Main Panel の中央を占め、使い慣れた Python エディタと同じように動作します。

コードを書く

• Python のシンタックスハイライト。色は選択したエディタテーマで決まります。
• スマートインデント — 行末で Enter を押すと、Python に合わせて次の行が正しくインデントされます(def、class、if、for、with などの後)。
• 行の折り返し — 長い行は見た目上折り返されるので、横スクロールは不要です。実際の内容は変わりません。
• エディタ内ではスペルチェックがオフなので、識別子やキーワードに下線は付きません。
• Tab キーは 4 つのスペースを挿入します。

オートコンプリート

入力中に、文脈に応じた候補が表示されます。

• よく使う Python パターンのスニペット: def、class、for、while、try、with、lambda、import、from、ifmain など。
• 標準ライブラリとインストール済みパッケージ — import や from を入力すると、IDE の Python 環境のモジュールと、ワークスペース内のフォルダやファイルが候補に表示されます。
• メンバー補完 — モジュール、パッケージ、または既知の QuantCraft オブジェクト(例: bar.、fundamentals.、pd.)の後に . を入力すると、使用可能な属性とメソッドが一覧表示されます。戦略のコールバックでは bar. と fundamentals. を使うことをおすすめします。IDE では、モジュールレベルの qc_ohlcv はインポート時に未設定であることが多いためです。
• 候補は自動的に表示されます。Ctrl+Space で明示的に呼び出すこともできます。

ワークスペースのファイル間の移動

• import やワークスペースのシンボルを Ctrl+クリック(macOS では Cmd+クリック)すると、エディタでそのファイルに移動し、該当する行にカーソルが置かれます。
• 各タブは、訪問の合間にスクロール位置とカーソル位置を記憶するため、ファイルを切り替えても、いつでも中断した場所にぴったり戻れます。

検索と置換

エディタの上部に検索パネルが組み込まれています。

• Find — Ctrl+F(または Edit → Find)。
• Replace — Ctrl+H(または Edit → Replace)。
• 置換の行は、ファイルが編集可能な場合にのみ表示されます。

標準の編集コマンド

標準的な編集操作はすべて、エディタツールバーの Edit メニューとキーボードショートカットから利用できます。

ヒント: コピーと貼り付けにはシステムのクリップボードが使われるため、QuantCraft と他のあらゆるアプリの間でコードを移動できます。

---

テーマ

エディタのカラーテーマはアプリの他の部分から独立しています。アプリをダークモードで使いながら、エディタには明るいテーマを使うことも、その逆も可能です。

テーマを変更する

1. エディタ上部のエディタツールバーを開きます。
2. Theme をクリックします。
3. リストからテーマを選びます。エディタはすぐに更新されます。

選択内容は自動的に保存され、次に IDE を開いたときに復元されます。

利用可能なテーマ

Theme メニューには、厳選された明るいテーマと暗いテーマが含まれています。

• Default Light、Default Dark
• VS Code Light、VS Code Dark (VS Code Dark が既定です)
• GitHub Light、GitHub Dark
• Dracula
• Monokai
• Nord
• Solarized Light、Solarized Dark
• Tokyo Night
• Gruvbox Dark
• Material Light、Material Dark

メニューのチェックマークは、現在有効なテーマを示します。

---

フォントサイズ

アプリの他の場所のフォントサイズを変えずに、画面や視力に合わせてエディタのフォントサイズを選べます。

フォントサイズを変更する

1. エディタツールバーを開きます。
2. Font Size をクリックします。
3. サイズを選びます。エディタはすぐに新しいサイズで再描画されます。

選択内容はセッションをまたいで記憶されます。

利用可能なサイズ

11 px、12 px、13 px、14 px(既定)、15 px、16 px、18 px、20 px、22 px。

メニューのチェックマークは、現在のサイズを示します。

---

Format Document

Format Document は、ファイル全体を 1 ステップで整えます。変更をコミットする前、コードを共有する前、あるいは作業中に戦略を読みやすく保ちたいときに便利です。

実行方法

• エディタツールバーの Edit メニューを開き、Format Document を選ぶ、または
• エディタにフォーカスがある状態で Shift+Alt+F を押します。

動作

• Python ファイルでは、QuantCraft 組み込みの Python フォーマッタでコードを整形します。
• JSON ファイルでは、JSON を読みやすく整形します(2 スペースのインデント)。改行区切りの JSON も認識され、各行が正規化されます。
• ファイルが有効な Python でも JSON でもない場合は、有用なエラーが得られるよう、Python フォーマッタにフォールバックします。

エラーが表示される場所

ファイルを整形できない場合(たとえば構文エラーがある場合)、エディタはコードに手を加えず、ワークスペース下部の出力パネルに、赤字でエラーメッセージを書き込みます。報告された問題を修正してから、もう一度 Format Document を実行してください。

ヒント

• Format Document はファイルを保存しません。バッファを書き換えるだけです。新しい名前で保存したい場合は File → Save As… を使います。
• 結果が気に入らない場合は、元に戻す(Ctrl+Z)で整形を 1 ステップで取り消せます。
• 整形コマンドはエディタ自体にも組み込まれているため、メニューからでも、コード入力中でも Shift+Alt+F ショートカットが機能します。