usb.libloader

Module Contents

関数

  • usb.libloader.locate_library

  • usb.libloader.load_library

  • usb.libloader.load_locate_library

exception usb.libloader.LibraryException

Bases: OSError

I/O関連エラーの基本クラス。

exception usb.libloader.LibraryNotFoundException

Bases: LibraryException

I/O関連エラーの基本クラス。

exception usb.libloader.NoLibraryCandidatesException

Bases: LibraryNotFoundException

I/O関連エラーの基本クラス。

exception usb.libloader.LibraryNotLoadedException

Bases: LibraryException

I/O関連エラーの基本クラス。

exception usb.libloader.LibraryMissingSymbolsException

Bases: LibraryException

I/O関連エラーの基本クラス。

usb.libloader.locate_library(candidates, find_library=ctypes.util.find_library)

指定のfind_library()関数(またはctypes.util.find_library)を使用して、候補にリストされているライブラリを見つけようとします。最初に見つかったライブラリを返します。これは、find_library()に応じて、ライブラリの名前またはライブラリファイルへのパスになります。ライブラリが見つからない場合はNoneを返します。

パラメータ

  • candidates -- ライブラリ名達の反復可能オブジェクト(iterable)

  • find_library -- 1つの位置引数(候補)を受け取り、ライブラリが見つかった場合に空でないstrを返す関数。"false"値(None、False、empty str)は、「ライブラリが見つからなかった」と解釈されます。指定されていない場合、またはNoneの場合、デフォルトはctypes.util.find_libraryです。

usb.libloader.load_library(lib, name=None, lib_cls=None)

ライブラリをロードします。例外をキャッチしてログに記録します。

戻り値

ロードしたライブラリまたはNone

パラメータ

  • lib -- ロードしたライブラリへのパス名

  • name -- ライブラリの識別子(identifier)(ロギング用)。デフォルトはNoneです。

  • lib_cls -- ライブラリクラス。デフォルトはNone (→ ctypes.CDLL)

usb.libloader.load_locate_library(candidates, cygwin_lib, name, win_cls=None, cygwin_cls=None, others_cls=None, find_library=None, check_symbols=None)

ライブラリのロードと配置

戻り値

ロードされたライブラリ

パラメータ

  • candidates -- locate_library()の為の候補リスト

  • cygwin_lib -- cygwinライブラリの名前

  • name -- lib識別子(identifier)(ロギング用)。デフォルトはNone。

  • win_cls -- win32プラットフォームでライブラリをインスタンス化するために使用されるクラス。デフォルトはNoneです。(→ ctypes.CDLL)

  • cygwin_cls -- cygwinプラットフォーム用のライブラリクラス。デフォルトはNoneです。(→ ctypes.CDLL)

  • others_cls -- 他のすべてのプラットフォーム用のライブラリクラス。デフォルトはNone (→ ctypes.CDLL)

  • find_library -- locate_library()参照。デフォルトはNone。

Check_symbols

None、またはロードされたライブラリが有効と見なされるために提供する必要のあるシンボルのリスト(hasattr(<>))のいずれか。 LibraryMissingSymbolsExceptionは、シンボルが欠落している場合に発生(raise)します。

Raises

NoLibraryCandidatesException

Raises

LibraryNotFoundException

Raises

LibraryNotLoadedException

Raises

LibraryMissingSymbolsException