Pythonでのインポート方法のベストプラクティスについて

Question

Pythonにおいてライブラリのインポートを行う方法について、

1. import somethingのようにモジュールのすべてを読み込む
2. from something import some_func, some_func_twoのように必要なものだけ読み込む

の２つの方法についてどのような違いがあり、どちらの方法が推奨されているのでしょうか？
実行効率の違いなどはあるのでしょうか？

Answer 1

1と2の違いは、名前付けの違いでしかありません。
名前は、ソースコードを読む上での重要な要点であるので、「ソースコードが読みやすい方を選ぶ」べきです。

以下に例を挙げます。

os.walk の場合

'os'モジュールの walk 関数を from os import walk でインポートすると、walk 関数を呼び出す際には、単に「walk()」と書く事になります。

赤の他人がこのコードをひと目見た際には、「walk？歩く？どこを歩くんだ？」と奇妙に思うかもしれません。
これは、あまりよろしくない例と言えます。

datetime.datetime の場合

datetime モジュールの datetimeクラスを使用する場合、datetimeとだけ書けば「あぁ、日付を扱う何らかのものだな」と理解できると思います。むしろ、「datetime.datetime」と書くのは冗長かもしれません。

もっとも、「これはdatetimeモジュールによるものだ」という意味合いを持たせるために「datetime.datetime」とあえて書くのもありかもしれません。

実行効率の違いなどはあるのでしょうか？

import something とインポートして、something.some_func でアクセスした場合、somethingの属性アクセスが入る分処理がかかるとも言えますが、よほど速度を求む場合でなければ気にならない程度ですし、普段は気にすることはないでしょう。

Answer 2

Python の名前空間とスコープ をお読みください。