Pythonプロジェクト

Pythonプロジェクトジェネレータは、モダンなPythonライブラリやアプリケーションを作成するために使用できます。ベストプラクティスに基づいて設定され、UVによる依存関係管理、単一のロックファイルと仮想環境を備えたUVワークスペース、テスト実行用のpytest、静的解析用のRuffが統合されています。

使用方法

Pythonプロジェクトの生成

新しいPythonプロジェクトを2つの方法で生成できます:

VSCode

1. インストール Nx Console VSCode Plugin まだインストールしていない場合
2. VSCodeでNxコンソールを開く
3. クリック Generate (UI) "Common Nx Commands"セクションで
4. 検索 @aws/nx-plugin - py#project
5. 必須パラメータを入力
6. クリック Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:py#project

yarn

yarn nx g @aws/nx-plugin:py#project

npm

npx nx g @aws/nx-plugin:py#project

bun

bunx nx g @aws/nx-plugin:py#project

変更されるファイルを確認するためにドライランを実行することもできます

pnpm

pnpm nx g @aws/nx-plugin:py#project --dry-run

yarn

yarn nx g @aws/nx-plugin:py#project --dry-run

npm

npx nx g @aws/nx-plugin:py#project --dry-run

bun

bunx nx g @aws/nx-plugin:py#project --dry-run

オプション

パラメータ	型	デフォルト	説明
name 必須	string	-	The name of the Python project
directory	string	packages	Parent directory where the project is placed.
projectType 必須	string	application	Project type
moduleName	string	-	Python module name

ジェネレータの出力

ジェネレータは<directory>/<name>ディレクトリに以下のプロジェクト構造を作成します:

• Directory<module-name>

  • __init__.py モジュール初期化
  • hello.py サンプルPythonソースファイル
• Directorytests

  • __init__.py モジュール初期化
  • conftest.py テスト設定
  • test_hello.py サンプルテスト
• project.json プロジェクト設定とビルドターゲット
• pyproject.toml UV用パッケージ設定ファイル
• .python-version プロジェクトのPythonバージョン情報

ワークスペースルートにも以下のファイルが作成/更新されます:

• pyproject.toml UV用ワークスペースレベルのパッケージ設定
• .python-version ワークスペースのPythonバージョン情報
• uv.lock Python依存関係のロックファイル

Pythonソースコードの記述

Pythonソースコードは<module-name>ディレクトリに追加します。

他のプロジェクトでのライブラリコードのインポート

Pythonプロジェクトに依存関係を追加するにはaddターゲットを使用します。

my_appとmy_libという2つのPythonプロジェクトを作成した場合、完全修飾プロジェクト名はmy_scope.my_appとmy_scope.my_libになり、デフォルトのモジュール名はmy_scope_my_appとmy_scope_my_libになります。

my_appがmy_libに依存するようにするには、次のコマンドを実行します:

pnpm

pnpm nx run my_scope.my_app:add my_scope.my_lib

yarn

yarn nx run my_scope.my_app:add my_scope.my_lib

npm

npx nx run my_scope.my_app:add my_scope.my_lib

bun

bunx nx run my_scope.my_app:add my_scope.my_lib

Note

依存元と依存先の両方に完全修飾プロジェクト名を使用します。依存元プロジェクトには短縮構文を使用できますが、依存先プロジェクトは完全修飾名で指定する必要があります。

これでライブラリコードをインポートできます:

packages/my_app/my_scope_my_app/main.py

from my_scope_my_lib.hello import say_hello

上記の例では、my_scope_my_libがライブラリのモジュール名、helloはhello.pyファイルに対応し、say_helloはhello.pyで定義されたメソッドです。

依存関係の管理

プロジェクトに依存関係を追加するには、addターゲットを実行します:

pnpm

pnpm nx run my_scope.my_library:add some-pip-package

yarn

yarn nx run my_scope.my_library:add some-pip-package

npm

npx nx run my_scope.my_library:add some-pip-package

bun

bunx nx run my_scope.my_library:add some-pip-package

これによりプロジェクトのpyproject.tomlファイルが更新され、ルートのuv.lockが更新されます。

ランタイムコード

Pythonプロジェクトをランタイムコード（例: AWS Lambda関数のハンドラ）として使用する場合、ソースコードと依存関係をバンドルする必要があります。project.jsonファイルに以下のようなターゲットを追加できます:

project.json

{
  ...
  "targets": {
    ...
    "bundle": {
      "cache": true,
      "executor": "nx:run-commands",
      "outputs": ["{workspaceRoot}/dist/packages/my_library/bundle"],
      "options": {
        "commands": [
          "uv export --frozen --no-dev --no-editable --project packages/my_library --package my_scope.my_library -o dist/packages/my_library/bundle/requirements.txt",
          "uv pip install -n --no-installer-metadata --no-compile-bytecode --python-platform x86_64-manylinux2014 --python `uv python pin` --target dist/packages/my_library/bundle -r dist/packages/my_library/bundle/requirements.txt"
        ],
        "parallel": false
      },
      "dependsOn": ["compile"]
    },
  },
}

ビルド

Pythonプロジェクトにはbuildターゲット（project.jsonで定義）が設定されており、次のコマンドで実行できます:

pnpm

pnpm nx run <project-name>:build

yarn

yarn nx run <project-name>:build

npm

npx nx run <project-name>:build

bun

bunx nx run <project-name>:build

<project-name>はプロジェクトの完全修飾名です。

buildターゲットはコンパイル、リンター実行、テストを実施します。

ビルド出力はワークスペースルートのdistフォルダ内に生成されます（例: dist/packages/<my-library>/build）。

テスト

pytestがテスト実行用に設定されています。

テストの記述

テストはプロジェクト内のtestディレクトリにtest_プレフィックス付きのPythonファイルで記述します:

• Directorymy_library

  • hello.py
• Directorytest

  • test_hello.py hello.pyのテスト

テストメソッドはtest_で始まり、アサーションで期待値を検証します:

test/test_hello.py

from my_library.hello import say_hello

def test_say_hello():
  assert say_hello("Darth Vader") == "Hello, Darth Vader!"

テストの詳細な記述方法についてはpytestドキュメントを参照してください。

テストの実行

テストはbuildターゲットの一部として実行されますが、testターゲットで個別に実行することも可能です:

pnpm

pnpm nx run <project-name>:test

yarn

yarn nx run <project-name>:test

npm

npx nx run <project-name>:test

bun

bunx nx run <project-name>:test

-kフラグを使用して特定のテストファイルやメソッドを指定できます:

pnpm

pnpm nx run <project-name>:test -k 'test_say_hello'

yarn

yarn nx run <project-name>:test -k 'test_say_hello'

npm

npx nx run <project-name>:test -k 'test_say_hello'

bun

bunx nx run <project-name>:test -k 'test_say_hello'

リンター

PythonプロジェクトではRuffをリンターとして使用しています。

リンターの実行

プロジェクトのリンターを実行するにはlintターゲットを使用します:

pnpm

pnpm nx run <project-name>:lint

yarn

yarn nx run <project-name>:lint

npm

npx nx run <project-name>:lint

bun

bunx nx run <project-name>:lint

リンター問題の修正

ほとんどのリンターやフォーマッターの問題は自動修正可能です。--configuration=fix引数を付けて実行します:

pnpm

pnpm nx run <project-name>:lint --configuration=fix

yarn

yarn nx run <project-name>:lint --configuration=fix

npm

npx nx run <project-name>:lint --configuration=fix

bun

bunx nx run <project-name>:lint --configuration=fix

ワークスペース内の全パッケージのリンター問題を修正するには:

pnpm

pnpm nx run-many --target lint --all --configuration=fix

yarn

yarn nx run-many --target lint --all --configuration=fix

npm

npx nx run-many --target lint --all --configuration=fix

bun

bunx nx run-many --target lint --all --configuration=fix