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

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

======================================================================

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

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

exception py_compile.PyCompileError

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

py_compile.compile(file[, cfile[, dfile[, doraise]]])

   ソースファイルをバイトコードにコンパイルして、バイトコードのキャッ
   シュファイルに書き出します。 ソースコードは *file* という名前のファ
   イルから読み込みます。 バイトコードはファイル *cfile* に書き込まれ
   、デフォルトでは *file* "+" "'c'" (使用しているインタープリタで最適
   化が可能なら "'o'") です。 もし *dfile* が指定されたら、 *file* の
   代わりにソースファイルの名前としてエラーメッセージの中で使われます
   。 *doraise* が真の場合、コンパイル中にエラーが発生すると
   "PyCompileError" を送出します。 *doraise* が偽の場合(デフォルト)は
   エラーメッセージは "sys.stderr" に出力されますが、例外は送出しませ
   ん。

py_compile.main([args])

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

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

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

バージョン 2.6 で変更: モジュールがスクリプトとして実行された場合の 0
でない終了ステータスが追加されました。

参考:

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