はじめに

Poetry を利用した Python プロジェクトにおいて、
既存環境のパッケージ更新で少しハマった点があったため、備忘としてまとめます。
プロジェクト構築者とメンテナンス担当者（後任）が異なるケースで発生しやすい内容です。

環境

poetryの日本語サイトから、以下の使い分けと理解してます。

pyproject.tomlに記載されているバージョン制約内でバージョンアップする

poetry update

poetry.lockが更新される

pyproject.tomlに記載されているバージョン制約自体を更新する

poetry add

最新バージョンにする場合は@latestを付ける

poetry add パッケージ名@latest

pyproject.toml、poetry.lockが更新される

以下の手順で、パッケージを更新しました。

以下のエラーが発生

 Incompatible constraints in requirements of プロジェクト名

依存関係が以下のようにグループに分かれておりました。

poetry updateはグループを意識せずに更新してくれますが、
poetry addは、どのグループに属するパッケージかを明示的に指定する必要がありました。

そのため、正しくは次のように指定します。

poetry add パッケージ名@latest --group グループ名

Poetry プロジェクトを後任としてメンテナンスする場合は、以下のことを理解しておくとトラブルに強くなります。

パッケージ更新前に、pyproject.tomlのtool.poetry.groupを事前に確認することを推奨します。