プロジェクト作成～【連載】実況パズルプログラミング

実況パズルプログラミングの連載第3回目です。 パズルアプリケーションを作成しながら、作成過程で思ったこと、考えたこと、検討したことなどをブログ風に書いていきます。

今回はプロジェクトのディレクトリ作成からです。

プロジェクト構成を決める

今までJavaのプロジェクトでは最低以下の3つのディレクトリを作成していました。

• src
• doc
• test

さて今回はPythonで開発するのでPythonの流儀に従うのが良さそうです。 さっそく「Python ディレクトリ構成」でGoogle検索します。 いろいろな人がいろいろなことを述べていて何を採用してい良いのかはっきりしません。 また初心者なのでパッケージ、モジュールとかも良く分かっていません。

比較的分かりやすかった次のサイトを参考にディレクト構成を決めます。

【図で解説】Python アプリケーション推奨のフォルダ構成（ディレクトリ構成）

• okoze（プロジェクトトップ）
  • okoze（パッケージ）
    • __init__.py
    • __main__.py（モジュール）
  • docs
  • tests

プロジェクトを作成する

それではプロジェクトを作成しましょう。 Eclipseを起動し以下の手順でプロジェクトを作成します。

1. メニューから［ファイル］［新規］［PyDevプロジェクト］を実行
   • プロジェクト名を「okoza」にして「完了」ボタンを押す
2. メニューから［ファイル］［新規］［PyDevパッケージ］を実行
   • ソース・フォルダーが「/okoze」になっていることを確認する
   • 名前を「okoza」にして「完了」ボタンを押す
3. メニューから［ファイル］［新規］［PyDevモジュール］を実行
   • ソース・フォルダーとパッケージを確認
   • 名前を「__main__」にして「完了」ボタンを押す
   • テンプレートは「モジュール：メイン」を選択して「OK」ボタンを押す
4. メニューから［ファイル］［新規］［フォルダー］を実行
   • プロジェクト直下に「docs」フォルダー作成
5. 同様に「tests」フォルダーを作成

以上の操作で次のようになりました。

「__init__.py」は手順2で自動的にできます。 「Python」は手順1で自動的にできます。 「__main__.py」の「@author:OGAWA Keiji」の部分はWindowsのログインユーザー名になるので変更しました。 自動で変更したい場合は「eclipse.exe」と同じディレクトリにある「eclipse.ini」に次の行を追加してください。

-Duser.name=OGAWA Keiji

プロジェクトを実行する

実行確認できるように__main__.pyに次の一行を追加して保存します。

    print('Hello, world!')

「okozeモジュール」で右クリックしてポップアップメニューから［実行］［Python実行］を実行します。 うまくいけばコンソール画面に「'Hello, world!'」と表示されます。

先ほど参考にしたサイトには次のように実行する方法が書いてあります。

Python -m プロジェクト名

「-m」オプションを付けないと「__init__.py」が実行されないそうです。 コンソールを開いて実験してみたところまさしくその通りでした。 Eclipseでは上記の方法で実行すると「__init__.py」が実行されませんでした。 そこでメニューの「実行」「実行構成」を開いて次のように引数を変更すると「__init__.py」が実行されるようになりました。

ついでに名前を変えてお気に入りに入れました。

次回に続く

「GitHubとの連携」が残りました。今回はここまでとします。続きは次回で、またお会いしましょう。