プロジェクト構成¶

Python のソースコードを管理する際にディレクトリの構成をちゃんと考えておくことはとても重要なことです。なぜなら Python は適切な構成になっていないとプログラムを正しく動かすことができなくなるからです。そこで Python 開発ではどのような構成で管理すれば問題が起こりにくいのかについて説明します。

The Hitchhiker's Guide to Python¶

Python の理想のプロジェクト構成は Kenneth Reitz 氏によって推奨されている構成に従うのがよいでしょう。どのような構成なのかはThe Hitchhiker’s Guide to Python というサイトのStructuring Your Project の章で詳しく書かれていますのでそちらを参考にしてもらうことにして、ここでは特に注意すべきことについてまとめておきます。

ディレクトリの基本構成は次のとおりです。

(project)├── (project)  ............ プログラムのソースコードディレクトリ│  ├── __init__.py│  └── *.py└── tests  ................ 単体テストのソースコードディレクトリ   ├── __init__.py   └── *.py

(project) の部分は開発する Python プログラムの名前を付けます。sample というプログラムを開発するなら

sample├── sample│  ├── __init__.py│  └── *.py└── tests   ├── __init__.py   └── *.py

のようになります。大事なのはプログラムのソースコードは必ず(project) 配下の 1 つのディレクトリ内に集約させるということです（単体テストのソースコードは除く）。なぜならディレクトリは Python のパッケージを構成するものなので、複数のディレクトリでソースコードを管理すると複数の Python パッケージを開発していることになります。しかし通常 1 つのプロジェクト内に複数のパッケージを含めて開発することはありません。

ソースコードが 1 つで十分な場合はディレクトリを用意しなくても大丈夫です。

(project)├── (project).py  ........... プログラムのソースコードディレクトリ└── test_(project).py  ...... 単体テストのソースコードディレクトリ

下記は良くない構成の一例です。

sample├── sample│  ├── __init__.py│  └── *.py├── libs  ................. よくないディレクトリ│  ├── __init__.py│  └── *.py└── tests   ├── __init__.py   └── *.py

下記はsample/__init__.py が用意されていないため問題のある構成です。ディレクトリ内に Python ファイルを入れる場合は必ず__init__.py を用意してください。

sample├── sample│  └── *.py└── tests   └── *.py

下記のような構成もやってしまいがちですが適切ではありません。

sample├── sample│  ├── __init__.py│  └── *.py├── main.py└── tests   ├── __init__.py   └── *.py

main.py

#!/usr/bin/env pythonimportsampledefmain():# sample パッケージを使った処理...if__name__=='__main__':main()

この構成の問題点はライブラリとアプリケーションの区別ができていない構成になっているという点です。

この例だとsample はライブラリでmain.py はアプリケーションという位置づけになります。もしライブラリとアプリケーションの両方の側面を持つプログラムを書きたいという場合はmain.py をsample/__main__.py という名前で保存してください。

sample├── sample│  ├── __init__.py│  ├── __main__.py│  └── *.py└── tests   ├── __init__.py   └── *.py

そしてmain() を実行したい場合はターミナル上で次のようにします。

$python3-msample

$py-3-msample

こうするとsample/__main__.py が実行されるようになります。決して

$python3sample/__main__.py

$py-3sample/__main__.py

のように実行してはいけません。たとえ動いたとしてもいつもうまくいくと期待しないほうがいいでしょう。