Pythonパッケージの作成とアクセス方法を徹底解説！初心者向けガイド

この記事では、Pythonにおけるパッケージ（Package）について解説します。パッケージを使うことで、モジュールやコードを階層的に整理し、大規模なプロジェクトでも見通しの良い構成を実現できます。ここでは、パッケージの基本的な作り方から、サブパッケージへのアクセス方法まで、具体例とともにわかりやすく紹介します。

Pythonパッケージとは？

パッケージとは、関連する複数のモジュール（.pyファイル）をひとつのディレクトリにまとめたものです。パッケージを利用することで、コードの再利用性が高まり、プロジェクト全体の保守性も向上します。

パッケージの作成方法

Pythonでディレクトリをパッケージとして認識させるには、そのディレクトリ内に __init__.py ファイルを配置する必要があります。このファイルの中身は空でも、任意のコードが書かれていても問題ありません。Pythonはこのファイルの存在をもって「このディレクトリはパッケージである」と判断します。

パッケージを作成する手順は以下の通りです。

• ディレクトリを作成し、その中に __init__.py ファイルを配置して、Pythonにパッケージであることを認識させます。
• 必要に応じて、モジュール（.pyファイル）やサブパッケージを追加します。
• import 文を使って、パッケージ内のモジュールやクラスにアクセスします。

シンプルなパッケージを作ってみよう

まずは、以下のような構造を持つ「university」という名前の簡単なパッケージを作成してみましょう。

university/
├── __init__.py
├── student.py
└── faculty.py

お使いのPC上の任意の場所に、上記のフォルダ構成を作成してください。次に、各ファイルに以下のコードを記述します。

student.py と faculty.py のコード例

# student.py
class Student:

    def __init__(self, student):
        self.name = student['name']
        self.gender = student['gender']
        self.year = student['year']

    def get_student_details(self):
        return f"Name: {self.name}\nGender: {self.gender}\nYear: {self.year}"


# faculty.py
class Faculty:

    def __init__(self, faculty):
        self.name = faculty['name']
        self.subject = faculty['subject']

    def get_faculty_details(self):
        return f"Name: {self.name}\nSubject: {self.subject}"

上記のコードをそれぞれ student.py と faculty.py に保存します。続いて、これらのクラスにアクセスするためのファイルを作成しましょう。パッケージのディレクトリ内に testing.py というファイルを作成し、以下のコードを記述してください。

testing.py のコード例

# testing.py
# 各ファイルから Student クラスと Faculty クラスをインポート
from student import Student
from faculty import Faculty

# 学生と教員の情報を辞書で作成
student_dict = {'name': 'John', 'gender': 'Male', 'year': '3'}
faculty_dict = {'name': 'Emma', 'subject': 'Programming'}

# Student クラスと Faculty クラスのインスタンスを生成
student = Student(student_dict)
faculty = Faculty(faculty_dict)

# 学生と教員の詳細情報を取得して表示
print(student.get_student_details())
print()
print(faculty.get_faculty_details())

testing.py を実行すると、以下の出力が得られます。

実行結果

Name: John
Gender: Male
Year: 3

Name: Emma
Subject: Programming

これで、Pythonにおけるパッケージの作成方法とアクセス方法の基本が理解できました。実際のプロジェクトでは、ひとつのパッケージの中に多数のサブパッケージやファイルが含まれることも珍しくありません。次は、サブパッケージ内のモジュールへのアクセス方法を見ていきましょう。

サブパッケージのモジュールにアクセスする

まず、以下のような階層構造を持つディレクトリを作成します。

university/            ← パッケージ
├── __init__.py
├── student/           ← サブパッケージ
│   ├── __init__.py
│   ├── main.py
│   └── ...
└── testing.py

先ほどの学生に関するコードを main.py にコピーしてください。そして、testing.py からサブパッケージ内のクラスへアクセスする方法を見てみましょう。testing.py に以下のコードを追加します。

testing.py のコード例

# testing.py
from student.main import Student

# 学生の情報を辞書で作成
student_dict = {'name': 'John', 'gender': 'Male', 'year': '3'}

# Student クラスのインスタンスを生成
student = Student(student_dict)

# 学生の詳細情報を取得して表示
print(student.get_student_details())

testing.py を実行すると、以下の出力が得られます。

実行結果

Name: John
Gender: Male
Year: 3

このように、ドット（.）を使うことで、サブパッケージ student 内の main.py ファイルから Student クラスにアクセスできました。パッケージの階層構造に応じて、「package.subpackage.module」のようにドットでつなげることで、何階層でも深くアクセスすることが可能です。

まとめ

本記事では、Pythonにおけるパッケージの作成方法と、パッケージ・サブパッケージ内のモジュールへのアクセス方法を学びました。ポイントは以下の通りです。

• ディレクトリに __init__.py を配置することで、そのディレクトリはパッケージとして認識される。
• import 文を使えば、パッケージ内のクラスや関数を自由に利用できる。
• ドット表記により、ネストされたサブパッケージのモジュールにもアクセス可能。

パッケージを活用すれば、コードの整理整頓が容易になり、規模の大きなプロジェクトでも効率的に開発を進められます。ぜひ実際に手を動かして、パッケージの仕組みを体感してみてください。