【Python】モジュール・パッケージを使ってみよう!

Pythonロゴ

モジュールとは?

「モジュール」とは「クラス」や「関数」を1つにまとめたファイルになります。どの処理からでもimport文を使うことで呼び出すことが可能です。
モジュールは独自で作成することができます。

パッケージとは?

「パッケージ」は複数のモジュールをディレクトリに入れてひとまとめにしたものになります。ディレクトリ内には __init__.py ファイルがあります。

モジュールの基本操作

モジュールの呼び出し

import モジュール名
import time  # timeモジュールを呼び出し

print(time.time()) # timeモジュールの time()使用

# 結果 1581771786.23801

独自モジュールの呼び出し(import ***)

packageディレクトリを作成して中にmodule1.pyというファイルを保存しました。下記の例はmodule1.pyの中にあるtext_output関数を呼び出します。
モジュールの指定・関数の使用はフルパスになります。

def text_output(text):
    return text
import package.module1

print(package.module1.text_output('text'))  # フルパス

独自モジュールの呼び出し(form *** import *** )

上記の関数呼び出しを from ~ import ~ でおこないます。
モジュール呼び出し時に as を使うことで変数名を変えることができます。

from package import module1 as module0

print(module0.text_output('text'))

パッケージの基本操作

パッケージ呼び出し

ディレクトリに保存されているモジュールを一括呼び出しする場合はパッケージにして呼び出します。ディレクトリ内に「__init__.py」を作成して同フォルダ内のモジュール名を設定する必要があります。

サンプルではpackageディレクトリの中に module1.py と module2.py があります。

__all__ = ['module1', 'module2']
def text_output(text):
    return text
def num_output(num):
    return num
from package import *

print(module1.text_output('abc'))
print(module2.num_output(123))

組み込み関数

Pythonではよく使う関数を print() のように簡単に呼び出せるようにしています。
呼び出せる関数は公式サイトのドキュメントに記載されています。

参考 組み込み関数Python 公式ドキュメント(3.7)

サードパーティーのライブラリ

Pythonには一般の方々が公開されているライブラリを使用することができます。
PyPIと呼ばれるサイトで掲載されています。

参考 サードパーティーライブラリ検索Python PyPI

掲載されているライブラリはpipコマンドを利用して簡単にインストールすることができます。Mac PCの場合はターミナルを使いコマンドを入力します。

pip install ライブラリ名

サンプルプログラム

こちらの記事で作成したプログラムはGitHub環境にアップしております。
下記からダウンロードいただけます。

参考 import.py スクリプトGitHub python-beginner