= PyDevでTracのPluginを開発する。 =

PyDevはEclipsのPython用プラグイン。[[BR]]これをつかってTracのPlugin開発をしてみる。

前提ソフトは以下のもの。他のバージョンで動くかどうかは不明。(追記：WindowsXP,Trac0.11rc1でもOKでした)

  * Windows Vista
  * JDK1.6
  * Eclipse Version: 3.3.1.1 Build id: M20071023-1652
  * Python 2.5
  * Trac 0.11dev-r5883

とりあえず上のものは、インストールされており、動くこと。[[BR]]tracも、プロジェクトをつくり、tracdで動く状態にしておく。

まず、Eclipsを起動し、PyDevをインストールする。[[BR]]メニューのウィンドウ→ヘルプ→ソフトウェアの更新→検索およびインストール...。[[BR]]ダイアログが出るので、「インストールする紳士フィーチャーを検索」を選択して「次へ＞」。[[BR]]「新規リモート・サイト」を押して以下のように入力。[[BR]]その後、インストールダイアログの終了ボタンを押すとインストーラが走る。

[[Image(image_thumb5.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image11.png)]]

メニューのウィンドウ→設定。[[BR]]インタープリター-Pythonを左のツリーで選び、右上の「新規」ボタンを押してpython.exeのパスを入力する。[[BR]]PYTHONPATHにどれを含めるか聞かれるけど、とりあえずデフォルトで。[[BR]]強制組み込みライブラリーとかはとくに触らない。[[BR]] [[Image(image_thumb7.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image15.png)]]

プロジェクトを作る。[[BR]]メニューのファイル→新規→PyDevプロジェクト。[[BR]]プロジェクト・タイプでPythonのバージョンを選択。[[BR]]「デフォルトの'src'フォルダーを作成し、…」のチェックボックスは外しておく。[[BR]]ちなみに、ディレクトリーに書いてあるパスにフォルダが作られる。[[BR]] [[Image(image_thumb13.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image27.png)]]

上記でつくられたフォルダの中に、プラグインのソースをコピーする。[[BR]]（ここでは、もう開発中のプラグインのソースが存在する前提で書いてます。[[BR]]なければ、TracHackのチュートリアルのソースでも使ってください。）[[BR]]プロジェクト名を右クリックして「更新」を選ぶとパッケージエクスプローラに表示される。[[BR]]ちなみ私の環境はこんな感じ。[[BR]]プラグイン別にフォルダを分けてます。[[BR]] [[Image(image_thumb15.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image31.png)]] [[BR]]

プラグインを開発するときは、プラグインの開発版をインストールするフォルダを別に用意しておくとよい。[[BR]]上記の例で言うとpythonpathというフォルダがそれ。とりあえずフォルダを作る。[[BR]]作ったら、コマンドプロンプトで以下のように入力し、プラグインをコンパイルする。[[BR]]ちなみに、引数の「develop」をつけておくと、ソース変更時にいちいちEggを作り直す必要がない。

||> CD プラグインのsetup.pyのあるフォルダ[[BR]]> python setup.py develop --install-dir=上で作ったプラグイン開発版インストールフォルダ||


プラグイン開発版インストールフォルダを作ったら、プロジェクトを選んで右クリックし「プロパティー」を選択。[[BR]]プロパティダイアログでPyDev - PYTHONPATHを選び、作ったフォルダを追加する。

||ここ以外にもPYTHONPATHを入力できるところがあるけど、ここで入力しないと実行時に反映されないみたい。||

[[Image(image_thumb19.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image39.png)]]

[[BR]]次にEclipsからTracdを起動できるようにする。[[BR]]メニューの実行→実行ダイアログを開く...。[[BR]]「Python 実行」を右クリックして「新規」を選択。[[BR]]Mainタブでは名前、プロジェクト、メイン・モジュールを入力。（メインモジュールは参照ボタンを押さずに直接tracd-script.pyのパスを入力する。）[[BR]] [[Image(image_thumb17.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image35.png)]] [[BR]]おなじくArgumentsタブを入力する。[[BR]]プログラムの引数は適当に変えること。

||tracdには-rというオプションがあり、これを使うといちいちtracdの再起動をしなくてもソースの変更が即反映されるんだけど、WindowsのPyDevでそれを指定してはいけない。実行後にtracdを終了できなくなる。[[BR]][[BR]]-rつきだと、監視役と動作役の２つのPythonプロセスが起動するみたい。PyDevからの終了では、1つ(監視役？)しか終了しない。[[BR]][[BR]]簡単にPythonプロセスを止める方法は、もうちょっと下にある「つづき」を参照||

[[Image(image_thumb25.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image49.png)]]

環境タブ。[[BR]]エンコードをUTF-8にする。[[BR]]お気に入りのメニュに表示を選ぶ。[[BR]]バックグラウンドでの起動をチェックする。[[BR]] [[Image(image_thumb27.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image53.png)]]

実行してみる。[[BR]] [[Image(image_thumb31.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image61.png)]]

ブラウザでURLにアクセス。[[BR]]（ちなみに作ったプラグインをAdminタブなりtrac.iniで有効にしておないと当然プラグインは認識されません。注意）[[BR]] [[Image(image_thumb33.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image65.png)]] [[BR]] [[Image(image_thumb35.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image69.png)]]

止めるには、コンソールの赤いボタンを押す。

[[Image(image_thumb37.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image73.png)]]

以上。デバッグも動いたよ。[[BR]]

== つづき ==

上記でも一通り動くんですが、

  * tracdを複数同時に起動できてしまう。 気づくとpython.exeプロセスがいっぱい。
  * 一度とめて再起動はめんどくさい。オートリロードみたいなの欲しい。

というわけで、複数同時起動を防止しつつ簡単に再起動できる方法を考えてみました。

= 手順： =

=== 1. 以下のVBScript(KillOldPython.vbs)を適当なフォルダにおく。 ===

||strComputer = "."[[BR]]Set objWMIService = GetObject("winmgmts:" _[[BR]]    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")[[BR]]Set colProcessList = objWMIService.ExecQuery _[[BR]]    ("Select * from Win32_Process Where Name = 'Python.exe' ")'WMIにはソート機能がないので、自前で最後に起動したプロセスを探す。[[BR]]lastTime =0[[BR]]For Each objProcess in colProcessList[[BR]]     If objProcess.CreationDate > lastTime Then[[BR]]        lastTime = objProcess.CreationDate[[BR]]        lastProcessId = objProcess.ProcessId[[BR]]    End If[[BR]]Next[[BR]]'最後に起動したプロセス以外を終了する。[[BR]]For Each objProcess in colProcessList[[BR]]    If objProcess.ProcessId <> lastProcessId Then[[BR]]        objProcess.Terminate()[[BR]]    End If[[BR]]Next||

=== 2. C:\Python25\Scripts\tracd-script.pyを元に、以下のようなtracd-script-dev.pyを作る。 ===

sys.exitのまえでKillOldPython.vbsを呼び出すようにします。パスやバージョンは環境に合わせること。

||#!C:\Python25\python.exe[[BR]]# EASY-INSTALL-ENTRY-SCRIPT: 'Trac==0.11dev-r5883','console_scripts','tracd'[[BR]]!__requires!__ = 'Trac==0.11dev-r5883'[[BR]]import sys[[BR]]import os[[BR]]from pkg_resources import load_entry_pointos.system(r"wscript.exe C:\Python25\Scripts\KillOldPython.vbs")sys.exit([[BR]]   load_entry_point('Trac==0.11dev-r5883', 'console_scripts', 'tracd')()[[BR]])||

=== 3.PyDevの実行ダイアログで、tracd-script-dev.pyを起動するよう設定する。 ===

[[Image(image_thumb2_thumb.png, link=attachment:wiki:TracDoc/PyDevWithTrac:image_thumb2[2].png)]]

以上。

これを起動すると、自分以外のpython.exeプロセスを殺してからtracが起動します。[[BR]]ワンクリック再起動（実際には２クリックだけど）できます。

注意：tracd以外にpython.exeが動いていると、そいつも終了させてしまいます。[[BR]]プロセスを見て、常に動いているpython.exeがいないか確認してから設定すること。