[Python][お勉強] 「Pythonチュートリアル」を読む(12) -- モジュール

6章突入。


スクリプト
Pythonのトップレベルから抜けてもう一度入りなおすと、今まで入力した定義は関数も変数も全て失われる。それでは困るのでテキストファイルにプログラムを入力しておいて、Pythonへ渡して実行してやる方が
長いプログラムの場合は良い。このような場合のテキストファイルにプログラムを入力することを「スクリプトの作成」という。

モジュール
プログラムが長くなった場合、複数のファイルに分割して保存しておきたくなる。
Pythonでは、分割して保存しておいたファイルを読み込み、スクリプトやトップレベルで使用する手段を提供する。このファイルのことを「モジュール」という。
モジュールのファイル名は、モジュール名に接尾辞「.py」をつけたものである。
モジュールの中では、グローバル変数__name__にモジュール名がセットされる。

import
分割して保存しておいた「モジュール」を使用できるように読み込む操作を「import」という。
importする構文は以下のとおり。

import モジュール名
from モジュール名 import 変数名・関数名
　

最初のimport文ではモジュール名がimportする側のシンボル表に取り込まれる。
2番目の文ではモジュール名はシンボル表には取り込まれない。

また、全てのシンボル（アンダースコアで始まる以外のシンボル）を取り込むには、

from モジュール名 import *
　

とやる。




モジュールの検索パス

最初にカレントディレクトリを探す。
次に環境変数PYTHONPATHで指定されたディレクトリを探す。
次にインストール時に決まるデフォルトパスを探す。

また、変数sys.pathに検索パスがセットされている。
プログラムからモジュールの検索パスを変更したりすることも可能。



.pycファイル
プログラムの起動を速くするためにするバイトコンパイル済みコード。
.pycファイルにしたからといって、処理速度が向上するわけではない。
あくまで読み込むスピードが向上するだけだ、とのこと。



dir()関数
モジュールがどのような名前を定義しているのか、どのような名前をもっているのかを確認するのに
使用できる。
書式は以下のとおり。

  dir(モジュール名)
  dir()
　

最初の「dir(モジュール名)」では、パラメータで指定されたモジュールについて、名前のリストを返す。

たとえばsysモジュール。

>>> import sys
>>> dir(sys)
['__displayhook__', '__doc__', '__excepthook__', '__name__', '__stderr__',
'__stdin__', '__stdout__', '_getframe', 'api_version', 'argv', 'builtin_module_names',
'byteorder', 'call_tracing', 'callstats', 'copyright', 'displayhook', 'exc_clear', 'exc_info',
'exc_type', 'excepthook', 'exec_prefix', 'executable', 'exit', 'getcheckinterval',
'getdefaultencoding', 'getdlopenflags', 'getfilesystemencoding', 'getrecursionlimit',
 'getrefcount', 'hexversion', 'maxint', 'maxunicode', 'meta_path', 'modules', 'path',
'path_hooks', 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2',
'setcheckinterval', 'setdlopenflags', 'setprofile', 'setrecursionlimit', 'settrace',
'stderr', 'stdin', 'stdout', 'version', 'version_info', 'warnoptions']
>>>
　

sysモジュールはこんな感じ。

2行目の「dir()」は、現在定義されている名前のリストを返す。

$ python
Python 2.4.4 (#2, Apr  5 2007, 20:11:18)
[GCC 4.1.2 20061115 (prerelease) (Debian 4.1.1-21)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> dir()
['__builtins__', '__doc__', '__name__']
>>>
　

な感じ。
ここで注意すべきことは、ビルトインの関数名、変数名はリストアップしないということ。
ビルトインの関数名や変数名は、モジュール__builtin__で定義されている。

>>> import __builtin__
>>> dir(__builtin__)
['ArithmeticError', 'AssertionError', 'AttributeError', 'DeprecationWarning',
'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False', 'FloatingPointError',
'FutureWarning', 'IOError', 'ImportError', 'IndentationError', 'IndexError',
'KeyError', 'KeyboardInterrupt', 'LookupError', 'MemoryError', 'NameError',
'None', 'NotImplemented', 'NotImplementedError', 'OSError', 'OverflowError', 'OverflowWarning', 'PendingDeprecationWarning', 'ReferenceError', 'RuntimeError',
 'RuntimeWarning', 'StandardError', 'StopIteration', 'SyntaxError', 'SyntaxWarning',
'SystemError', 'SystemExit', 'TabError', 'True', 'TypeError', 'UnboundLocalError',
'UnicodeDecodeError', 'UnicodeEncodeError', 'UnicodeError', 'UnicodeTranslateError',
'UserWarning', 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__debug__', '__doc__',
'__import__', '__name__', 'abs', 'apply', 'basestring', 'bool', 'buffer', 'callable', 'chr',
'classmethod', 'cmp', 'coerce', 'compile', 'complex', 'copyright', 'credits', 'delattr', 'dict',
'dir', 'divmod', 'enumerate', 'eval', 'execfile', 'exit', 'file', 'filter', 'float', 'frozenset', 'getattr',
'globals', 'hasattr', 'hash', 'help', 'hex', 'id', 'input', 'int', 'intern', 'isinstance', 'issubclass', 'iter',
'len', 'license', 'list', 'locals', 'long', 'map', 'max', 'min', 'object', 'oct', 'open', 'ord', 'pow',
'property', 'quit', 'range', 'raw_input', 'reduce', 'reload', 'repr', 'reversed', 'round', 'set',
'setattr', 'slice', 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'unichr', 'unicode',
'vars', 'xrange', 'zip']
>>>
　

な感じ。




パッケージ
ドット区切りのモジュール名。パッケージによって、モジュール名の重複を気にしないでおくことが
可能になる。



__init__.py中の__all__の定義

from パッケージ import *
　

の際に、__all__で指定された名前のみインポートさせることができる。


Python2.5以降の相対インポート。
パッケージのモジュール中で、サブパッケージ中のモジュールをインポートする場合、
相対インポート文が書ける。

  from . import echo
  from .. import Formats
  from ..Filters import equalizer
　

などなど。


__path__
パッケージには、__path__という特殊な属性がある。
__init__.pyが実行される前に__init__.pyが存在するディレクトリ名に初期化される。

とりたてて必要になることは無いらしい。
この値を書き換えると、パッケージに含まれるモジュールやサブパッケージの検索に
影響を与えるらしい。




おしまい
.