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, invalidation_mode=PycInvalidationMode.TIMESTAMP)¶ ソースファイルをバイトコードにコンパイルして、バイトコードのキャッシュファイルに書き出します。ソースコードはファイル名 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です。invalidation_mode should be a member of the
PycInvalidationModeenum and controls how the generated bytecode cache is invalidated at runtime. The default isPycInvalidationMode.CHECKED_HASHif theSOURCE_DATE_EPOCHenvironment variable is set, otherwise the default isPycInvalidationMode.TIMESTAMP.バージョン 3.2 で変更: PEP 3147 に準拠し cfile のデフォルト値を変更しました。以前のデフォルトは file +
'c'(最適化が有効な場合は'o') でした。同時に optimize パラメータも追加されました。バージョン 3.4 で変更: バイトコードをキャッシュするファイルへの書き込みに
importlibを使うようにコードを変更しました。これにより、例えば権限や write-and-move セマンティクスなどの、ファイルの作成や書き込みの動作がimportlibと一致するようになりました。 cfile がシンボリックリンクであるか通常のファイルでない場合、FileExistsErrorを送出するという注意書きも追加されました。バージョン 3.7 で変更: The invalidation_mode parameter was added as specified in PEP 552. If the
SOURCE_DATE_EPOCHenvironment variable is set, invalidation_mode will be forced toPycInvalidationMode.CHECKED_HASH.バージョン 3.7.2 で変更: The
SOURCE_DATE_EPOCHenvironment variable no longer overrides the value of the invalidation_mode argument, and determines its default value instead.
-
class
py_compile.PycInvalidationMode¶ A enumeration of possible methods the interpreter can use to determine whether a bytecode file is up to date with a source file. The
.pycfile indicates the desired invalidation mode in its header. See キャッシュされたバイトコードの無効化 for more information on how Python invalidates.pycfiles at runtime.バージョン 3.7 で追加.
-
TIMESTAMP¶ The
.pycfile includes the timestamp and size of the source file, which Python will compare against the metadata of the source file at runtime to determine if the.pycfile needs to be regenerated.
-
CHECKED_HASH¶ The
.pycfile includes a hash of the source file content, which Python will compare against the source at runtime to determine if the.pycfile needs to be regenerated.
-
UNCHECKED_HASH¶ Like
CHECKED_HASH, the.pycfile includes a hash of the source file content. However, Python will at runtime assume the.pycfile is up to date and not validate the.pycagainst the source file at all.This option is useful when the
.pycsare kept up to date by some system external to Python like a build system.
-
-
py_compile.main(args=None)¶ いくつか複数のソースファイルをコンパイルします。 args で (あるいは args が
Noneであればコマンドラインで) 指定されたファイルをコンパイルし、できたバイトコードを通常の方法で保存します。この関数はソースファイルの存在するディレクトリを検索しません; 指定されたファイルをコンパイルするだけです。 args が'-'1つだけだった場合、ファイルのリストは標準入力から取られます。バージョン 3.2 で変更:
'-'のサポートが追加されました。
このモジュールがスクリプトとして実行されると、 main() がコマンドラインで指定されたファイルを全てコンパイルします。一つでもコンパイルできないファイルがあると終了ステータスが 0 でない値になります。
参考
compileallモジュールディレクトリツリー内の Python ソースファイルを全てコンパイルするライブラリ。