SpockでPandocをCharacterization Testする

SpockでPandocのCharacterization Testを行う手順は、以下の通り。なお、Characterization Testとは、テストが用意されていないソースコードに対して、現状の挙動をそのまま記録するテストのこと（もちろん、Pandocは例として使用しているだけで、Pandoc自体がテストされていないという意味ではない）。詳細は、『Working Effectively with Legacy Code Chapter 13』を参照。

 

前提

• dev-xconnecting: PandocをWindowsにインストールする
• dev-xconnecting: EclipseでSpockを試す
• dev-xconnecting: コマンドラインのコマンドをGroovyから実行する

 

手順

まずは、Markdownで書かれた、以下のファイル(header.md)を用意する。

#Header Test

次に、Spockのテストを用意する。

	import spock.lang.Specification
	class HeaderSpec extends Specification {
	def "header characterization test"() {
	when:
	def proc = "pandoc header.md -o header.html".execute()
	proc.waitFor()
	then:
	def result = new File("header.html").getText('UTF-8')
	"" == result
	}
	}

view raw HeaderSpec.groovy hosted with ❤ by GitHub

このテストでは、PandocでMarkdownファイルをHTMLファイルに変換し、そのHTMLファイルの内容をテストしている。期待値が空文字になっているため、当然このテストは失敗する。

Condition not satisfied:

"" == result
   |  |
   |  <h1 id="header-test">Header Test</h1>
   false
   39 differences (0% similarity)
   (--------------------------------------~-~)
   (<h1 id="header-test">Header Test</h1>\r\n)

    at HeaderSpec.header characterization test(HeaderSpec.groovy:10)

実際の変換結果はheader.htmlに出力されているので、その内容をテストコードに反映する。

	import spock.lang.Specification
	class HeaderSpec extends Specification {
	def "header characterization test"() {
	when:
	def proc = "pandoc header.md -o header.html".execute()
	proc.waitFor()
	then:
	def result = new File("header.html").getText('UTF-8')
	"""<h1 id="header-test">Header Test</h1>
	""" == result
	}
	}

view raw HeaderSpec.groovy hosted with ❤ by GitHub

再度テストを実行すると、成功するはずのテストが、まだ失敗する。

Condition not satisfied:

"""<h1 id="header-test">Header Test</h1> //""" == result
                                               |  |
                                               |  <h1 id="header-test">Header Test</h1>
                                               false
                                               3 differences (92% similarity)
                                               <h1 id="header-test">Header Test</h1>(-~)\n(//)
                                               <h1 id="header-test">Header Test</h1>(\r)\n(--)

    at HeaderSpec.header characterization test(HeaderSpec.groovy:10)

どうも、期待値と検証値で改行コードが異なるのが原因らしい。期待値と検証値それぞれでnormalizeメソッドを実行して、改行コードの違いを吸収する。

	import spock.lang.Specification
	class HeaderSpec extends Specification {
	def "header characterization test"() {
	when:
	def proc = "pandoc header.md -o header.html".execute()
	proc.waitFor()
	then:
	def result = new File("header.html").getText('UTF-8')
	"""<h1 id="header-test">Header Test</h1>
	""".normalize() == result.normalize()
	}
	}

view raw HeaderSpec.groovy hosted with ❤ by GitHub

上記の修正後、再度テストを実行すると、無事テストが成功する。

Amazonの「納品書兼領収書」が「納品書」に変更されている件

Amazonから商品が送付される際に基本的に同梱されていた「納品書兼領収書」が、「納品書」に変更されている模様。詳細は、下記リンクに詳しい。

• 今年度からAmazonが「領収書・納品書」の扱いを変更したので要注意

手元にある書類を確認したところ、昨年６月頃から「納品書」に変更されていた。領収書は、注文履歴から印刷が可能。手順については、上記リンクを参照。

なお、Kendle版の書籍の領収書については、これまで通り、別途領収書の発行依頼が必要な模様。上記と同じ手順でKendle版書籍の領収書印刷が可能、という記事やブログをいくつか見かけたが、手元で試した限りは、「領収書」ではなく「注文の詳細」しか表示されなかった。Kendle版書籍の領収書発行を依頼する手順は、下記を参照。

• dev-xconnecting: AmazonにKindle版書籍の領収証を発行してもらう方法
• 【豆知識】Kindle本の領収書のもらい方 : 週刊 ニョキニョキ☆パンチ
  • １年分まとめて発行を依頼する場合は、電話での問い合わせが便利そう

WindowsのSourceTreeでlibiconv-2.dllが見つからないエラーの対処法

Windows版のSourceTreeをインストールしたが、libiconv-2.dllが見つからないエラーに遭遇。この問題を回避するには、Gitのインストールディレクトリ内のbin/libiconv-2.dllをlibexec/git-coreフォルダにコピーする。

なお、SourceTreeから使用するGit(「ツール」－「オプション」－「Git」－「Gitバージョン」で指定可能） はシステムGitを指定している。内蔵Gitを指定しても同様の問題が発生したが、その場合の回避法はわからず。

 

関連リンク

• msysgit – Git for Windows – The Program can’t start because libiconv2.dll is missing – Stack Overflow

WindowsにHaskellをインストールする

WindowsにHaskell処理系のひとつである、Haskell Platformをインストールする手順は、以下の通り。

Haskell Platformのダウンロードページ からリンクをたどって、Windows用のインストーラ（現時点では、HaskellPlatform 2013.2.0.0 for Windows）をダウンロードする。

ダウンロードしたインストーラーはウィザード形式になっているが、デフォルトでのインストールで特に問題はない。

インストール完了後にコマンドプロンプトを起動し、ghciコマンドが実行できることを確認する。

>ghci
GHCi, version 7.6.3: http://www.haskell.org/ghc/  :? for help
Loading package ghc-prim ... linking ... done.
Loading package integer-gmp ... linking ... done.
Loading package base ... linking ... done.
Prelude>

上記のように、対話的なインタープリタが起動する。なお、このインタープリタはCtrl+Dで終了する。

関連リンク

• The Haskell Programming Language
  • Haskell本家？のホームページ
• The Glasgow Haskell Compiler
  • Haskell CompilerであるGHCのホームページ。ダウンロードページには、GHC単体ではなく、Haskell Platformのインストールを促すメッセージあり。

コマンドラインのコマンドをGroovyから実行する

コマンドラインのコマンドを実行するGroovyスクリプトは、以下の通り。

下記の例では、Pandocのバージョン情報を出力している。（Pandocをインストールしていない場合は、実行可能なコマンドに適宜変更すること。なお、Pandocのインストールについては『PandocをWindowsにインストールする』を参照。）

	def proc = "pandoc -v".execute()
	proc.waitFor()
	println proc.in.text
	// if you just want stdout of the command, you can write as:
	println "pandoc -v".execute().text

view raw ExecCommand.groovy hosted with ❤ by GitHub

実行したいコマンドからなる文字列のexecuteメソッドを呼び出すことにより、コマンドの実行を非同期で開始する（１行目）。このメソッドはjava.lang.Processを返す。コマンドの実行が完了するのを待って（２行目）、標準出力の内容をprintlnしている（３行目）。

なお、コマンドが標準出力に出力した内容を確認したいだけなら、６行目のように記述することも可能。

EclipseでSpockを試す

前提

• Spock 0.7
• Groovy 2.0.7

• 動作確認環境
  • Eclipse 4.3 SR1
  • Eclipse Plugin
    • Groovy Eclipse
    • Gradle IDE

動作確認環境の構築手順については、『Gradleを使ってEclipse 4.3＋Groovy Eclipse＋Gradle IDEをインストール』を参照

手順

Eclipseで新規プロジェクト（一般プロジェクト）を作成し、プロジェクト直下に、以下のbuild.gradleを配置する。

	apply plugin: 'java'
	apply plugin: 'groovy'
	apply plugin: 'eclipse'
	repositories { mavenCentral() }
	dependencies {
	compile "org.codehaus.groovy:groovy-all:2.0.7"
	testCompile 'org.spockframework:spock-core:0.7-groovy-2.0'
	}
	task mkdirs << {
	sourceSets.all {
	it.groovy.srcDirs.each { it.mkdirs() }
	it.resources.srcDirs.each { it.mkdirs() }
	}
	}

view raw build.gradle hosted with ❤ by GitHub

コマンドラインでプロジェクトのディレクトリに移動し、以下のタスクを実行する。

gradle mkdirs
gradle cleanEclipse
gradle eclipse

プロジェクトを右クリックし、「Refresh」を選択すると、プロジェクトがGroovyプロジェクトとして認識される。再度プロジェクトを右クリックし、「Configure」－「Convert to Gradle Project」を選択すると、Gladleプロジェクトに変換される。

この時点で、以下の設定も確認しておく。

• 「Windows」－「Preferences」－「Groovy」
  • Use monospace font for JUnit (deprecated)にチェック
  • これにより、JUnit実行時に monospace fontが使用される
• 「Windows」－「Preferences」－「Gradle」
  • Disable underlininig for .gradle files
  • これにより、.gradleファイルを開いた際に、余計な下線が表示されるのを抑止

以下のSpockのテストケース（SampleSpec.groovy）を、「src/test/groovy」に作成する。

	import spock.lang.Specification
	class SampleSpec extends Specification {
	def "test sample"() {
	expect:
	def value = 1
	value == 2
	}
	}

view raw SampleSpec.groovy hosted with ❤ by GitHub

配置したSampleSpec.groovyを右クリックし、 「Run as」－「JUnit Test」を選択するとテストが実行される、テストが失敗する（このテストは意図的に失敗するよう書かれている）。

以下のように修正し、再度テストを実行すると、テストが成功することを確認できる。

	import spock.lang.Specification
	class SampleSpec extends Specification {
	def "test sample"() {
	expect:
	def value = 2
	value == 2
	}
	}

view raw SampleSpec.groovy hosted with ❤ by GitHub