【本日のミッション】
Day46では「標準ライブラリ pathlib とファイルパス操作」を学びました。
今日は Python プログラムを整理するための重要な仕組み パッケージ構造と __init__.py を学びます。
複数のモジュールをまとめて扱うとき、フォルダ構造とこのファイルがどのように関わるのかを理解することがポイントです。
目次
パッケージとは?
パッケージ とは、複数のモジュールをまとめた「フォルダ単位のモジュール集」です。
Python はフォルダに __init__.py があると、そのフォルダをパッケージとして認識します。
-
mypackageフォルダに__init__.pyがあることで「パッケージ」として扱われる -
main.pyからmypackage.module1をインポートできる
__init__.py の役割
__init__.py は、パッケージの初期化を行う特別なファイルです。
フォルダ内にこれがあることで「ここはPythonパッケージです」と示します。
また、パッケージがインポートされた際に最初に実行されます。
出力結果
-
__init__.pyがある → Python はそのフォルダをモジュールとして認識 -
パッケージ読み込み時に初期化処理を記述できる
パッケージから特定の関数をインポート
__init__.py 内で他のモジュールをインポートすると、外部から簡単に呼び出せます。
これにより、次のように呼び出せます。
-
__init__.py内でモジュールをまとめておくと、外部からシンプルに呼べる -
「
.」は相対インポートを表す
空の __init__.py でもOK
Python 3.3以降では、__init__.py がなくてもフォルダをモジュールとして扱う「名前空間パッケージ」が導入されました。
しかし、明示的に __init__.py を置く方が安全・互換性が高い ため、現場では今も使用されます。
-
互換性を考えると、空でも
__init__.pyを置くのがベストプラクティス
練習問題
次のディレクトリ構造で、main.py から module1 の greet() を呼び出す正しい方法はどれですか?
module1.py の内容:
選択肢
A)
import module1
B)
from mypackage import module1
C)
import mypackage.module1
D)
from module1 import greet

解答
B)
from mypackage import module1
解説
module1 は mypackage の中にあるため、mypackage を経由してインポートする必要があります。
from mypackage import module1 と書くことで正しく呼び出せます。
👉 正解は
B)
from mypackage import module1
✅ ポイント
-
__init__.pyはフォルダを「パッケージ」として認識させるファイル -
インポート時に実行され、初期化処理を書ける
-
他モジュールをまとめてインポートすることも可能
-
Python 3.3以降は省略可能だが、互換性のために置くのが望ましい
次回予告
Day48では「自作モジュールの作成とインポート」です。
Python の重要な再利用機能を学びましょう。
参考
Python 3 エンジニア認定基礎試験 – Odyssey CBT
Python3 エンジニア認定基礎試験 出題範囲と学習プラン
Python3 エンジニア認定基礎試験 練習問題 Day1:変数の基本
Python3 エンジニア認定基礎試験 練習問題 Day2:変数の型(int型とstr型)
Python3 エンジニア認定基礎試験 練習問題 Day3:算術演算子と代入演算子
Python3 エンジニア認定基礎試験 練習問題 Day4:文字列の操作
Python3 エンジニア認定基礎試験 練習問題 Day5:比較演算子と論理演算子
Python3 エンジニア認定基礎試験 練習問題 Day6:if文(条件分岐)
Python3 エンジニア認定基礎試験 練習問題 Day7:ループ処理(for文・while文)
Python3 エンジニア認定基礎試験 練習問題 Day8:break文とcontinue文
Python3 エンジニア認定基礎試験 練習問題 Day9:リスト(list)の基本
Python3 エンジニア認定基礎試験 練習問題 Day10:リストの操作(append,remove,len など)
Python3 エンジニア認定基礎試験 練習問題 Day11:リストのスライス(部分取り出し)
Python3 エンジニア認定基礎試験 練習問題 Day12:タプル(tuple)の基本
Python3 エンジニア認定基礎試験 練習問題 Day13:辞書(dict)の基本
Python3 エンジニア認定基礎試験 練習問題 Day14:集合(set)の基本
Python3 エンジニア認定基礎試験 練習問題 Day15:関数の定義と呼び出し
Python3 エンジニア認定基礎試験 練習問題 Day16:関数のデフォルト引数とキーワード引数
Python3 エンジニア認定基礎試験 練習問題 Day17:可変長引数(*args, **kwargs)
Python3 エンジニア認定基礎試験 練習問題 Day18:関数のスコープ(ローカル変数とグローバル変数)
Python3 エンジニア認定基礎試験 練習問題 Day19:ネスト関数(関数の中の関数)
Python3 エンジニア認定基礎試験 練習問題 Day20:ラムダ式(無名関数)
Python3 エンジニア認定基礎試験 練習問題 Day21:組み込み関数(len, type, range など)
Python3 エンジニア認定基礎試験 練習問題 Day22:組み込み関数(sum,max,min,sorted)
Python3 エンジニア認定基礎試験 練習問題 Day23:文字列と組み込み関数(len,str,int,float)
Python3 エンジニア認定基礎試験 練習問題 Day24:組み込み関数(abs, round, pow)
Python3 エンジニア認定基礎試験 練習問題 Day25:組み込み関数(sorted の応用と key 引数)
Python3 エンジニア認定基礎試験 練習問題 Day26:組み込み関数(enumerate, zip)
Python3 エンジニア認定基礎試験 練習問題 Day27:組み込み関数(map, filter, reduce)
Python3 エンジニア認定基礎試験 練習問題 Day28:組み込み関数(any, all)
Python3 エンジニア認定基礎試験 練習問題 Day29:組み込み関数(isinstance,issubclass)
Python3 エンジニア認定基礎試験 練習問題 Day30:組み込み関数(callable, eval)
Python3 エンジニア認定基礎試験 練習問題 Day31:組み込み関数(dir, help)
Python3 エンジニア認定基礎試験 練習問題 Day32:組み込み関数(id, hash)
Python3 エンジニア認定基礎試験 練習問題 Day33:組み込み関数(repr, format)
Python3 エンジニア認定基礎試験 練習問題 Day34:組み込み関数(globals, locals)
Python3 エンジニア認定基礎試験 練習問題 Day35:組み込み関数(vars, callable)
Python3 エンジニア認定基礎試験 練習問題 Day36:組み込み関数(reversed, slice)
Python3 エンジニア認定基礎試験 練習問題 Day37:組み込み関数(getattr, setattr, hasattr, delattr)
Python3 エンジニア認定基礎試験 練習問題 Day38:組み込み関数(eval, exec, compile)
Python3 エンジニア認定基礎試験 練習問題 Day39:組み込み関数(zip の応用・辞書との組み合わせ)
Python3 エンジニア認定基礎試験 練習問題 Day40:モジュールの基本(import と from の違い)
Python3 エンジニア認定基礎試験 練習問題 Day41:as(別名インポート)と import の仕組み
Python3 エンジニア認定基礎試験 練習問題 Day42:標準ライブラリ(math モジュールの基本)
Python3 エンジニア認定基礎試験 練習問題 Day43:標準ライブラリ(random モジュールの活用)
Python3 エンジニア認定基礎試験 練習問題 Day44:標準ライブラリ(datetime モジュールの使い方)
Python3 エンジニア認定基礎試験 練習問題 Day45:標準ライブラリ(os と sys)
Python3 エンジニア認定基礎試験 練習問題 Day46:標準ライブラリ(pathlib とファイルパス操作)
Python3 エンジニア認定基礎試験 練習問題 Day47:パッケージ構造と __init__.py
Python3 エンジニア認定基礎試験 練習問題 Day48:自作モジュールの作成とインポート
Python3 エンジニア認定基礎試験 練習問題 Day49:例外処理の基本(try, except)
Python3 エンジニア認定基礎試験 練習問題 Day50:複数例外の処理と except as