Python Launcher 3.15.111

Python ランチャーの概要

Python Launcher(py.exe)は、複数のPythonバージョンがインストールされた際に適切なインタプリタにPythonスクリプトを送る、Windows向けのコンパクトなコマンドラインユーティリティです。公式のWindows Pythonインストーラーにデフォルトでバンドルされており、インストール済みのインタプリタを検出し、コマンドラインのオプションやスクリプトに埋め込まれた文字列に基づいてインタプリタを選択します。このプロジェクトはオープンソースであり、進化するPythonのリリースと互換性を維持するために維持されており、Windows上で混合されたPython 2/3環境やマルチバージョン環境を管理するためのシンプルな仕組みを提供しています。

主な特徴

• 自動インタプリタディスカバリー:ハードコーディング済みの実行パスを必要とせずにインストールされたPythonのバージョンやアーキテクチャを特定します。
• Shebang解析:Unixスタイルのshebang行(例:#!/usr/bin/env python3)を解釈し、マッチするインタプリタを自動的に選択します。
• バージョンセレクター:py -2、py -3、またはpy -3.9のような明示的なバージョン仕様子などのコマンドラインオプションで、起動時にターゲットインタプリタを選択します。
• インタプリタ列挙:py -0スイッチは発見されたインタプリタを一覧化し、デフォルトのバージョンとビット数を示します。
• ユーザーごとおよびシステムインストール:グローバルおよびユーザーごとのPythonインストールをサポートし、標準のWindowsインストールレイアウトと統合されます。
• モジュールおよびインタラクティブ呼び出し:モジュール実行(py -m module)、スクリプト実行、インタラクティブセッションに対応し、直接インタプリタ呼び出しの機能をミラーリングします。

インストールと互換性

Python Launcherは通常、公式のPythonのWindowsインストーラーによってインストールされ、システム上のPATH上の特定の場所にpy.exe配置されるため、どのコマンドプロンプトからでもアクセス可能です。最新のWindowsリリースをサポートし、複数のPythonディストリビューションやアーキテクチャが従来の場所にインストールされた場合は協力しています。

ユーザーインターフェースとワークフロー

コマンドライン専用のツールとして、ランチャーは視覚的な設定よりも最小限で予測可能なインターフェースを重視しています。一般的な使用パターンには、py script.py でスクリプトを呼び出したり、簡潔なフラグを持つインタプリタを選択したり、自動選択にshebang行を利用することなどがあります。内蔵ヘルプ(py -h)機能があり、スイッチや一般的なシナリオが用意されており、スクリプトワークフローからインタラクティブなワークフローまで対応可能です。

信頼性と保守性

軽量化を目的に設計されており、スクリプト起動のオーバーヘッドはごくわずかです。検出ロジックは典型的なWindows環境向けに設計されており、プロジェクトソース内で新しいPythonリリースに対応するために更新されます。オープンソース開発と公開リポジトリホスティングにより、コミュニティレビューや継続的なメンテナンスのための課題追跡が可能になります。

セキュリティと予測可能性

• 決定論的選択:明示的なバージョンフラグとshebang解釈は、誤った解釈者による誤った実行を減らす。
• 最小限の表面積:発射機の集中した責任と小さなフットプリントにより、大型環境管理者に比べて複雑さが制限されます。
• 公開ソース:ソースコードと発行履歴はプロジェクトリポジトリで閲覧可能で、閲覧や貢献が可能です。

ユースケース

1. 特定のPythonバージョンでWindowsマシン上で動作させるコードベースの保守。
2. 複数のインタプリタが共存する際に一貫したスクリプト実行を必要とするシステム管理者やパワーユーザー。
3. 開発者が、明示的なパスをバンドルせずに予測可能なインタプリタ選択を必要とするWindows Pythonツールを配布しています。

強み

• 明確なマルチバージョン管理:明示的なフラグと対応により、インタプリタの選択が繰り返しかつ透明性にします。
• 低摩擦展開:公式のWindowsインストーラーでインストールされ、標準環境で即座に動作します。
• 集中した設計:小型で単一用途のランチャーは、本番環境やスクリプト環境での予期せぬ挙動を最小限に抑えます。

制限

• グラフィカルインターフェースや環境分離なし:venvやCondaのような仮想環境ツールの代替ではありません。インタプリタを選択するのみです。
• Windows専用:Windows専用を意図しており、クロスプラットフォームプロジェクトではmacOSまたはLinux上でプラットフォーム固有のランチャーが必要です。
• 標準レイアウトによります:非標準または大幅にカスタマイズされたPythonインストールでは、信頼性の高い検出のために手動のPATHや設定調整が必要になることがあります。