おススメのMT5・MQL5対応FX業者はコチラ↓
おススメのMT5・MQL5対応FX業者
【※この記事にはプロモーションが含まれています。】 MQL5を使って自作したEAをシステムトレードに利用するには、取引プラットフォームとしてMT5を提供しているFX会社に口座を開設しなくてはいけません。 MQL5にて開発した、MT5用EAを...
mqlinvestmentlab.com
2023.08.04

MQL5システムトレーダーの為のPython講座：第17回「モジュール、パッケージ、ライブラリについて」

Python
2024.12.23
スポンサーリンク
スポンサーリンク

はじめに

前回はPythonにおける「関数」について学びました。

今回は、プログラムの整理や再利用性を高めるために重要な「モジュール」「パッケージ」「ライブラリ」について説明します。これらはPythonプログラムの基本構成要素であり、それぞれの役割や違いを理解することで、効率的なコード作成や管理が可能になります。

モジュール、パッケージ、ライブラリの違い

モジュールとは

モジュールは、Pythonで関数やクラスをまとめた「.py」ファイルのことを指します。1つのモジュールは特定の機能を実現するためのコードをまとめたもので、他のプログラムからインポートして利用できます。たとえば、rectangle.pyという名前で長方形の計算を行うコードを書いた場合、それがモジュールとなります。

例: モジュールのコード

# rectangle.py

# 長方形の高さ
height = 10  # 高さは10
# 長方形の幅
width = 5  # 幅は5

# 長方形の面積を計算する関数
def area(height, width):
    """
    引数として渡された高さと幅を使って長方形の面積を計算する関数
    """
    return height * width  # 面積 = 高さ × 幅

# 長方形の辺の長さを計算する関数
def edge_length(height, width):
    """
    引数として渡された高さと幅を使って長方形の辺の長さの合計を計算する関数
    """
    return 2 * (height + width)  # 辺の長さ = 2 × (高さ + 幅)

パッケージとは

パッケージは、複数のモジュールをまとめたフォルダのことを指します。このフォルダには__init__.pyというファイルが必要で、このファイルがあることでフォルダがパッケージとして認識されます。パッケージは関連するモジュールを整理して、より大きな構造を作るために役立ちます。

例: パッケージの構造

calculation/
    __init__.py
    addition.py
    subtraction.py
  • addition.pyには加算の機能を記述
  • subtraction.pyには減算の機能を記述

モジュール例: 加算機能

# addition.py

# 2つの数値を加算する関数
def add(x, y):
    """
    引数として渡された2つの数値を加算して返す関数
    """
    return x + y  # 加算結果を返す

モジュール例: 減算機能

# subtraction.py

# 2つの数値を減算する関数
def subtract(x, y):
    """
    引数として渡された2つの数値を減算して返す関数
    """
    return x - y  # 減算結果を返す
#""" は Pythonのマルチライン文字列 を表すもので、コメントアウトとは異なります。
#ただし、一般的には 関数やクラスのドキュメンテーションストリング（docstring） として使用されます。

ライブラリとは

ライブラリは、モジュールやパッケージ、関数、クラスなどを含むプログラムの集合を指します。ライブラリを使用することで、複雑なプログラムを簡潔に記述でき、時間の節約にもつながります。ライブラリには以下の2種類があります。

これらを理解することで、Pythonプログラムをより効率的に設計できます。次は、これらのモジュールやパッケージをどのように作成し、利用するかを説明します。

モジュールとパッケージの作成

Pythonでモジュールやパッケージを作成する具体的な手順を解説します。これらを作成することで、プログラムの構造を整理し、再利用性を高めることができます。

モジュールの作成

モジュールはPythonの.pyファイルです。まず、長方形に関する計算を行うモジュールを作成します。

手順

  1. 任意のテキストエディタ（例: VS Code）で新しいファイルを作成します。
  2. ファイル名をrectangle.pyに設定します。
  3. 以下のコードを記述します。

サンプルコード

# rectangle.py

# 長方形の高さ
height = 10  # 高さは10
# 長方形の幅
width = 5  # 幅は5

# 長方形の面積を計算する関数
def area(height, width):
    """
    引数として渡された高さと幅を使って長方形の面積を計算する関数
    """
    return height * width  # 面積 = 高さ × 幅

# 長方形の辺の長さを計算する関数
def edge_length(height, width):
    """
    引数として渡された高さと幅を使って長方形の辺の長さの合計を計算する関数
    """
    return 2 * (height + width)  # 辺の長さ = 2 × (高さ + 幅)

このようにして作成したrectangle.pyは、他のPythonファイルからインポートして使用できます。

パッケージの作成

パッケージは関連するモジュールをまとめたフォルダです。このフォルダに__init__.pyを含めることで、パッケージとして認識されます。以下では、計算に関するパッケージを作成します。

手順

  1. 新しいフォルダを作成し、名前をcalculationに設定します。
  2. フォルダ内に空の__init__.pyファイルを作成します。
  3. さらに、以下のモジュールをフォルダ内に作成します。

サンプルコード（加算機能のモジュール）

# addition.py

# 2つの数値を加算する関数
def add(x, y):
    """
    引数として渡された2つの数値を加算して返す関数
    """
    return x + y  # 加算結果を返す

サンプルコード（減算機能のモジュール）

# subtraction.py

# 2つの数値を減算する関数
def subtract(x, y):
    """
    引数として渡された2つの数値を減算して返す関数
    """
    return x - y  # 減算結果を返す

これで、calculationフォルダが1つのパッケージとなり、加算や減算を行うモジュールを含む構造が完成しました。次は、これらのモジュールやパッケージをどのように利用するかについて解説します。

モジュールとパッケージの使用方法

作成したモジュールやパッケージをPythonプログラム内で使用する方法について解説します。モジュールやパッケージを活用することで、コードの再利用性を高め、効率的にプログラムを構築することが可能です。

モジュールをインポートして使用する

まず、先ほど作成したrectangle.pyモジュールをインポートして使用する方法を説明します。

手順

  1. rectangle.pyと同じフォルダに新しいPythonファイルを作成します。名前は任意です（例: main.py）。
  2. ファイル内でimport文を使用してモジュールを読み込みます。

サンプルコード

# main.py

# rectangleモジュールをインポート
import rectangle

# rectangleモジュール内の変数を使用
height = rectangle.height  # モジュール内の高さを取得
width = rectangle.width  # モジュール内の幅を取得

# rectangleモジュール内の関数を使用
area_result = rectangle.area(height, width)  # 面積を計算
edge_result = rectangle.edge_length(height, width)  # 辺の長さを計算

# 結果を表示
print(f"面積: {area_result}")  # 面積: 50
print(f"辺の長さの合計: {edge_result}")  # 辺の長さの合計: 30

上記のように、モジュール名を指定して変数や関数を利用できます。

パッケージをインポートして使用する

次に、calculationパッケージのモジュールをインポートして使用する方法を説明します。

手順

  1. calculationフォルダと同じ階層に新しいPythonファイルを作成します（例: main.py）。
  2. from パッケージ名 import モジュール名 の形式でインポートします。

サンプルコード（加算と減算の利用）

# main.py

# calculationパッケージ内のadditionモジュールとsubtractionモジュールをインポート
from calculation import addition, subtraction

# additionモジュールのadd関数を使用
add_result = addition.add(10, 5)  # 10 + 5 を計算

# subtractionモジュールのsubtract関数を使用
subtract_result = subtraction.subtract(10, 5)  # 10 - 5 を計算

# 結果を表示
print(f"加算結果: {add_result}")  # 加算結果: 15
print(f"減算結果: {subtract_result}")  # 減算結果: 5

上記のように、パッケージ内の特定のモジュールや関数をインポートして利用できます。

別名を付けてインポートする

モジュールや関数に別名を付けることで、コードの簡潔性を向上させることができます。

サンプルコード

# main.py

# calculationパッケージ内のadditionモジュールのadd関数を別名でインポート
from calculation.addition import add as add_numbers

# 別名で関数を使用
result = add_numbers(7, 3)  # 7 + 3 を計算

# 結果を表示
print(f"加算結果: {result}")  # 加算結果: 10

as を使用することで、インポートした名前を短縮し、使いやすくできます。

これらの方法を活用することで、モジュールやパッケージを柔軟にプログラムに組み込むことが可能です。次のセクションでは、標準ライブラリとサードパーティーライブラリについて詳しく解説します。

ライブラリ（標準ライブラリとサードパーティーライブラリ）

Pythonのライブラリは、プログラムの開発を効率化するための重要なツールです。ここでは、標準ライブラリとサードパーティーライブラリについて説明します。それぞれの特徴と使用例を見ていきましょう。

標準ライブラリとは

標準ライブラリは、Pythonをインストールした時に最初から利用可能なライブラリ群を指します。これらは追加のインストール作業が不要で、インポートするだけで使用できます。標準ライブラリには数多くの便利なモジュールが含まれ、日常的なプログラム作成から高度な操作まで幅広く対応します。

例: よく使われる標準ライブラリ

  • math: 数学的な計算（平方根、三角関数など）
  • random: ランダムな値の生成
  • datetime: 日付と時間の操作

サンプルコード（mathモジュールの利用）

# mathモジュールをインポート
import math

# 平方根を計算
sqrt_result = math.sqrt(16)  # 16の平方根

# 円の面積を計算（半径5）
radius = 5
circle_area = math.pi * (radius ** 2)  # 円周率 × 半径^2

# 結果を表示
print(f"16の平方根: {sqrt_result}")  # 16の平方根: 4.0
print(f"半径5の円の面積: {circle_area}")  # 半径5の円の面積: 78.53981633974483

標準ラライブラリは、基本的な機能を実現するためのツールを提供します。

サードパーティーライブラリとは

サードパーティーライブラリ（外部ライブラリ）は、Pythonコミュニティや企業によって開発され、必要に応じてインストールして利用します。これらは特定の分野（例: データ分析、機械学習、グラフ描画）で高度な機能を提供します。

例: 人気のあるサードパーティーライブラリ

  • pandas: データの操作と分析
  • matplotlib: グラフ描画
  • numpy: 高速な数値計算

サンプルコード（pandasを使用したデータ操作）

# pandasライブラリをインポート
import pandas as pd

# サンプルデータの作成
data = {
    "名前": ["太郎", "花子", "次郎"],
    "年齢": [25, 30, 22],
    "職業": ["エンジニア", "デザイナー", "学生"]
}

# データフレームを作成
df = pd.DataFrame(data)

# データの確認
print("データフレームの内容:")
print(df)

# 年齢の平均を計算
average_age = df["年齢"].mean()
print(f"平均年齢: {average_age}")  # 平均年齢: 25.666666666666668

標準ライブラリとサードパーティーライブラリの違い

項目標準ライブラリサードパーティーライブラリ
利用準備初期状態で利用可能インストールが必要
利用例math, random, datetimepandas, matplotlib, numpy
主な用途一般的な操作専門的な分野の高度な機能

Pythonの強みの一つは、このサードパーティーライブラリの豊富さにあります。これにより、機械学習、データ分析、Web開発など、幅広い用途でPythonを活用することができます。

これらのライブラリを効果的に使用することで、開発作業を大幅に効率化できます。次のセクションでは、モジュールをインポートする際の挙動について詳しく説明します。

モジュールをインポートしたときの挙動

Pythonでモジュールをインポートすると、そのモジュールがどのように動作するのかを理解しておくことが重要です。インポートの仕組みを正しく理解していないと、意図しない動作やバグにつながることがあります。

インポート時の基本的な挙動

Pythonでは、import文を使用してモジュールをインポートすると、そのモジュールのコードが上から順に実行されます。この挙動を具体例で確認します。

サンプルコード（モジュールを作成）

# greeting.py

# モジュールが読み込まれると実行されるコード
print("Hello, Python!")  # 実行時に表示される

サンプルコード（インポートする側のコード）

# main.py

# greetingモジュールをインポート
import greeting

# 実行時の出力
# Hello, Python!

上記のように、モジュールがインポートされると、その内容が実行されることがわかります。

インポート時の意図しない挙動

モジュールに定義された関数やクラスだけでなく、モジュール全体が実行されるため、場合によっては意図しない結果になることがあります。

例: インポート時に関数が実行されるケース

# test_module.py

# 関数の定義
def greet():
    print("Hello from greet function!")

# モジュールが読み込まれたときに実行されるコード
greet()  # この行が実行される

インポートする側のコード

# main.py

# test_moduleモジュールをインポート
import test_module

# 実行時の出力
# Hello from greet function!

この例では、モジュールのインポート時にgreet関数が自動的に実行されてしまいます。これが意図しない場合は、以下の方法で回避します。

if __name__ == "__main__": の利用

Pythonでは、モジュールが直接実行された場合とインポートされた場合で異なる動作をするように制御することが可能です。それを実現するために、if __name__ == "__main__": を使用します。

サンプルコード（修正版のモジュール）

# test_module.py

# 関数の定義
def greet():
    print("Hello from greet function!")

# このモジュールが直接実行された場合のみ以下のコードを実行
if __name__ == "__main__":
    greet()  # greet関数を呼び出し

インポートする側のコード

# main.py

# test_moduleモジュールをインポート
import test_module

# 実行時の出力はなし

この仕組みにより、モジュールが直接実行された場合のみgreet関数が実行され、インポートされた際には実行されません。

挙動を確認する例

直接実行

$ python test_module.py
Hello from greet function!

インポート時

$ python main.py
（出力なし）

まとめ

  • import文でモジュールを読み込むと、そのコードが上から順に実行される。
  • 意図しない動作を防ぐために、if __name__ == "__main__": を使用して制御する。
  • この仕組みを理解することで、モジュールの再利用性を高めつつ、予期せぬバグを防ぐことが可能。

モジュールのアトリビュート

Pythonのモジュールには、プログラムの実行時に自動的に設定されるいくつかの特別な関数（アトリビュート）が存在します。これらは、モジュールに関する情報を取得したり、動作を制御する際に役立ちます。

代表的なモジュールのアトリビュート

以下は、よく使用されるモジュールのアトリビュートです。

  1. name: モジュールの名前を保持します。
  2. file: モジュールのファイルパスを保持します。
  3. doc: モジュールのドキュメント文字列（docstring）を保持します。

name の詳細

name は、モジュールが直接実行されたのか、他のモジュールからインポートされたのかを区別するために使用されます。

例: name の動作を確認 test_module.py:

def display_name():
    print(f"モジュール名: {__name__}")

if __name__ == "__main__":
    display_name()

直接実行時

$ python test_module.py
モジュール名: __main__

インポート時 main.py:

import test_module

実行時の出力はありません。インポートされた場合、name はモジュール名（test_module）になります。

他のアトリビュートの例

file: モジュールのファイルパス test_module.py:

print(f"モジュールのファイルパス: {__file__}")

実行結果

$ python test_module.py
モジュールのファイルパス: /path/to/test_module.py

doc: モジュールのドキュメント test_module.py:

"""
このモジュールは、特定のアトリビュートを確認するためのサンプルです。
"""

print(f"モジュールのドキュメント: {__doc__}")

実行結果

$ python test_module.py
モジュールのドキュメント: このモジュールは、特定のアトリビュートを確認するためのサンプルです。

dir関数について

dir関数を使用することで、モジュールが持つすべてのアトリビュートを確認することができます。これは、モジュールにどのような機能やアトリビュートが含まれているかを一覧表示するのに便利です。

使用例 test_module.py:

print(dir())

実行結果

$ python test_module.py
['__annotations__', '__builtins__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__']

dir関数を利用すると、現在のモジュールやオブジェクトのアトリビュートを動的に確認できます。これにより、モジュールの内容を把握したり、デバッグに役立てることが可能です。

アトリビュートの利用例

name を利用した制御の例: test_module.py:

def main_function():
    print("これはメインの機能です。")

if __name__ == "__main__":
    main_function()

このようにすることで、モジュールを直接実行した場合にだけ特定のコードを動作させ、インポート時には実行を避けることができます。

まとめ

モジュールのアトリビュートは、Pythonプログラムを柔軟に構築するための重要な要素です。

これらを活用することで、モジュールの再利用性や可読性を向上させることができます。

おわりに

今回の講座では、Pythonプログラムを効率的に構築するために重要な「モジュール」「パッケージ」「ライブラリ」について詳しく学びました。さらに、インポート時の挙動や特別なアトリビュート、dir関数を利用した属性の確認方法についても解説しました。

これらの知識を活用することで、コードの再利用性が高まり、プログラムの構造をより整理することができます。特に大規模なプロジェクトやチームでの開発において、モジュールやパッケージの設計は非常に重要です。

MQL5システムトレーダーの為のPython講座：第16回「関数について」←

　　　→MQL5システムトレーダーの為のPython講座：第18回「名前空間とスコープについて」

スポンサーリンク
タイトルとURLをコピーしました