pythonライブラリrequestsの仕組みについて

Question

pythonのライブラリrequestsがどのように動いているかソースコードを読んでいます。
https://github.com/kennethreitz/requests/tree/master/requests

from requests
response = requests.get(URL)

普段使うこの部分について質問です。get関数が呼ばれていますが、これはapi.pyに記述されているget関数を使っているのだと思います。
https://github.com/kennethreitz/requests/blob/master/requests/api.py

api.pyのgetを使う場合、from requests.api import get　としないと使えないと思っていたのですが、なぜimport requestsだけでgetを使えるのでしょうか？ pip install するとrequestsディレクトリのすべてのpyファイルの関数を呼び出すことができるようになるのでしょうか？

Answer 1

ここでrequests.apiのgetをインポートしているから、requests.getが使えるようになっています。

Answer 2

YouheiSakuraiさん回答で充分とも思えますが、質問者さんのモジュールの知識に曖昧な点があるように思えたので、少し補足的なコメントを試みます。

---

Pythonのモジュールをざっくりと捉えると

• (1)モジュールとは

そのモジュールのソースファイルに書かれていることを実行した結果できるモジュールオブジェクトのこと

• (2)モジュールのソースファイルとは

モジュールパス(sys.path)のいずれかのディレクトリー/zipアーカイブなどのトップ階層に現れるモジュール名.pyあるいはモジュール名/__init__.pyのこと(正確には最適化などのためもう少し複雑な仕様ですが、概ねこのように理解しておくととりあえず間に合うと思います)

• (3)モジュールのソースファイルにある代入文で何が起きる？

代入文はモジュールオブジェクトに代入文の左辺の名前をモジュールの属性名として生成し、右辺の値(右辺に書いた式を評価した結果)をその属性の値にします。

• (4)モジュールのソースファイルにある関数定義やクラス定義で何がおきる？

代入文と同じようなことがおきます。属性の値が関数であったりクラスであったりすること、構文が代入文、関数定義、クラス定義によりちょっと違うだけです。

• (5.1)モジュールM1のソースファイルでimport M2とすると何が起きる？

M2というモジュールオブジェクトをモジュールM1のM2という属性名の値にすることを意味します。

• (5.2)モジュールM1のソースファイルでfrom M2 import Aとすると何が起きる？

M2というモジュールオブジェクトにある属性AをモジュールM1のAという属性名の値にすることを意味します。この場合はM1の属性名にM2という名前は追加されずAという名前だけが追加されます。

---

import requestとすると

• (A) requestモジュールのソースファイルが実行されてrequestモジュールオブジェクトが作られる
• (B) そのrequestモジュールオブジェクトの値があなたのモジュールのrequestという名前のグローバル変数の値になる

ということなので、import requestとした後ではrequestsの値はrequestsモジュールであり、そのrequestsモジュールには既にgetという属性名が存在しており、その値はreqeusts.apiモジュールのgetという属性の値と同一なのであなたのモジュール内でrequests.getと記述できることになります。