テストとリファクタリング

どちらの言葉も齟齬が生じやすいのですが、認識の違いを改める上で
t_wada さんがまとめた資料(PDF)がとても参考になります。
 
– 「Test」という言葉について
 テスト, TDDの定義と目的について。
 
– リファクタリングとテストの関係
 リファクタリングの定義と、リファクタリングにおいてテストが受け持つ役割について。

symfony でのテスト(単体テスト/機能テスト)

symfony でのテストは機能テスト(functional test)、単体テスト(unit test)が標準でサポートされており、それぞれ以下の特徴があります。
 
□機能テスト
– モジュール生成時に test/functional に自動生成される。
– test/{$app}/{$module}ActionsTest.php というファイル名($app,$module はそれぞれテスト対象のアプリケーション名とモジュール名)
– テスト用仮想 symfony サイトブラウザ クラスの sfTestBrowser を使ったモジュール単位のテストが中心。
– 最初からデフォルトのテスト実装がある
  (ver 1.0.6 時点のデフォルトテスト実装は、モジュールの index アクションが初期のままではないかをテストするというもの)
– テスト実行は

symfony test-functional <appname>

  もしくは

symfony test-all

  で行う
 
□単体テスト
– 機能テストのような自動生成はされないが、test/bootstrap/unit.php をインクルードすることで容易にテストを作成可能。
– test/unit/{$testName}Test.php というファイル名($testName は任意の名前)
– 汎用単体テストクラス lime_test を使った、ライブラリ等のクラスを対象にした個別のテストが中心。
– テスト実行は

symfony test-unit

  もしくは

symfony test-all

  で行う
 
なお、単体、機能どちらのテストも

php test/functional/appname/fooActionsTest.php

のように PHP スクリプトとして実行すると、そのテストだけを実行することができます。
このようにすることで、失敗したテストがどの項目で失敗したかを調べることができます。
 
■sfTestBrowser クラス
sfBrowser クラスのテスト用実装版(sfBrowser の子クラス)。
sfBrowser クラスはTCP 等ネットワーク通信を伴わずに symfony サイト内ページのブラウジング可能な仮想ブラウザ実装です。
 
■lime_test クラス
lime の汎用単体テストクラス。
lime は symfony チーム開発のユニットテストユーティリティです。
 
備考:
 どちらのクラスについても、メソッドの戻り値いがオブジェクト自身のインスタンスを返してくれるので

$t->get(…)->is…(…)->is…(…)

のようにテストのチェインができるため、SimpleTest などの xUnit 互換のものより記述が容易になっています。
参考:
– sfTestBrowser (symfony API)
– sfBrowser (symfony API)
– lime_test class
 (lime_test クラスの phpdoc ドキュメント)
– 新しく採用されたテスティングフレームワークlimeの紹介(symfony で開発日記)
 lime_test クラスメソッドの日本語説明など。
– Chapter 15 – Unit And Fanctional Testing(The Definitive Guide to symfony)
– 15章 単体テストと機能テスト(上のリンクの日本語訳版)

メトリクス計測プラグイン

Eclipse で使えるメトリクス計測ツール(@IT)

メトリクスとは
　ソフトウェアのメトリクスとは、ソフトウェアを計測する方法およびその尺度のことを意味します。今回紹介するメトリクス計測ツールは、ソフトウェアの構成要素であるソースコードを計測し、数値化を行います。メトリクスを計測し、複雑過ぎるロジックや洗練されないパッケージ構成を見直すことで、バグが少なく保守性が高いソースコードを維持できるようになります。

 
この記事で紹介されている、二種類の Eclipse Metrics Plugin が便利そうです。
– Frank Sauer版(Eclipse更新サイト: http://metrics.sourceforge.net/update )
– ダウンロード)

APD の pprofp 引数一覧 (pprofp -h)

APD(Advanced PHP Debugger)、便利ですよね。
 
APD の使い方について書いてあるページは多々あれど、pprofp についてはあまり触れられていなかったので、手前味噌ですが pprofp -h を日本語訳＋捕捉してみました。
 
書式(APD ver. 0.9):

pprofp <オプション> <解析するファイル>

 
並び順を指定するオプション:
  -a クラス、関数名のアルファベット順に表示する
  -l 関数の呼び出し回数順に表示する
  -m 関数呼び出し中のメモリ使用量順に表示する
  -r 関数の実際の処理時間(real time)順に表示する
  -R 関数の実際の処理時間順に表示する(子関数−関数内での関数呼び出し−の処理時間も含む)
  -s 関数のシステムモードでの処理時間(system time)順に表示する
  -S 関数のシステムモードでの処理時間順に表示する(子関数の処理時間も含む)
  -u 関数のユーザモードでの処理時間(user time)順に表示する
  -U 関数のユーザモードでの処理時間順に表示する(子関数の処理時間も含む)
  -v 関数の平均処理時間順に表示する
  -z 関数のユーザモード、システムモードの処理時間の合計順に表示する(省略時のデフォルト)
  
表示形式についてのオプション:
  -c 関数のコールツリーの横に実際の経過時間をつけて表示する(-t または -T とともに指定)
  -i PHP ビルトイン関数を出力に含めない
  -O <数値> 関数のリスト表示で最大何個の関数まで表示するか(デフォルトは 15 個)
  -t 関数のコールツリーを短縮して表示する
  -T 関数のコールツリーを短縮せず表示する
 
– – – –
捕捉:
処理を追う場合はコールツリー(-t あるいは -T)を使うと便利です。
-t と -T の違いは、
-T は

    doSomething
       define
       define
       define
       define
       echo

のように、同じ関数呼び出しが続いた場合もそのまま表示しますが、-t にすると

     doSomething
       define (4x)
       echo

のように、連続する関数呼び出しを一行に縮めて表示することで出力を短縮します。
 
参考:
– PHP用デバッガ

Google Maps API チュートリアル

Google Maps API Tutorial
 
Google Maps を使った様々なサンプルがチュートリアル形式であります。
 
このサイトを見付けるきっかけになったのが GDirections, GTrafficOverlayなんですが
残念ながら日本の地域には対応していませんでした(緯度経度で指定してもだめ)。
特に GDirections (経路取得クラス)については幅広い用途が考えられるので今後対応されることに期待です。
 
参考:
– GDirections – 月と六ペソ
– Google Maps 簡単作成ツール
– Google Maps API Documentation(google.com)

印刷用 PDFドキュメント作成支援サイト

超簡単PDF作成！
 
フォームにタイトル、テキストを入力するとそれを元に簡単にPDF が作れるというもの。
 
テキストファイル、メール、Web 上の記事等を印刷する場合にちょっと便利そうです。
 
参考:
– 超かんたんPDF作成！作りました(zapaブローグ2.0さん)

Amazon の広告用画像をカスタマイズする

– Amazonの画像生成ルール(ええもん屋 ラボ)
http://ecs.amonya.com/ecs40/amazon.html

[基本ルール]
http://images-jp.amazon.com/images/P/[ASINコード].[国コード].[画像の種類].jpg

で、画像の種類にパラメータを与えてやるとぼかしや割引追加、サイズ変更、回転など様々な加工ができるようです。
 
http://images-jp.amazon.com/images/P/4873111811.09._OU02_PIuk-r-ss-new,BottomRight,5,5_.jpg
 
参考:
– Google と Amazon の画像生成する隠れAPI(using API;)

フォルダをカスタマイズする

desktop.ini を編集するとフォルダを装飾することができます。

[.ShellClassInfo]
IconFile=foo.ico ← フォルダ内の foo.ico をフォルダ画像として表示
IconIndex=0 ← IconFile で指定したファイルにアイコンデータが複数ある場合番号で指定
InfoTip=フォルダ情報表示テスト ← フォルダ選択時にステータスバーに表示する文字列(Unicode で指定)

参考:
–Customizing Folders with Desktop.ini(MSDN)

ffmpeg 使い方

ソースのダウンロードは SVN から

 svn checkout svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg

 また、Windows バイナリは携帯電話用の動画をなるべく簡単に作りたかったので作ってみた変換君(3GP Converter)に含まれているものを使うのが簡単な方法です(cores ディレクトリ内)。
Windows用バイナリは「お気に入りの動画を携帯で見よう」からダウンロードできます。
他の入手方法についてはこちらの記事を参照してください。
 

 
– MP3 から PCM 形式オーディオファイル out.wav に変換

ffmpeg -i in.mp3 out.wav

 このように指定した場合、入出力ともに拡張子から自動判別します。
 (指定できる拡張子は後述の「対応フォーマット/コーデック一覧」を参照してください)
 ただしデフォルトのままだとビットレートやサンプリングレート等が変わって劣化やサイズ肥大してしまうことがあります。この場合、次のように明示することで任意の画質、音質で出力することが可能です。
 
– Windows Media Audio 形式(WMA)から MP3 形式にビットレート(128kb/s)、サンプリングレート(44100Hz)指定で変換

ffmpeg -i in2.wma -ab 128 -ar 44100 out2.mp3

 
– Flash 動画ファイル(flv)から、音声を抽出してモノラルで MP3 で保存する
( -vn オプションによるビデオ消去, -ac 1 でチャンネル数を1 = モノラルに)

ffmpeg -i in3.flv -vn -ac 1 out3.mp3

  
 
参考:
– FFmpeg
 公式.
– http://www.xucker.jpn.org/keyword/ffmpeg.html
 aki さんのサイト。日本語でのFFmpeg の情報が豊富です。
 
ffmpeg 対応フォーマット(-f)/コーデック(-acodec, -vcodec)一覧:

(ffmpeg -formats で得られる表示)
それぞれ先頭に D がついているものは入力として指定可能(Decordable),
E がついてるものは出力として指定可能(Encordable)です。
また、Codecs: については、先頭に A がついているものは音声コーデック(Audio Codecs),
V がついているものは動画コーデック(Video Codecs)を指します。

ffmpeg version CVS, build 4759, Copyright (c) 2000-2004 Fabrice Bellard
  configuration: –enable-mp3lame –enable-faac –enable-faad –enable-amr_nb –enable-amr_wb –disable-ffplay –enable-small –enable-memalign-hack –enable-gpl –enable-xvid –enable-dts –enable-a52 –disable-vhook –enable-pthread –enable-x264
File formats:
  E 3g2 3gp2 format
  E 3gp 3gp format
 D 4xm 4X Technologies format
 D RoQ Id RoQ format
 DE ac3 raw ac3
 DE alaw pcm A law format
 DE amr 3gpp amr file format
 DE asf asf format
  E asf_stream asf format
 DE au SUN AU Format
 DE audio_device audio grab and output
 DE avi avi format
 D avs Avisynth script
  E crc crc testing format
 D dts raw dts
 DE dv DV video format
  E dvd MPEG2 PS format (DVD VOB)
 D ea Electronic Arts Multimedia Format
 DE ffm ffm format
 D film_cpk Sega FILM/CPK format
 D flic FLI/FLC animation format
 DE flv flv format
 DE gif GIF Animation
 DE h261 raw h261
 DE h263 raw h263
 DE h264 raw H264 video format
 D idcin Id CIN format
 DE image image sequence
 DE image2 image2 sequence
 DE image2pipe piped image2 sequence
 DE imagepipe piped image sequence
 D ipmovie Interplay MVE format
  E ipod iPod MP4 format
 DE m4v raw MPEG4 video format
 D matroska Matroska file format
 DE mjpeg MJPEG video
 DE mmf mmf format // SMAF 形式オーディオ
  E mov mov format
 D mov,mp4,m4a,3gp,3g2 QuickTime/MPEG4 format
  E mp2 MPEG audio layer 2
 DE mp3 MPEG audio layer 3
  E mp4 mp4 format
 DE mpeg MPEG1 System format
  E mpeg1video MPEG video
  E mpeg2video MPEG2 video
 DE mpegts MPEG2 transport stream format
 D mpegvideo MPEG video
  E mpjpeg Mime multipart JPEG format
 DE mulaw pcm mu law format
 D nsv NullSoft Video format
  E null null video format
 DE nut nut format
 D ogg Ogg
  E psp psp mp4 format
 D psxstr Sony Playstation STR format
 DE rawvideo raw video format
 D redir Redirector format
 DE rm rm format
  E rtp RTP output format
 D rtsp RTSP input format
 DE s16be pcm signed 16 bit big endian format
 DE s16le pcm signed 16 bit little endian format
 DE s8 pcm signed 8 bit format
 D sdp SDP
 D shn raw shn
 D sol Sierra SOL Format
  E svcd MPEG2 PS format (VOB)
 DE swf Flash format
 DE u16be pcm unsigned 16 bit big endian format
 DE u16le pcm unsigned 16 bit little endian format
 DE u8 pcm unsigned 8 bit format
  E vcd MPEG1 System format (VCD)
 D vmd Sierra VMD format
  E vob MPEG2 PS format (VOB)
 DE wav wav format
 D wc3movie Wing Commander III movie format
 D wsaud Westwood Studios audio format
 D wsvqa Westwood Studios VQA format
 DE yuv4mpegpipe YUV4MPEG pipe format
  
Image formats (filename extensions, if any, follow):
 DE gif gif
  
Codecs:
 D V 4xm
 D V D 8bps
 DEA aac
 D V D aasc
 DEA ac3
 DEA adpcm_4xm
 DEA adpcm_adx
 DEA adpcm_ct
 DEA adpcm_ea
 DEA adpcm_ima_dk3
 DEA adpcm_ima_dk4
 DEA adpcm_ima_qt
 DEA adpcm_ima_smjpeg
 DEA adpcm_ima_wav
 DEA adpcm_ima_ws
 DEA adpcm_ms
 DEA adpcm_swf
 DEA adpcm_xa
 DEA adpcm_yamaha
 D A alac
 DEA amr_nb
 DEA amr_wb
 DEV D asv1
 DEV D asv2
 D V D camtasia
 D V D cinepak
 D V D cljr
 D V D cyuv
 D A dts
 DES dvbsub
 D S dvdsub
 DEV D dvvideo
 DEV D ffv1
 DEVSD ffvhuff
 D A flac
 D V D flic
 DEVSD flv
 D V D fraps
 DEA g726
 DEV D h261
 DEVSDT h263
 D VSD h263i
  EV h263p
 DEV DT h264
 DEVSD huffyuv
 D V D idcinvideo
 D V D indeo2
 D V indeo3
 D A interplay_dpcm
 D V D interplayvideo
  EV ljpeg
 D V D loco
 D A mace3
 D A mace6
 D V D mdec
 DEV D mjpeg
 D V D mjpegb
 DEA mp2
 DEA mp3
 D A mp3adu
 D A mp3on4
 DEVSDT mpeg1video
 DEVSDT mpeg2video
 DEVSDT mpeg4
 D A mpeg4aac
 D VSDT mpegvideo
 DEVSD msmpeg4
 DEVSD msmpeg4v1
 DEVSD msmpeg4v2
 D V D msrle
 D V D msvideo1
 D V D mszh
 DEV pam
 DEV pbm
 DEA pcm_alaw
 DEA pcm_mulaw
 DEA pcm_s16be
 DEA pcm_s16le // Windows PCM 形式オーディオ(*.wav)
 DEA pcm_s8
 DEA pcm_u16be
 DEA pcm_u16le
 DEA pcm_u8
 DEV pgm
 DEV pgmyuv
 DEV png
 DEV ppm
 D V D qdraw
 D V D qpeg
 D V D qtrle
 DEV rawvideo
 D A real_144
 D A real_288
 D A roq_dpcm
 D V D roqvideo
 D V D rpza
 DEV D rv10
 DEV D rv20
 D A shorten
 D V D smc
 DEV snow
 D A sol_dpcm
 DEA sonic
  EA sonicls
 D V D sp5x
 DEV D svq1
 D VSD svq3
 D V theora
 D V D truemotion1
 D V D ultimotion
 D V vc9
 D V D vcr1
 D A vmdaudio
 D V D vmdvideo
 D A vorbis
 D V vp3
 D V D vqavideo
 D A wmav1
 D A wmav2
 DEVSD wmv1
 DEVSD wmv2
 D V wmv3
 D V D wnv1
 D A ws_snd1
 D A xan_dpcm
 D V D xan_wc3
 D V D xl
  EV xvid
 DEV D zlib