# 32.10. `py_compile` --- Python ソースファイルのコンパイル

ソースコード: Lib/py_compile.py

`py_compile` モジュールには、ソースファイルからバイトコードファイルを作る関数と、モジュールのソースファイルがスクリプトとして呼び出される時に使用される関数が定義されています。

頻繁に必要となるわけではありませんが、共有ライブラリとしてモジュールをインストールする場合や、特にソースコードのあるディレクトリにバイトコードのキャッシュファイルを書き込む権限がないユーザがいるときには、この関数は役に立ちます。

exception `py_compile.``PyCompileError`

  ファイルをコンパイル中にエラーが発生すると送出される例外。

`py_compile.``compile`(file, cfile=None, dfile=None, doraise=False, optimize=-1)

  ソースファイルをバイトコードにコンパイルして、バイトコードのキャッシュファイルに書き出します。ソースコードはファイル名 file で渡します。バイトコードは cfile に書き込まれ、デフォルトでは PEP 3147 や PEP 488 にある `.pyc` で終わるパスです。例えば、 file が `/foo/bar/baz.py` だった場合、 cfile は Python 3.2 ではデフォルトで `/foo/bar/__pycache__/baz.cpython-32.pyc` になります。もし dfile が指定されたら、 file の代わりにソースファイルの名前としてエラーメッセージの中で使われます。 doraise が真の場合、コンパイル中にエラーが発生すると `PyCompileError` を送出します。 doraise が (デフォルトである) 偽の場合はエラーメッセージは `sys.stderr` に出力されますが、例外は送出しません。この関数はバイトコンパイルされたファイルへのパス、つまり実際に使われた cfile の値を返します。

  (明示的に指定されたか計算された結果の) cfile のパスがシンボリックリンクだったり通常のファイルでなかったりした場合は、 `FileExistsError` が送出されます。この動作は、それらのパスにバイトコンパイルされたファイルを書き込む権限がある場合、インポートのときにそのパスを通常のファイルに変えてしまうことを警告するためのものです。これはリネームを使ってバイトコンパイルされたファイルを配置するインポートで、同時にファイル書き込みをしてしまう問題を避けるための副作用です。

  optimize は最適化レベルを制御するもので、組み込みの `compile()` 関数に渡されます。デフォルトは現在のインタープリタの最適化レベルを選ぶ `-1` です。

  バージョン 3.2 で変更: PEP 3147 に準拠し cfile のデフォルト値を変更しました。以前のデフォルトは file + `'c'` (最適化が有効な場合は `'o'`) でした。同時に optimize パラメータも追加されました。

  バージョン 3.4 で変更: バイトコードをキャッシュするファイルへの書き込みに `importlib` を使うようにコードを変更しました。これにより、例えば権限や write-and-move セマンティクスなどの、ファイルの作成や書き込みの動作が `importlib` と一致するようになりました。 cfile がシンボリックリンクであるか通常のファイルでない場合、 `FileExistsError` を送出するという注意書きも追加されました。

`py_compile.``main`(args=None)

  いくつか複数のソースファイルをコンパイルします。 args で (あるいは args が `None` であればコマンドラインで) 指定されたファイルをコンパイルし、できたバイトコードを通常の方法で保存します。この関数はソースファイルの存在するディレクトリを検索しません; 指定されたファイルをコンパイルするだけです。 args が `'-'` 1つだけだった場合、ファイルのリストは標準入力から取られます。

  バージョン 3.2 で変更: `'-'` のサポートが追加されました。

このモジュールがスクリプトとして実行されると、 `main()` がコマンドラインで指定されたファイルを全てコンパイルします。一つでもコンパイルできないファイルがあると終了ステータスが 0 でない値になります。

参考

`compileall` モジュール

  ディレクトリツリー内の Python ソースファイルを全てコンパイルするライブラリ。