Kanon(Trac Lightning)のプロジェクト移行手順

ちょっと試してみたのでメモ。
サーバーのPCを変更する等で、Kanon(Trac Lightning)のプロジェクトを他のPCのKanonに移行する手順です。
KanonとかTrac Lightningについての詳細はググって調べてみてください。
以下、Linux(CentOS6)上で動作させています。
※以下の手順は一例です。やり方は色々あるはず。
※Kanonのインストールについてはまた別途。。。

移行データの準備

以下、移行元PCで実行します。

各プロジェクトの移行データ

各プロジェクトのTrac,SVNのデータを移行用ファイルに出力します。
以下のように、trac-adminとsvnadminのhotcopyまたはdumpを実行します。
これを各プロジェクト名について実行します。

trac-admin /var/opt/kanon/trac/(プロジェクト名) hotcopy (プロジェクト名)_trac

svnadmin dump /var/opt/kanon/svn/(プロジェクト名) > (プロジェクト名)_svn.dmp

＃trac-adminはパスが通ってなかったので/usr/bin/trac-adminとして実行したはず。。。

ユーザー情報

Kanonが管理しているユーザー情報は上記のファイルには存在しません。

/etc/opt/kanonのkanon_users.htdigestとsvnauthzが必要になりますので、どこかにコピーしておきます。

移行データを反映

以下、移行先PCで実行します。

各プロジェクト

まずSVN側を。

svnadmin create /var/opt/kanon/svn/(プロジェクト名)

svnadmin load /var/opt/kanon/svn/(プロジェクト名) < (プロジェクト名)_svn.dmp

次にTrac側を。

cp -Rf (プロジェクト名)_trac /var/opt/kanon/trac/(プロジェクト名)

コピー後、/var/opt/kanon/trac/(プロジェクト名)/conf/trac.iniの中身を確認し、移行前のIPアドレスや存在しないパスがあれば修正します。

Tracの更新(Tracのバージョンが最新であれば実行不要と思います)。

trac-admin /var/opt/kanon/trac/(プロジェクト名) upgrade

trac-admin /var/opt/kanon/trac/(プロジェクト名) wiki upgrade

 SVNと同期。ちなみに「trac-admin /var/opt/kanon/trac/(プロジェクト名) resync」ではエラーが出て実行できません。

trac-admin /var/opt/kanon/trac/(プロジェクト名) repository resync ""

ユーザー情報

コピーした移行前のkanon_users.htdigestとsvnauthzを/etc/opt/kanon配下にコピー。

移行データのアクセス権設定

以下の通り実行。

chwon -R apache:apache /var/opt/kanon/trac/(プロジェクト名)

chwon -R apache:apache /var/opt/kanon/svn/(プロジェクト名)

反映完了

apache再起動。

/etc/init.d/httpd restart

TinyPG(a Tiny Parser Generator) その2

ちょっと間が空きました。TinyPGの続きを。

構文解析ツールの中でもTinyPGが良いと思うところは、定義した構文解析の処理をC#またはVBのソースコードで生成してくれることです。アプリ開発で構文解析機能を作る場合、専用のライブラリを用意する必要は無く、TinyPGで生成したソースコードを組み込めば実現できるわけです。

ソースコードの生成

前回の続きになります。
前回で構文解析したときに(メニューでBuildを実行したら)、実はソースコードが生成されています。
構文解析定義の@TinyPGの行に定義してある設定に従い生成されています。

Languageには"C#"か、"VB"が指定できます。生成するソースコードの言語の種別です。
OutputPathにはソースコードの生成パスを指定します。ちなみに、末尾に¥を付加しないと最後の¥から末尾までをファイル名として生成します。つまり上記の画像の設定ではC:¥配下にwork***.csのようなファイルを生成します。

さて、OutputPathで指定したパスにソースコードが4ファイル生成されているはずです。
それぞれ以下の機能を持ちます(LanguageがC#の場合)。

Parser.cs、Scanner.cs、ParseTree.cs
解析対象の文字列を読み込み・解析・分解・生成(コンパイル)します。

TextHighlighter.cs
解析対象の文字列を解析し、構文解析定義に定義した配色設定に従った情報を生成します。TinyPGで構文解析すると、Expression Evaluatiorにある文字列が構文解析定義の記述に従い配色されますが、その仕組みをC#ソースにしたものです。
RichTextBoxで使用可能な配色情報を用意します。

アプリケーションへの組み込み

実際にアプリケーションに組み込みます。
上記のソースコードをC#プロジェクトに組み込んだ後、以下の記述を実行したい箇所に記述します(以降、必要なusingは省略しています)。

// 解析したい文字列
string input = "... your expression here ...";
// 解析
// 結果はParseTreeに格納される
Parser parser = new Parser(new Scanner());
ParseTree tree = parser.Parse(input);

これで任意の文字列を解析できます。
TextHighlighter.csについては以下のような記述を行います。

// 解析したい文字列
string input = "... your expression here ...";
// 解析処理のインスタンス生成
Scanner scanner = new Scanner();
Parser parser = new Parser(scanner);
// 表示させたいrichTextbox、各インスタンスを指定する
TextHighlighter highlighter = new TextHighlighter(richTextbox, scanner, parser);

解析したい文字列への配色が不要ならば、上記は記述しなくとも解析自体は可能です。

解析結果

解析結果はParseTreeクラスに設定されます。PaeseTreeクラスは木構造に従い再帰的に子を持ちます。TinyPGのOutputにあるParse Tree表示と同様のデータ構造です。
詳しくはまた次回。。。

ソレデハ。 

TinyPG(a Tiny Parser Generator)

やっと一発目。TinyPGを。

TinyPG(a Tiny Parser Generator)とは、Herre Kuijpers氏が作成したC#(またはVB)パーサージェネレーターです。
LL(1)に基づく構文解析を行うソースを生成します。
※LL(1)とか構文解析とかの意味は各自ググってください。

実行ファイル入手

tinyPGの公開サイトからファイルをダウンロードします。
とりあえず動かすだけならサイトの「Download TinyPG v1.3 binaries - 88.9 KB」をクリックしてダウンロード＆任意のフォルダに解凍しましょう。
※ダウンロードするにはCODEPROJECTのアカウントが必要です。

実行

解凍したフォルダの中のTinyPG.exeを実行します。

画面が表示されるので、メニューのView - Outputを選択します。同様に、View - Expression evaluatorを選択します。

画面が三分割されます。それぞれ、

左上　：構文解析定義

左下　：解析したい構文

右半分：解析結果

を表示します。

構文解析してみる

実際に構文解析してみます。手っ取り早くサンプルを使ってみます。

メニューのHelp - Examplesを選択すると構文解析定義のサンプルがいくつかあります。今回はSimple Expression calculator(簡単な計算式の構文解析)を選択します。

選択すると構文解析定義がメモ帳(とか)で表示されるので、TinyPGの画面左上にコピペします。

ついでに、画面左下に

(1-2)+(3*4)

と入力しておきます。

ここまでできたらF5キーを押下するか、メニューのBuild - Generate & Runを選択します。途中、構文解析定義を保存するためのダイアログが表示されますが、適当なパスに保存して問題なしです。

構文解析結果

上記を行うとOutputに解析結果が出力されます。

一番下の行に

Evaluating...
Result: 11

と表示されますが、これが(1-2)+(3*4)の構文解析した結果になります。

また、Parse Treeには字句をどうやって分解したか、構文木を表示します。

構文解析定義をどうやって記述するかとかは後ほど。。。

ソレデハ。 

ブログ始めました

ブログ始めました。ソフトウェア開発の技術情報について色々と書いていきます。特にマニアックなの(他の人が書いていなさそうなもの)を中心に。