この pyclbr モジュールはモジュールで定義されたクラス、メソッド、およびトップレベルの関数について、限られた量の情報を取得するのに使われます。伝統的な 3 ペイン形式のクラスブラウザを実装するのに十分な情報を提供します。情報は、モジュールのインポートによらず、ソースコードから抽出します。このため、このモジュールは信用できないソースコードに対して利用しても安全です。この制限から、多くの標準モジュールやオプションの拡張モジュールを含む、 Python で実装されていないモジュールに対して利用することはできません。
モジュールを読み込み、クラス名からクラス記述オブジェクトにマップする辞書を返します。パラメタ module はモジュール名を表す文字列でなくてはなりません; パッケージ内のモジュール名でもかまいません。 path パラメタはシーケンス型でなくてはならず、モジュールのソースコードがある場所を特定する際に sys.path の値に加えて使われます。
readmodule() に似ていますが、返される辞書は、クラス名からクラス記述オブジェクトへの対応付けに加えて、トップレベル関数から関数記述オブジェクトへの対応付けも行っています。さらに、読み出し対象のモジュールがパッケージである場合、返される辞書はキー '__path__' を持ち、その値はパッケージの検索パスが入ったリストになります。
Class オブジェクトは、 readmodule() や readmodule_ex() が返す辞書の値として使われており、以下のデータメンバを提供しています:
クラス記述オブジェクトが記述している対象のクラスを定義しているモジュールの名前です。
クラスの名前です。
記述しようとしている対象クラスの、直接の基底クラス群について記述している Class オブジェクトのリストです。スーパクラスとして挙げられているが readmodule() が見つけられなかったクラスは、 Class オブジェクトではなくクラス名の文字列としてリストに挙げられます。
メソッド名を行番号に対応付ける辞書です。
クラスを定義している class 文が入っているファイルの名前です。