ハッチ環境を構成する
Hatch(英語) は、Python 用のプロジェクト管理およびパッケージ化ツールです。
ハッチ は、setuptools 構成を自動的に移行し、分離された環境を作成し、ビルドを実行して公開できるため、Python パッケージ管理がより効率的になります。
PyCharm のハッチサポート
新しい Python プロジェクトの作成中に ハッチ を選択すると、PyCharm が自動的に pyproject.tomlファイルを生成します。 このファイルには、必要なパッケージ、スクリプト、プラグイン、URL が指定されています。 ファイルの構造と形式の詳細については、 pyproject(英語) ガイドを参照してください。
新しく作成されたプロジェクトの構造は次のようになります。
既存のプロジェクトを操作したい場合、PyCharm はローカルマシンまたはリモートソースからインポートされた Hatch プロジェクトも自動的に認識します。
PyCharm で ハッチ を使用するには、特定の Python 環境を作成する必要があります。
ハッチ環境を作成する
次のいずれかを実行します：
Python インタープリターセレクターをクリックして 新しいインタープリターを追加 を選択します。
Ctrl+Alt+S を押して 設定 を開き、 に移動します。
Python インタープリターセレクターをクリックして インタープリターの設定 を選択します。 利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックします。
利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックし、 ローカルインタープリターを追加する を選択します。
次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。
- 新しい hatch 環境
環境タイプのリストから ハッチ を選択します。
PyCharm は Hatch のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、
をクリックして参照します。環境を選択します。
Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。 環境が明示的に選択されていない場合、Hatch は デフォルトの環境(英語)を使用します。
リストから基本インタープリターを選択するか、
をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
- 既存の Hatch 環境
環境タイプのリストから ハッチ を選択します。
PyCharm は Hatch のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、
をクリックして参照します。リストから環境を選択します。
タスクを完了するには、 OK をクリックしてください。
Hatch モノリポ サポート
PyCharm は Hatch モノリポ構成をサポートしています。 ワークスペースモードが有効化されている場合、PyCharm はサブプロジェクト内の pyproject.toml ファイルを検出します。
サブプロジェクトで .py または pyproject.toml ファイルを開くと、PyCharm はこのプロジェクト用の環境がシステムに既に存在するかどうかを確認します。 存在する場合、環境は自動的に SDK として設定されます。 存在しない場合、ファイルレベルの通知で新しい環境の作成とこのサブプロジェクトの依存関係のインストールが提案されます。
詳細については、 ワークスペースとモノレポ を参照してください。
構成された Python インタープリター (ただし Docker ベース) のいずれかに対して、次の操作を実行できます。