ハッチ環境を構成する
Hatch(英語) は、Python 用のプロジェクト管理およびパッケージ化ツールです。
Hatch は、setuptools 構成を自動的に移行し、分離された環境を作成し、ビルドを実行して公開できるため、Python パッケージ管理がより効率的になります。
PyCharm のハッチサポート
新しい Python プロジェクトの作成中に Hatch を選択すると、PyCharm が自動的に pyproject.tomlファイルを生成します。 このファイルには、必要なパッケージ、スクリプト、プラグイン、URL が指定されています。 ファイルの構造と形式の詳細については、 pyproject(英語) ガイドを参照してください。
新しく作成されたプロジェクトの構造は次のようになります。
既存のプロジェクトを操作したい場合、PyCharm はローカルマシンまたはリモートソースからインポートされた Hatch プロジェクトも自動的に認識します。
PyCharm で Hatch を使用するには、特定の Python 環境を作成する必要があります。
ハッチ環境を作成する
次のいずれかを実行します：
Python インタープリターセレクターをクリックして 新しいインタープリターを追加 を選択します。
Ctrl+Alt+S を押して 設定 を開き、 に移動します。
Python インタープリターセレクターをクリックして インタープリターの設定 を選択します。 利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックします。
利用可能なインタープリターのリストの横にある インタープリターの追加 リンクをクリックし、 ローカルインタープリターを追加する を選択します。
次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。
- 新しい hatch 環境
環境タイプのリストから ハッチ を選択します。
PyCharm は Hatch のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、
をクリックして参照します。環境を選択します。
Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。 環境が明示的に選択されていない場合、Hatch は デフォルトの環境(英語)を使用します。
リストから基本インタープリターを選択するか、
をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
- 既存の Hatch 環境
環境タイプのリストから ハッチ を選択します。
PyCharm は Hatch のインストールを検出します。
PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、
をクリックして参照します。リストから環境を選択します。
タスクを完了するには、 OK をクリックしてください。
Hatch monorepo support
PyCharm supports Hatch monorepo setups. When the Workspace mode is enabled, PyCharm detects subprojects by looking for pyproject.toml files in subdirectories.
Once a .py or pyproject.toml file is opened in a subproject, PyCharm checks whether an environment for this project already exists on the system. If it does, the environment is automatically configured as the SDK. If not, a file-level notification suggests creating a new environment and installing dependencies for this subproject.
詳細については、 Workspaces and monorepos を参照してください。
構成された Python インタープリター (ただし Docker ベース) のいずれかに対して、次の操作を実行できます。