第23章 モジュールのコーディング モジュール・コーディングの基本
この作品はAIを使って翻訳されている。ご意見、ご感想をお待ちしている:translation-feedback@oreilly.com
さて、モジュールの背後にある大きな考え方を学んだところで、実際にモジュールが使われている例をいくつか見ていこう。この章の序盤のトピックのいくつかは、前の章のデモですでに適用したことのあるリニアな読者にとっては復習になるだろうが、単純なモジュールであっても、ネスティング、リロード、スコープなど、まだ完全には出会っていないさらなる詳細へとすぐに導いてくれる。
一般化すると、Pythonモジュールは簡単に作成できる。Pythonのプログラムコードをテキストエディタで作成しただけのファイルであり、特殊な構文は必要ない。Pythonがモジュールの発見と読み込みをすべてやってくれるので、モジュールも使いやすい。モジュールやその名前をインポートするだけで、それらが参照するオブジェクトを使うことができる。このフェンスの両側を探ってみよう。
モジュールの作成
モジュールを定義するには、テキストエディタを使って Python コードをテキストファイルに入力し、.pyという拡張子で保存するだけだ。このようなファイルは自動的に Python モジュールとみなされる。これまで見てきたように、モジュールのトップレベルで割り当てられた名前はすべてその属性(モジュールオブジェクトに関連付けられた名前)となり、クライアントが使用できるようにエクスポートされる-変数名からモジュールオブジェクトの属性に自動的に変化する。
例えば、例23-1のコードをmodule1.pyというファイルに入力し、インポートすると、printer という1つの属性を持つモジュールオブジェクトが作成される。
例 23-1. module1.py
def printer(x): # Module attribute
print(x)
繰り返しになるが、この章に先立つ本書の内容を読むと、このコードは単純化されているように見えるかもしれない。しかし、ここでの目的は、モジュールを単独で研究できるように、余計な部分を取り除くことである。
モジュールファイル名
先に進む前に、モジュールのファイル名についてもっと正式に説明しよう。モジュールを呼び出すのは自由だが、、モジュールとしてインポートするのであれば、モジュールファイル名の末尾には.pyを付けるべきである。.pyは、技術的には、実行はされるがインポートされないトップレベルのファイル(つまりスクリプト)についてはオプションであるが、すべての場合において、.pyを追加することで、ファイルのタイプがより明確になり、いくつかのテキストエディタやファイルエクスプローラでPython固有の機能を有効にすることができ、将来的にどのファイルでもインポートできるようになる(これはファイルを実行する1つの方法であることを思い出してほしい)。
モジュール名はPythonプログラム内で(.pyを除いた)変数名になるので、第11章で概説した通常の変数名の規則にも従うべきである。例えば、if.pyという名前のモジュールファイルを作成できるが、if は予約語なのでインポートできない。import if を実行しようとすると構文エラーになる。実際、モジュールファイルの名前付けも、パッケージのインポートで使われるディレクトリの名前(次の章で説明する)も、第11章で説明する変数名の規則に従わなければならない;例えば、アルファベット、数字、アンダースコアだけを含むことができる。パッケージ・ディレクトリの名前にも、スペースなどプラットフォーム特有の構文を含めることはできない。 ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access