Python3: imp.load_dynamic()とは？

Question

Pythonのとあるコードを読んでいると, imp.load_dynamic()というものが出てきました。
ところがpython3のimpのドキュメント(https://docs.python.org/ja/3/library/imp.html)を見ても該当のものが載っていません。
python2のものには載っていました(https://python-doc-ja.github.io/py27/library/imp.html)。

じゃあpython3では使えないんだな、と思いきや

>>>import imp
>>>callable(imp.load_dynamic)
True

となり使えるらしいです。
ここでよくわからなくなってしまいました。

質問したいのは、

1. imp.load_dynamic()とは何か？
2. 今回のような、有効なメソッドが公式ドキュメントに載ってなかったりするのはよくあることなのか、その場合それについての情報はどうやって得ればよいのか

です。
どなたかよろしくお願いします。

Answer 1

takenoko_sandさんがimpにこだわらずにいろいろなものを調べたいというのであれば、以下のやり方を覚えておくと便利でしょう。

一般的に、あるモジュールにどういう機能があるかというのは組み込み関数dirでわかります。

>>> import imp
>>> dir(imp)
['C_BUILTIN', 'C_EXTENSION', 'IMP_HOOK', 'NullImporter', 'PKG_DIRECTORY', 'PY_CODERESOURCE', 'PY_COMPILED', 'PY_FROZEN', 'PY_RESOURCE', 'PY_SOURCE', 'SEARCH_ERROR', 'SourcelessFileLoader', '_ERR_MSG', '_HackedGetData', '_LoadCompiledCompatibility', '_LoadSourceCompatibility', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', '_builtin_from_name', '_exec', '_fix_co_filename', '_load', 'acquire_lock', 'cache_from_source', 'create_dynamic', 'find_module', 'get_frozen_object', 'get_magic', 'get_suffixes', 'get_tag', 'importlib', 'init_builtin', 'init_frozen', 'is_builtin', 'is_frozen', 'is_frozen_package', 'load_compiled', 'load_dynamic', 'load_module', 'load_package', 'load_source', 'lock_held', 'machinery', 'new_module', 'os', 'release_lock', 'reload', 'source_from_cache', 'sys', 'tokenize', 'types', 'util', 'warnings']

ただし、sysとかtypesのように標準モジュールや標準関数が含まれていることもあるので注意してください。
また、パッケージの場合にはサブモジュールの中を知りたければ、サブモジュールについてdirで調べなければなりません。

個々の機能について調べたいときは、helpを使うか、.__doc__をprintします。
例えば、impを調べたければ以下のようにします。

>>> print(imp.__doc__)
This module provides the components needed to build your own __import__
function.  Undocumented functions are obsolete.

In most cases it is preferred you consider using the importlib module's
functionality over this module.

ドキュメントのない関数は廃物ですよ、と書かれています。つまり、意識的にドキュメントをなくしたということです。
同様にimp.load_dynamicを調べてみましょう。

>>> print(imp.load_dynamic.__doc__)
**DEPRECATED**

        Load an extension module.

機能は拡張モジュールをロードすることですが、廃棄済みという警告が書かれています。

こういうやり方を覚えておくと、ネットを調べなくても大抵のことはわかります。

Comments

[退会済みユーザー]

dir()や__doc__を知らなかったので助かりました。
ありがとうございます。

Answer 2

imp --- import 内部へのアクセス
「バージョン 3.4 で非推奨: imp モジュールは importlib を後継として非推奨にされました。」だそうです