3. Windows で Python を使う
***************************

このドキュメントは、 Python を Microsoft Windows で使うときに知ってお
くべき、 Windows 固有の動作についての概要を伝えることを目的としていま
す。


3.1. Python のインストール
==========================

ほとんどの Unix システムとサービスとは違って、Windows には、システムが
サポートする Python インストレーションが含まれていません。Python を利
用可能にするために、CPython チームは長年の間、すべての リリース で
Windows インストーラ (MSI パッケージ) をコンパイルしてきました。単独の
ユーザで使われるコアインタプリタとライブラリをユーザごとに追加する
Python インストレーションを、これらインストーラは主として意図していま
す。インストーラでは単一マシンのすべてのユーザのためにインストールする
こともでき、また、これとは分離されたアプリケーションローカルな配布物の
ZIP ファイルも入手可能です。


3.1.1. サポートされているバージョン
-----------------------------------

**PEP 11** で明記しているとおり Python のリリースは、Microsoft が延長
サポート期間であるとしている Windows プラットフォームのみをサポートし
ます。 つまり Python 3.6 は Vista とそれより新しい Windows をサポート
するということです。 Windows XP サポートが必要な場合は、Python 3.4 を
インストールしてください。


3.1.2. インストール手順
-----------------------

ダウンロードできる Python 3.6 のインストーラは 4 つあります。 インタプ
リタの 32 ビット版、64 ビット版がそれぞれ 2 つずつあります。 *WEB イン
ストーラ* は最初のダウンロードサイズは小さく、必要なコンポーネントはイ
ンストーラ実行時に必要に応じて自動的にダウンロードします。 *オフライン
インストーラ* にはデフォルトインストールに必要なコンポーネントが含まれ
ていて、インターネット接続はオプショナルな機能のためにだけに必要となり
ます。 インストール時にダウンロードを避けるほかの方法については ダウン
ロード不要なインストール を参照して下さい。

インストーラを開始すると、2つの選択肢からひとつを選べます:

[画像]

"Install Now" を選択した場合:

* 管理者権限は *不要です* (ただし C ランタイムライブラリのシステム更新
  が必要であったり、 Windows の Python ランチャ をすべてのユーザ向けに
  インストールする場合は必要です)。

* Python はあなたのユーザディレクトリにインストールされます。

* Windows の Python ランチャ はこのインストールウィザード最初のページ
  の下部のチェックボックス指定に従ってインストールされます。

* 標準ライブラリ、テストスイート、ランチャ、pip がインストールされます
  。

* このインストールウィザード最初の下部のチェックボックスをチェックすれ
  ば、環境変数 "PATH" にインストールディレクトリが追加されます。

* ショートカットはカレントユーザだけに可視になります。

"Customize installation" を選択すると、インストール場所、その他オプシ
ョンやインストール後のアクションの変更などのインストールの有りようを選
べます。デバッグシンボルやデバッグバイナリをインストールするならこちら
を選択する必要があるでしょう。

すべてのユーザのためのインストールのためには "Customize installation"
を選んでください。この場合:

* 管理者資格か承認が必要かもしれません。

* Python は Program Files ディレクトリにインストールされます。

* Windows の Python ランチャ は Windows ディレクトリにインストールされ
  ます。

* オプショナルな機能はインストール中に選択できます。

* 標準ライブラリをバイトコードにプリコンパイルできます。

* そう選択すれば、インストールディレクトリはシステム環境変数 "PATH" に
  追加されます。

* ショートカットがすべてのユーザで利用できるようになります。


3.1.3. MAX_PATH の制限を除去する
--------------------------------

Windows は歴史的にパスの長さが 260 文字に制限されています。 つまり、こ
れより長いパスは解決できず結果としてエラーになるということです。

Windows の最新版では、この制限は約 32,000 文字まで拡張できます。 管理
者が、グループポリシーの "Win32 の長いパスを有効にする (Enable Win32
long paths)" を有効にするか、レジストリ "HKEY_LOCAL_MACHINE\SYSTEM\Cu
rrentControlSet\Control\FileSystem@LongPathsEnabled" の値を "1" に設定
する必要があります。

この設定によりパスを表すのに string を使っているときに、 "open()" 関数
や "os" モジュールやその他の多くのパスに関わる機能が 260 文字よりも長
いパスを受け取ったり、返したりできるようになります。 (パスに bytes を
使うのは Windows では非推奨で、 bytes を使っているときにはこの機能は利
用できません。)

これらのオプションを変更したら、それ以上の設定は必要ありません。

バージョン 3.6 で変更: Python で長いパスのサポートが可能になりました。


3.1.4. インストーラの GUI なしでインストールする
------------------------------------------------

インストーラの GUI で利用できるすべてのオプションは、コマンドラインか
らも指定できます。これによりユーザとの対話なしで数多くの機器に同じイン
ストールを行うような、スクリプト化されたインストールを行うことができま
す。ちょっとしたデフォルトの変更のために、GUI を抑制することなしにこれ
らコマンドラインオプションをセットすることもできます。

完全にインストーラの GUI を隠して Python を静かにインストールするには
、 "/quiet" オプションを渡してください。対話的に設定するのはスキップし
つつも進捗とエラーの表示は行いたいなら、 "/passive" オプションを渡して
ください。 "/uninstall" オプションも渡せます。これはプロンプトの表示な
しに、即座に Python の削除を開始します。

ほかのすべてのオプションは "name=value" の形で渡します。value は大抵
"0" で機能を無効化、 "1" で機能を有効化、であるとかパスの指定です。利
用可能なオプションの完全なリストは以下の通りです。

+-----------------------------+----------------------------------------+----------------------------+
| 名前                        | 説明                                   | デフォルト                 |
|=============================|========================================|============================|
| InstallAllUsers             | システムワイドなインストールを実行する | 0                          |
|                             | 。                                     |                            |
+-----------------------------+----------------------------------------+----------------------------+
| TargetDir                   | インストール先ディレクトリ。           | InstallAllUsers に基いて選 |
|                             |                                        | 択されます。               |
+-----------------------------+----------------------------------------+----------------------------+
| DefaultAllUsersTargetDir    | すべてのユーザ向けインストールのための | "%ProgramFiles%\Python     |
|                             | デフォルトインストール先ディレク トリ  | X.Y" または "%ProgramFile  |
|                             | 。                                     | s(x86)%\Python X.Y"        |
+-----------------------------+----------------------------------------+----------------------------+
| DefaultJustForMeTargetDir   | 自分一人用インストールのためのデフォル | "%LocalAppData%\Programs\  |
|                             | トインストール先ディレクトリ。         | PythonXY" または "%LocalA  |
|                             |                                        | ppData%\Programs\PythonXY  |
|                             |                                        | -32"                       |
+-----------------------------+----------------------------------------+----------------------------+
| DefaultCustomTargetDir      | カスタムインストールディレクトリとして | (空)                       |
|                             | デフォルトで GUI に表示される値 。     |                            |
+-----------------------------+----------------------------------------+----------------------------+
| AssociateFiles              | ランチャもインストールする場合に、ファ | 1                          |
|                             | イルの関連付けを行う。                 |                            |
+-----------------------------+----------------------------------------+----------------------------+
| CompileAll                  | すべての ".py" ファイルをバイトコンパ  | 0                          |
|                             | イルして ".pyc" を作る。               |                            |
+-----------------------------+----------------------------------------+----------------------------+
| PrependPath                 | "PATH" にインストールディレクトリと    | 0                          |
|                             | Scripts ディレクトリを追加し、         |                            |
|                             | "PATHEXT" に ".PY" を追加する。        |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Shortcuts                   | インストールするインタプリタ、ドキュメ | 1                          |
|                             | ント、IDLE へのショートカットを 作る。 |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_doc                 | Python マニュアルをインストールする。  | 1                          |
+-----------------------------+----------------------------------------+----------------------------+
| Include_debug               | デバッグバイナリをインストールする。   | 0                          |
+-----------------------------+----------------------------------------+----------------------------+
| Include_dev                 | 開発用のヘッダ・ライブラリをインストー | 1                          |
|                             | ルする。                               |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_exe                 | "python.exe" とその関連ファイルをイン  | 1                          |
|                             | ストールする。                         |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_launcher            | Windows の Python ランチャ をインスト  | 1                          |
|                             | ールする。                             |                            |
+-----------------------------+----------------------------------------+----------------------------+
| InstallLauncherAllUsers     | Windows の Python ランチャ をすべての  | 1                          |
|                             | ユーザにインストールする。             |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_lib                 | 標準ライブラリと拡張モジュールをインス | 1                          |
|                             | トールする。                           |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_pip                 | バンドル版の pip と setuptools をイン  | 1                          |
|                             | ストールする。                         |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_symbols             | デバッグシンボル (***.pdb) をインスト  | 0                          |
|                             | ールする。                             |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_tcltk               | Tcl/Tk サポートと IDLE をインストール  | 1                          |
|                             | する。                                 |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_test                | 標準ライブラリのテストスイートをインス | 1                          |
|                             | トールする。                           |                            |
+-----------------------------+----------------------------------------+----------------------------+
| Include_tools               | ユーティリティスクリプトをインストール | 1                          |
|                             | する。                                 |                            |
+-----------------------------+----------------------------------------+----------------------------+
| LauncherOnly                | ランチャのみをインストールする。これは | 0                          |
|                             | 他のほとんどのオプションを上書き しま  |                            |
|                             | す。                                   |                            |
+-----------------------------+----------------------------------------+----------------------------+
| SimpleInstall               | 最大限のインストーラ GUI を無効にする  | 0                          |
|                             | 。                                     |                            |
+-----------------------------+----------------------------------------+----------------------------+
| SimpleInstallDescription    | 単純化されたインストーラ GUI を使う際  | (空)                       |
|                             | に表示するカスタムメッセージ。         |                            |
+-----------------------------+----------------------------------------+----------------------------+

例えばデフォルトでシステムワイドな Python インストレーションを静かに行
うには、以下コマンドを使えます (コマンドプロンプトより):

   python-3.6.0.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0

テストスイートなしの Python のパーソナルなコピーのインストールをユーザ
に簡単に行わせるには、以下コマンドのショートカットを作れば良いです。こ
れはインストーラの最初のページを単純化して表示し、また、カスタマイズで
きないようにします:

   python-3.6.0.exe InstallAllUsers=0 Include_launcher=0 Include_test=0
       SimpleInstall=1 SimpleInstallDescription="Just for me, no test suite."

(ランチャのインストールを省略するとファイルの関連付けも省略されるので
、これはランチャインストールを含めたシステムワイドなインストールをした
場合のユーザごとインストールに限った場合のお勧めです。)

上でリストしたオプションは、実行ファイルと同じ場所の "unattend.xml" と
名付けられたファイルで与えることもできます。このファイルはオプションと
その値のリストを指定します。値がアトリビュートとして与えられた場合、そ
れは数値であれば数値に変換されます。エレメントテキストで与える場合は常
に文字列のままです。以下は、先の例と同じオプションをセットするファイル
の実例です:

   <Options>
       <Option Name="InstallAllUsers" Value="no" />
       <Option Name="Include_launcher" Value="0" />
       <Option Name="Include_test" Value="no" />
       <Option Name="SimpleInstall" Value="yes" />
       <Option Name="SimpleInstallDescription">Just for me, no test suite</Option>
   </Options>


3.1.5. ダウンロード不要なインストール
-------------------------------------

Python のいくつかの機能は最初にダウンロードしたインストーラには含まれ
ていないため、それらの機能をインストールしようと選択するとインターネッ
ト接続が必要になります。 インターネット接続が必要にならないように、全
てのコンポーネントをすぐにできる限りダウンロードして、完全な *配置構成
(layout)* を作成し、どんな機能が選択されたかに関わらず、それ以上インタ
ーネット接続を必要がないようにします。 この方法のダウンロードサイズは
必要以上に大きくなるかもしれませんが、たくさんの回数インストールしよう
とする場合には、ローカルにキャッシュされたコピーを持つことはとても有用
です。

コマンドプロンプトから以下のコマンドを実行して、必要なファイルをできる
限り全てダウンロードします。 "python-3.6.0.exe" 部分は実際のインストー
ラの名前に置き換え、同名のファイルどうしの衝突が起こらないように、個別
のディレクトリ内に配置構成を作るのを忘れないようにしてください。

   python-3.6.0.exe /layout [optional target directory]

進捗表示を隠すのに "/quiet" オプションを指定することもできます。


3.1.6. インストール後の変更
---------------------------

いったん Python がインストールされたら、Windows のシステム機能の「プロ
グラムと機能」ツールから機能の追加や削除ができます。Python のエントリ
を選択して「アンインストールと変更」を選ぶことで、インストーラをメンテ
ナンスモードで開きます。

インストーラ GUI で "Modify" を選ぶと、チェックボックスの選択を変える
ことで機能の追加削除ができます - チェックボックスの選択を変えなければ
、何かがインストールされたり削除されたりはしません。いくつかのオプショ
ンはこのモードでは変更することはできません。インストールディレクトリな
どです。それらを変えたいのであれば、完全に削除してから再インストールす
る必要があります。

"Repair" では、現在の設定で本来インストールされるべきすべてのファイル
を検証し、削除されていたり更新されていたりするファイルを修正します。

"Uninstall" は Python を完全に削除します。「プログラムと機能」内の自身
のエントリを持つ Windows の Python ランチャ の例外が起こります。


3.1.7. ほかのプラットフォーム
-----------------------------

Python の継続的な開発の中で、過去にサポートされていた幾つかのプラット
フォームが (ユーザーや開発者の不足のために) サポートされなくなっていま
す。すべてのサポートされないプラットフォームについての詳細は **PEP
11** をチェックしてください。

* Windows CE は今でもサポートされています。

* Cygwin インストーラも Python インタープリタのインストールを提供して
  います。(cf. Cygwin package source, Maintainer releases)

コンパイル済みインストーラが提供されているプラットフォームについての詳
細な情報は Python for Windows を参照してください。

参考:

  Python on XP
     "7 Minutes to "Hello World!"" by Richard Dooling, 2006

  Installing on Windows
     in "Dive into Python: Python from novice to pro" by Mark Pilgrim,
     2004, ISBN 1-59059-356-1

  For Windows users
     in "Installing Python" in "A Byte of Python" by Swaroop C H, 2003


3.2. 別のバンドル
=================

標準の CPython の配布物の他に、追加の機能を持っている修正されたパッケ
ージがあります。以下は人気のあるバージョンとそのキーとなる機能です:

ActivePython
   マルチプラットフォーム互換のインストーラー、ドキュメント、 PyWin32

Anaconda
   人気のある (numpy, scipy や pandas のような) 科学系モジュールと、パ
   ッケージマネージャ "conda" 。

Canopy
   「包括的な Python 解析環境 (comprehensive Python analysis
   environment)」で、エディタとほかの開発ツールを含みます。

WinPython
   ビルド済みの科学系パッケージと、パッケージのビルドのためのツールを
   含む、Windows 固有のディストリビューション。

これらパッケージは Python や他のライブラリの最新バージョンが含まれると
は限りませんし、コア Python チームはこれらを保守もしませんしサポートも
しませんのでご理解ください。


3.3. Python を構成する
======================

コマンドプロンプトより便利に Python を実行するために、Windows のデフォ
ルトの環境変数をいくつか変えたいと思うかもしれません。インストーラは
"PATH" と "PATHEXT" 変数を構成させるオプションを提供してはいますが、こ
れは単独のシステムワイドなインストレーションの場合にだけ頼りになるもの
です。もしもあなたが定常的に複数バージョンの Python を使うのであれば、
Windows の Python ランチャ の利用を検討してください。


3.3.1. 補足: 環境変数の設定
---------------------------

Windows では、環境変数を恒久的にユーザレベルとシステムレベルの両方で設
定でき、あるいはコマンドプロンプトから一時的にも設定できます。

一時的に環境変数を設定するには、コマンドプロンプトを開き **set** コマ
ンドを使います:

   C:\>set PATH=C:\Program Files\Python 3.6;%PATH%
   C:\>set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib
   C:\>python

これらの変更は、以降に実行される同じコンソール内で実行される任意のコマ
ンドに適用され、また、そのコンソールから開始するすべてのアプリケーショ
ンに引き継がれます。

パーセント記号で変数名を囲んだものは既存の変数の値で展開されるので、新
しい値を最初にも最後にも追加することができます。 **python.exe** が入っ
ているディレクトリを "PATH" に追加することは、Python の適切なバージョ
ンが起動するように保証するための一般的な方法です。

デフォルトの環境変数を恒久的に変更するには、「スタート」をクリックして
検索ボックスで「環境変数を編集」を検索するか、(コンピュータのプロパテ
ィなどから) システムの詳細設定 を開いて 環境変数の設定 ボタンをクリッ
クしてください。これで立ち上がるダイアログで、ユーザ環境変数とシステム
環境変数を追加したり修正したりできます。システム変数を変更するにはあな
たのマシンへの制限のないアクセス (つまり管理者権限) が必要です。

注釈:

  Windows はシステム変数の *後ろに* ユーザ変数を結合します。この振る舞
  いにより "PATH" の修正時に期待とは異なる結果になることがあります。
  "PYTHONPATH" 変数は Python 2 と Python 3 のすべてのバージョンで使わ
  れるので、インストールされているすべての Python バージョンで互換なコ
  ードだけを使うのでない限り、この環境変数は恒久的な設定をすべきではあ
  りません。

参考:

  https://support.microsoft.com/kb/100843
     Windows NT の環境変数

  https://technet.microsoft.com/en-us/library/cc754250.aspx
     一時的に環境変数を変更するための SET コマンドについて。

  https://technet.microsoft.com/en-us/library/cc755104.aspx
     恒久的に環境変数を変更するための SETX コマンドについて。

  https://support.microsoft.com/kb/310519
     Windows XP での環境変数の管理方法

  https://www.chem.gla.ac.uk/~louis/software/faq/q1.html
     Louis J. Farrugia による、環境変数の設定についての説明。


3.3.2. Python 実行ファイルを見つける
------------------------------------

バージョン 3.5 で変更.

自動的に作成される Python インタープリタのスタートメニュー項目を使うだ
けでなく、Python をコマンドプロンプトから起動したいと思うかもしれませ
ん。 インストーラにはそのための設定を行うオプションがあります。

インストーラの最初のページに "Add Python to PATH" というラベルのオプシ
ョンがあり、これを選択するとインストーラはインストール場所を環境変数
"PATH" に追加します。 "Scripts\" フォルダの場所も追加されます。 これに
よりコマンドプロンプトから **python** とタイプしてインタプリタを起動し
たり、 **pip** とタイプしてパッケージインストーラを起動したりできます
。 コマンドラインからの起動なので、スクリプトをコマンドライン引数付き
で起動することもできます。 コマンドライン の文章を参照して下さい。

インストール時にこのオプションを有効にしていなかったとしても、インスト
ーラを再度実行して「Modify」を選んで、それを有効にし直せます。あるいは
そうせずとも、 "PATH" 変数は手動で修正できます。 補足: 環境変数の設定
を参照してください。環境変数 "PATH" には Python インストールディレクト
リを含む必要があります。ほかのエントリとはセミコロンで区切って繋いでく
ださい。これの実例は以下のようになります (以下最初の 2 つのエントリは
既に存在しているものと仮定しています):

   C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\Python 3.6


3.4. Windows の Python ランチャ
===============================

バージョン 3.3 で追加.

Windows の Python ランチャは、異なる Python のバージョンの位置の特定と
実行を助けるユーティリティです。スクリプト (またはコマンドライン) で特
定の Python のバージョンの設定を与えられると、位置を特定し、そのバージ
ョンを実行します。

環境変数 "PATH" による方法と違って、このランチャは Python の一番適切な
バージョンを、正しく選択します。このランチャはシステムワイドなものより
もユーザごとのインストレーションの方を優先し、また、新しくインストール
された順よりも言語のバージョンを優先します。


3.4.1. 最初に
-------------


3.4.1.1. コマンドラインから起動する
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

バージョン 3.6 で変更.

Python 3.3 とそれ以降のシステムワイドなインストレーションでは、ランチ
ャがあなたの "PATH" に追加されます。ランチャは、入手可能なあらゆる
Python のバージョンに互換であるため、実際にどのバージョンの Python が
インストールされているのかは重要ではありません。ランチャが使えるかを確
認するには以下コマンドをコマンドプロンプトより実行してください:

   py

インストールされている最新バージョンの Python が起動するはずです。 通
常どおりに終了することもできますし、追加のコマンドライン引数を指定して
直接 Python に渡すこともできます。

複数のバージョンの Python (たとえば 2.7 と 3.6) がインストールされてい
る場合は、Python 3.6 が起動することになります。Python 2.7 を起動したい
なら、次のコマンドを実行してみてください:

   py -2.7

インストールしてある Python 2.x の最新バージョンを起動したい場合は、次
のコマンドを実行してみてください:

   py -2

最新バージョンの Python 2.x が起動するはずです。

以下のようなエラーが出るようであれば、ランチャはインストールされていま
せん:

   'py' is not recognized as an internal or external command,
   operable program or batch file.

ユーザごとの Python インストレーションでは、インストール時にオプション
で指定しない限り、ランチャは "PATH"  に追加されません。


3.4.1.2. 仮想環境 (Virtual environments)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

バージョン 3.5 で追加.

(標準ライブラリの "venv" モジュールか外部ツール "virtualenv" で作った)
仮想環境がアクティブな状態で Python の明示的なバージョンを指定せずにラ
ンチャを起動すると、ランチャはグローバルなインタプリタではなくその仮想
環境のものを実行します。グローバルなほうのインタプリタを実行するには、
仮想環境の動作を停止するか、または明示的にグローバルな Python バージョ
ンを指定してください。


3.4.1.3. スクリプトから起動する
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

テスト用の Python スクリプトを作成しましょう。"hello.py" という名前で
以下の内容のファイルを作成してください

   #! python
   import sys
   sys.stdout.write("hello from Python %s\n" % (sys.version,))

hello.py が存在するディレクトリで、下記コマンドを実行してください:

   py hello.py

インストールされている最新の Python 2.x のバージョン番号が表示されるは
ずです。では、1行目を以下のように変更してみてください:

   #! python3

コマンドを再実行すると、今度は最新の Python 3.x の情報が表示されるはず
です。これまでのコマンドラインの例と同様に、より細かいバージョン修飾子
を指定することもできます。Python 2.6 がインストールされている場合、最
初の行を "#! python2.6" に変更すると、2.6 のバージョン情報が表示される
はずです。

コマンドからの呼び出しとは異なり、後ろに何もつかない "python" はインス
トールされている Python2.x の最新バージョンを利用することに注意してく
ださい。これは後方互換性と、 "python" が一般的に Python 2 を指すUnix
との互換性のためです。


3.4.1.4. ファイルの関連付けから起動する
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

インストール時に、ランチャは Python ファイル (すなわち ".py", ".pyw",
".pyc" ファイル) に関連付けられたはずです。そのため、これらのファイル
を Windows のエクスプローラーでダブルクリックした際はランチャが使われ
、上で述べたのと同じ機能を使ってスクリプトが使われるべきバージョンを指
定できるようになります。

このことによる重要な利点は、単一のランチャが先頭行の内容によって複数の
Python バージョンを同時にサポートできることです。


3.4.2. シェバン (shebang) 行
----------------------------

スクリプトファイルの先頭の行が "#!" で始まっている場合は、その行はシェ
バン (shebang) 行として知られています。 Linux や他の Unix 系 OS はこう
した行をもともとサポートしているため、それらのシステムでは、スクリプト
がどのように実行されるかを示すために広く使われます。 Windows の Python
ランチャは、Windows 上の Python スクリプトが同じ機能を使用できるように
し、上の例ではそれらの機能の使用法を示しています。

Python スクリプトのシェバン行を Unix-Windows 間で移植可能にするため、
このランチャは、どのインタプリタが使われるかを指定するための大量の '仮
想' コマンドをサポートしています。サポートされる仮想コマンドには以下の
ものがあります:

* "/usr/bin/env python"

* "/usr/bin/python"

* "/usr/local/bin/python"

* "python"

具体的に、もしスクリプトの1行目が

   #! /usr/bin/python

で始まっていたら、デフォルトの Python の位置が特定され、使用されます。
多くの Unix 上で動作する Python スクリプトにはすでにこの行が存在する傾
向がありますので、ランチャによりそれらのスクリプトを修正なしで使うこと
ができるはずです。あなたが新しいスクリプトを Windows 上で書いていて、
Unix 上でも有用であってほしいと思うなら、シェバン行のうち "/usr" で始
まるものを使用すべきです。

上記の仮想コマンドのいずれでも、明示的にバージョンを指定できます (メジ
ャーバージョンだけでも、メジャー・マイナーバージョン両方でも) - 例えば
"/usr/bin/python2.7" のように - これによりその特定のバージョンが特定さ
れて使われます。

"/usr/bin/env" 形式のシェバン行にはもう一つ更に特別な特性があります。
インストールされている Python を探す前に、この形式は Python 実行ファイ
ルを "PATH" から検索します。これは Unix の "env" プログラムに対応する
振る舞いで、これも "PATH" からの検索をするものです。


3.4.3. シェバン行の引数
-----------------------

シェバン行では Python インタプリタに渡される追加の引数を指定することも
できます。たとえば、シェバン行に以下のように書かれているとしましょう:

   #! /usr/bin/python -v

この場合、Python は "-v" オプション付きで起動するでしょう


3.4.4. カスタマイズ
-------------------


3.4.4.1. INI ファイルによるカスタマイズ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ランチャは2つの .ini ファイルを探しに行きます。具体的には、現在のユー
ザーの "application data" ディレクトリ (つまり、 Windows の関数
"SHGetFolderPath" に "CSIDL_LOCAL_APPDATA" を与えて呼ぶと返ってくるデ
ィレクトリ) の "py.ini" と、ランチャと同じディレクトリにある "py.ini"
です。'コンソール' 版のランチャ (つまり py.exe) と 'Windows' 版のラン
チャ (つまり pyw.exe) は同一の .ini ファイルを使用します。

"application data" ディレクトリで指定された設定は、実行ファイルの隣に
あるものより優先されます。そのため、ランチャの隣にある .ini ファイルへ
の書き込みアクセスができないユーザは、グローバルな .ini ファイル内のコ
マンドを上書き (override) できます。


3.4.4.2. デフォルトのPythonバージョンのカスタマイズ
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

どのバージョンの Python をコマンドで使用するかを定めるため、バージョン
修飾子がコマンドに含められることがあります。バージョン修飾子はメジャー
バージョン番号で始まり、オプションのピリオド ('.') とマイナーバージョ
ン指定子がそれに続きます。もしマイナー修飾子が指定されれば、オプション
でさらに "-32" を続けて、そのバージョンの 32-bit の実装が使われること
を示すことができます。

たとえば、"#!python" というシェバン行はバージョン修飾子を含みませんが
、"#!python3" はメジャーバージョンを指定するバージョン修飾子を含みます
。

コマンドにバージョン修飾子が見つからない場合、環境変数 "PY_PYTHON" を
設定してデフォルトバージョン修飾子を指定することができます。デフォルト
値は "2" になっています。この値は、単にメジャーバージョン (例えば "2")
にすることも、major.minor 修飾子 (例えば "2.6") にすることも、さらには
major.minor-32 にすることもできます。

マイナーバージョン修飾子が見つからない場合、環境変数
"PY_PYTHON{major}" (ここで "{major}" は、上記で決定された現在のメジャ
ーバージョン修飾子) を設定して完全なバージョンを指定することができます
。そういったオプションが見つからなければ、ランチャはインストール済みの
Python バージョンを列挙して、見つかったそのメジャーバージョン向けマイ
ナーリリースのうち最新のものを使用します。保証されているわけではありま
せんが、通常はそのメジャーバージョン系で最も後にインストールしたバージ
ョンになります。

64-bit Windows で、同一の (major.minor) Python バージョンの 32-bit と
64-bit の両方の実装がインストールされていた場合、64-bit バージョンのほ
うが常に優先されます。これはランチャが 32-bit と 64-bit のどちらでも言
えることで、32-bit のランチャは、指定されたバージョンが使用可能であれ
ば、64-bit の Python を優先して実行します。これは、どのバージョンが PC
にインストールされているかのみでランチャの挙動を予見でき、それらがイン
ストールされた順番に関係なくなる (つまり最後にインストールされた
Python とランチャが 32-bit か 64-bit かを知らなくともよい) ようにする
ためです。上に記したとおり、オプションの "-32" サフィックスでこの挙動
を変更できます。

例:

* 関連するオプションが設定されていない場合、"python" および "python2"
  コマンドはインストールされている最新の Python 2.x バージョンを使用し
  、"python3" コマンドはインストールされている最新の Python 3.x を使用
  します。

* "python3.1" および "python2.7" コマンドは、バージョンが完全に指定さ
  れているため、全くオプションを参照しません。

* "PY_PYTHON=3" の場合、"python" および "python3" コマンドはともにイン
  ストールされている最新の Python 3 を使用します。

* "PY_PYTHON=3.1-32" の場合、"python" コマンドは 32-bit 版の 3.1 を使
  用しますが、"python3" コマンドはインストールされている最新の Python
  を使用します (メジャーバージョンが指定されているため、PY_PYTHON は全
  く考慮されません。)

* "PY_PYTHON=3" で "PY_PYTHON3=3.1" の場合、"python" および "python3"
  はどちらも 3.1 を使用します

環境変数に加え、同じ設定をランチャが使う INI ファイルで構成することが
できます。INI ファイルの該当するセクションは "[defaults]" と呼ばれ、キ
ー名は環境変数のキー名から "PY_" という接頭辞を取ったものと同じです
(INI ファイルのキー名は大文字小文字を区別しないことにご注意ください)。
環境変数の内容は INI ファイルでの指定を上書きします。

例えば:

* "PY_PYTHON=3.1" と設定することは、INI ファイルに下記が含まれることと
  等価です:

   [defaults]
   python=3.1

* "PY_PYTHON=3" と "PY_PYTHON3=3.1" を設定することは、INI ファイルに下
  記が含まれることと等価です:

   [defaults]
   python=3
   python3=3.1


3.4.5. 診断
-----------

環境変数 "PYLAUNCH_DEBUG" が設定されていたら、設定値が何であっても、ラ
ンチャは診断情報を stderr (つまりコンソール) に出力します。この情報の
メッセージは詳細で *しかも* きついものですが、どういったバージョンの
Python が検知されたか、なぜ特定のバージョンが選択されたか、そして、対
象の Python を実行するのに使われた正確なコマンドラインを教えてくれます
。


3.5. モジュールの検索
=====================

Python は通常そのライブラリ (と site-packages フォルダ) をインストール
したディレクトリに格納します。そのため、 Python を "C:\Python\" ディレ
クトリにインストールしたとすると、デフォルトのライブラリは
"C:\Python\Lib\" に存在し、サードパーティーのモジュールは
"C:\Python\Lib\site-packages\" に格納することになります。

To completely override "sys.path", create a "._pth" file with the same
name as the DLL ("python36._pth") or the executable ("python._pth")
and specify one line for each path to add to "sys.path". The file
based on the DLL name overrides the one based on the executable, which
allows paths to be restricted for any program loading the runtime if
desired.

ファイルが存在したときは、全てのレジストリと環境変数は無視され、隔離モ
ードになり、そのファイルに "import site" と指定していない限りは "site"
がインポートできなくなります。 空行と "#" で始まる行は無視されます。
それぞれのパスはファイルの場所を指す絶対パスあるいは相対パスです。
"site" 以外のインポート文は許可されておらず、任意のコードも書けません
。

Note that ".pth" files (without leading underscore) will be processed
normally by the "site" module.

"._pth" ファイルが見付かったときは、 Windows では "sys.path" は次のよ
うに設定されます:

* 最初に空のエントリが追加されます。これはカレントディレクトリを指して
  います。

* その次に、 "PYTHONPATH" 環境変数が存在するとき、 環境変数 で解説され
  ているように追加されます。 Windows ではドライブ識別子 ("C:\" など)と
  区別するために、この環境変数に含まれるパスの区切り文字はセミコロンで
  なければならない事に注意してください。

* 追加で "アプリケーションのパス" を "HKEY_CURRENT_USER" か
  "HKEY_LOCAL_MACHINE" の中の
  "\SOFTWARE\Python\PythonCore{version}\PythonPath" のサブキーとして登
  録することができます。サブキーはデフォルト値としてセミコロンで区切ら
  れたパス文字列を持つことができ、書くパスが "sys.path" に追加されます
  。 (既存のインストーラーはすべて HKLM しか利用しないので、 HKCU は通
  常空です)

* "PYTHONHOME" が設定されている場合、それが "Python Home" として扱われ
  ます。 それ以外の場合、 "Python Home" を推定するために Python の実行
  ファイルのパスから "目印ファイル" ("Lib\os.py" または
  "pythonXY.zip") が探されます。 Python home が見つかった場合、そこか
  らいくつかのサブディレクトリ ("Lib", "plat-win" など) が "sys.path"
  に追加されます。 見つからなかった場合、コアとなる Python path はレジ
  ストリに登録された PythonPath から構築されます。

* Python Home が見つからず、環境変数 "PYTHONPATH" が指定されず、レジス
  トリエントリが見つからなかった場合、関連するデフォルトのパスが利用さ
  れます (例: ".\Lib;.\plat-win" など)。

メインの実行ファイルと同じ場所か一つ上のディレクトリに "pyvenv.cfg" が
ある場合、以下の異なった規則が適用されます:

* "PYTHONHOME" が設定されておらず、 "home" が絶対パスの場合、home 推定
  の際メインの実行ファイルから推定するのではなくこのパスを使います。

結果としてこうなります:

* "python.exe" かそれ以外の Python ディレクトリにある .exe ファイルを
  実行したとき (インストールされている場合でも PCbuild から直接実行さ
  れている場合でも) core path が利用され、レジストリ内の core path は
  無視されます。それ以外のレジストリの "application paths" は常に読み
  込まれます。

* Python が他の .exe ファイル (他のディレクトリに存在する場合や、COM経
  由で組み込まれる場合など) にホストされている場合は、 "Python Home"
  は推定されず、レジストリにある core path が利用されます。それ以外の
  レジストリの "application paths" は常に読み込まれます。

* Python がその home を見つけられず、レジストリの値もない場合 (これは
  いくつかのとてもおかしなインストレーションセットアップの凍結された
  .exe)、パスは最小限のデフォルトとして相対パスが使われます。

自身のアプリケーションや配布物に Python をバンドルしたい場合には、以下
の助言 (のいずれかまたは組合せ) によりほかのインストレーションとの衝突
を避けることができます:

* Include a "._pth" file alongside your executable containing the
  directories to include. This will ignore paths listed in the
  registry and environment variables, and also ignore "site" unless
  "import site" is listed.

* If you are loading "python3.dll" or "python36.dll" in your own
  executable, explicitly call "Py_SetPath()" or (at least)
  "Py_SetProgramName()" before "Py_Initialize()".

* 自身のアプリケーションから "python.exe" を起動する前に、
  "PYTHONPATH" をクリアしたり上書きし、 "PYTHONHOME" をセットしてくだ
  さい。

* If you cannot use the previous suggestions (for example, you are a
  distribution that allows people to run "python.exe" directly),
  ensure that the landmark file ("Lib\os.py") exists in your install
  directory. (Note that it will not be detected inside a ZIP file, but
  a correctly named ZIP file will be detected instead.)

These will ensure that the files in a system-wide installation will
not take precedence over the copy of the standard library bundled with
your application. Otherwise, your users may experience problems using
your application. Note that the first suggestion is the best, as the
others may still be susceptible to non-standard paths in the registry
and user site-packages.

   バージョン 3.6 で変更:

   * Adds "._pth" file support and removes "applocal" option from
     "pyvenv.cfg".

   * Adds "pythonXX.zip" as a potential landmark when directly
     adjacent to the executable.

   バージョン 3.6 で非推奨:

   Modules specified in the registry under "Modules" (not
   "PythonPath") may be imported by
   "importlib.machinery.WindowsRegistryFinder". This finder is enabled
   on Windows in 3.6.0 and earlier, but may need to be explicitly
   added to "sys.meta_path" in the future.


3.6. 追加のモジュール
=====================

Python は全プラットフォーム互換を目指していますが、 Windows にしかない
ユニークな機能もあります。標準ライブラリと外部のライブラリの両方で、幾
つかのモジュールと、そういった機能を使うためのスニペットがあります。

Windows 固有の標準モジュールは、 MS Windows 固有のサービス に書かれて
います。


3.6.1. PyWin32
--------------

Mark Hammond によって開発された PyWin32 モジュールは、進んだ Windows
専用のサポートをするモジュール群です。このモジュールは以下のユーティリ
ティを含んでいます:

* Component Object Model (COM)

* Win32 API 呼び出し

* レジストリ

* イベントログ

* Microsoft Foundation Classes (MFC) ユーザーインターフェイス

PythonWin は PyWin32 に付属している、サンプルのMFCアプリケーションです
。これはビルトインのデバッガを含む、組み込み可能なIDEです。

参考:

  Win32 How Do I...?
     by Tim Golden

  Python and COM
     by David and Paul Boddie


3.6.2. cx_Freeze
----------------

cx_Freeze は "distutils" 拡張 (Distutilsの拡張 を参照) で、 Python ス
クリプトを Windows 実行可能プログラム ("***.exe" ファイル) にラップし
ます。これを使えば、ユーザーに Python のインストールをさせなくても、ア
プリケーションを配布することができます。


3.6.3. WConio
-------------

Python の進んだターミナル制御レイヤである "curses" は、 Unix ライクシ
ステムでしか使うことができません。逆に Windows 専用のライブラリ、
Windows Console I/O for Python があります。

WConio は Turbo-C の "CONIO.H" のラッパーで、テキストユーザーインタフ
ェースを作成するために利用することができます。


3.7. Windows 上で Python をコンパイルする
=========================================

CPython を自分でコンパイルしたい場合、最初にすべきことは ソース を取得
することです。最新リリース版のソースか、新しい チェックアウト をダウン
ロードできます。

ソースツリーには Microsoft Visual Studio 2015 でのビルドのソリューショ
ンファイルとプロジェクトファイルが含まれていて、これが公式の Python リ
リースに使われているコンパイラです。これらファイルは "PCbuild" ディレ
クトリ内にあります。

ビルドプロセスについての一般的な情報は、"PCbuild/readme.txt" にありま
す。

拡張モジュールについては、 Windows 上での C および C++ 拡張モジュール
のビルド を参照してください。

参考:

  Python + Windows + distutils + SWIG + gcc MinGW
     or "Creating Python extensions in C/C++ with SWIG and compiling
     them with MinGW gcc under Windows" or "Installing Python
     extension with distutils and without Microsoft Visual C++" by
     Sébastien Sauvage, 2003

  MingW -- Python extensions
     by Trent Apted et al, 2007


3.8. Python 埋め込みのための配布
================================

バージョン 3.5 で追加.

埋め込み用の配布 (embedded distribution) は、最小限の Python 環境を含
んだ ZIP ファイルです。これは、エンドユーザから直接的にアクセスされる
のではなく何かアプリケーションの一部として動作することを意図したもので
す。

When extracted, the embedded distribution is (almost) fully isolated
from the user's system, including environment variables, system
registry settings, and installed packages. The standard library is
included as pre-compiled and optimized ".pyc" files in a ZIP, and
"python3.dll", "python36.dll", "python.exe" and "pythonw.exe" are all
provided. Tcl/tk (including all dependants, such as Idle), pip and the
Python documentation are not included.

注釈:

  埋め込み用配布には Microsoft C Runtime は含まれません。これを提供す
  るのはアプリケーションのインストーラの責務です。そのランタイムは既に
  以前にユーザのシステムにインストール済みかもしれませんし、Windows
  Update により自動で更新されているかもしれません。このことはシステム
  ディレクトリに "ucrtbase.dll" があるか探せばわかります。

サードパーティのパッケージはアプリケーションのインストーラによって、埋
め込み用配布と同じ場所にインストールされるべきです。通常の Python イン
ストレーションのように依存性管理に pip を使うことは、この配布ではサポ
ートされません。ですが、ちょっとした注意を払えば、自動更新のために pip
を含めて利用することはできるかもしれません。一般的には、ユーザに更新を
提供する前に開発者が新しいバージョンとの互換性を保証できるよう、サード
パーティーのパッケージはアプリケーションの一部として扱われるべきです
("vendoring")。

この配布の 2 つのお勧めできるユースケースを、以下で説明します。


3.8.1. Python アプリケーション
------------------------------

Python で記述された、必ずしもユーザにその事実を意識させる必要のないア
プリケーションです。埋め込み用配布はこのケースで、インストールパッケー
ジ内に Python のプライベートバージョンを含めるのに使えるでしょう。その
事実がどのように透過的であるべきかに依存して (あるいは逆に、どのように
プロフェッショナルにみえるべきか)、2 つの選択肢があります。

ランチャとなる特別な実行ファイルを使うことはちょっとしたコーディングを
必要としますが、ユーザにとっては最も透過的なユーザ体験となります。カス
タマイズされたランチャでは、何もしなければ Python で実行されるプログラ
ムの明白な目印はありません; アイコンはカスタマイズし、会社名やバージョ
ン情報を指定し、ファイルの関連付けがそれに相応しく振舞うようにできます
。ほとんどのケースではカスタムランチャは、ハードコードされたコマンドラ
イン文字列で単純に "Py_Main" を呼び出すので済むはずです。

より簡単なアプローチは、 "python.exe" または "pythonw.exe" を必要なコ
マンドライン引数とともに直接呼び出すバッチファイルかショートカットを提
供することです。この場合、そのアプリケーションは実際の名前ではなく
Python であるようにみえるので、ほかに動作している Python プロセスやフ
ァイルの関連付けと区別するのにユーザが困るかもしれません。

後者のアプローチではパッケージは、パス上で利用可能であることを保証する
ために、Python 実行ファイルと同じディレクトリにインストールされるべき
です。特別なランチャの場合はアプリケーション起動前に検索パスを指定する
機会があるので、パッケージはほかの場所に配置できます。


3.8.2. Python の埋め込み
------------------------

ネイティブコードで書かれ、時々スクリプト言語のようなものを必要とするよ
うなアプリケーションです。Python 埋め込み用の配布はこの目的に使えます
。一般的に、アプリケーションの大半がネイティブコード内にあり、一部が
"python.exe" を呼び出すか、直接的に "python3.dll" を使います。どちらの
ケースでも、ロード可能な Python インタプリタを提供するのには、埋め込み
用の配布を展開してアプリケーションのインストレーションのサブディレクト
リに置くことで十分です。

アプリケーションが使うパッケージは、インタプリタ初期化前に検索パスを指
定する機会があるので、任意の場所にインストールできます。また、埋め込み
用配布を使うのと通常の Python インストレーションを使うのとでの根本的な
違いはありません。


3.9. その他のリソース
=====================

参考:

  Python Programming On Win32
     "Help for Windows Programmers" by Mark Hammond and Andy Robinson,
     O'Reilly Media, 2000, ISBN 1-56592-621-8

  A Python for Windows Tutorial
     by Amanda Birmingham, 2004

  **PEP 397** - Python launcher for Windows
     Python の配布物へのランチャ同梱の提案。
