Pythonモジュールの書き方を徹底解説！基本の手順とパッケージ活用術

Pythonモジュールとは？

モジュールとは、Pythonの定義（関数やクラスなど）や文をまとめて記述したファイルのことです。ファイル名は「モジュール名.py」という形式になり、このファイル名がそのままモジュール名として扱われます。

モジュールを作成する手順

1. モジュールファイルを作る

まず、「helloworld.py」というファイルを作成し、以下の関数を内容として記述します。

def hello_world():
    print("Hello world")

2. 別のスクリプトからインポートする

次に、同じディレクトリ内に「script.py」という別のファイルを作成し、以下のように記述します。

import helloworld
helloworld.hello_world()

これでhelloworldモジュールを作成し、script.pyの中でインポートして利用できるようになりました。スクリプトを実行すると、helloworld.py内に定義したhello_world()関数が呼び出され、「Hello world」という文字列が出力されます。

パッケージでモジュールを整理しよう

作業ディレクトリに多数のモジュールを作成すると、ファイルが散乱して管理しづらくなります。そんなときは「パッケージ」を活用しましょう。パッケージを使えば、複数のモジュールを階層的にきれいにグループ化でき、コードの再利用性や保守性も向上します。

パッケージは、__init__.pyファイルを含むディレクトリとして作成され、「mypackage.mymodule」のようにドット区切りでインポートすることができます。パッケージの作成方法や使い方の詳細については、Python公式ドキュメントを参照してください。
https://docs.python.org/3/tutorial/modules.html#packages