Test-Base-0.52 > Test::Base::Filter

名前

Test::Base::Filter - Test::Base のデフォルトのフィルタクラス

概要

    package MyTestSuite;
    use Test::Base -Base;

    ... reusable testing code ...

    package MyTestSuite::Filter;
    use Test::Base::Filter -Base;

    sub my_filter1 {
        ...
    }

説明

Filters are the key to writing effective data driven tests with Test::Base. Test::Base::Filter is a class containing a large default set of generic filters. You can easily subclass it to add/override functionality.

フィルタは Test::Base で効果的なデータ駆動テストを記述する 要の要素です. Test::Base::Filter には汎用的なフィルタの 数多くのデフォルトの集合が含まれています. 機能を追加, 上書きするために サブクラス化することも簡単にできます.

フィルタ

This is a list of the default stock filters (in alphabetic order):

デフォルトで入っているフィルタは以下の通りです(アルファベット順):

append

list => list

Append a string to each element of a list.

リストの各要素に文字列を追加します.

    --- numbers lines chomp append=-#\n join
    one
    two
    three

array

list => scalar

Turn a list of values into an anonymous array reference.

値のリストを無名配列のリファレンスに変換します.

base64_decode

scalar => scalar

Decode base64 data. Useful for binary tests.

base64 データをデコードします. バイナリのテストに便利です.

base64_encode

scalar => scalar

Encode base64 data. Useful for binary tests.

データを base64 エンコードします. バイナリのテストに便利です.

chomp

list => list

Remove the final newline from each string value in a list.

リストの各文字列値から最後の改行文字を取り除きます.

chop

list => list

Remove the final char from each string value in a list.

リストの各文字列値から最後の文字を取り除きます.

dumper

scalar => list

Take a data structure (presumably from another filter like eval) and use Data::Dumper to dump it in a canonical fashion.

データ構造(おそらくeval等他のフィルタで生成されたもの)を受け取って Data::Dumper を使って正規形式にダンプします.

escape

scalar => scalar

Unescape all backslash escaped chars.

バックスラッシュエスケープされた全ての文字をアンエスケープします.

eval

scalar => list

Run Perl's eval command against the data and use the returned value as the data.

データに対して Perl の eval コマンドを実行し, その復帰値を データとして利用します.

eval_all

scalar => list

Run Perl's eval command against the data and return a list of 4 values:

データに対して Perl の eval コマンドを実行し, 4つの値から成る リストを返します:

    1) The return value
    2) The error in $@
    3) Captured STDOUT
    4) Captured STDERR
    1) 復帰値
    2) $@ のエラー内容
    3) STDOUT の内容
    4) STDERR の内容

eval_stderr

scalar => scalar

Run Perl's eval command against the data and return the captured STDERR.

データに対して Perl の eval コマンドを実行し, STDERR から 得られた内容を返します.

eval_stdout

scalar => scalar

Run Perl's eval command against the data and return the captured STDOUT.

データに対して Perl の eval コマンドを実行し, STDOUT から 得られた内容を返します.

exec_perl_stdout

list => scalar

Input Perl code is written to a temp file and run. STDOUT is captured and returned.

入力された Perl コードをテンポラリファイルに書き出して実行します. STDOUT を読み込んで返します.

flatten

scalar => list

Takes a hash or array ref and flattens it to a list. =head2 get_url

ハッシュ又は配列のリファレンスを受け取って, 平たくリストにします.

scalar => scalar

The text is chomped and considered to be a url. Then LWP::Simple::get is used to fetch the contents of the url.

テキストは chomp され, url として扱われます. そしてその url の内容を LWP::Simple::get を使って取得します.

hash

list => scalar

Turn a list of key/value pairs into an anonymous hash reference.

キー/値ペアを無名ハッシュのリファレンスに変換します.

head[=number]

list => list

Takes a list and returns a number of the elements from the front of it. The default number is one.

リストを受け取ってその初めの何個かの要素を返します. 省略時は1つです.

join

list => scalar

Join a list of strings into a scalar.

文字列のリストをスカラーに join します.

Join

Join the list of strings inside a list of array refs and return the strings in place of the array refs.

配列のリストの中にある文字列のリストを join して, 配列リファレンスの 代わりに文字列を返します.

lines

scalar => list

Break the data into an anonymous array of lines. Each line (except possibly the last one if the chomp filter came first) will have a newline at the end.

データを行の無名配列に砕きます. 各行は終端に改行文字を持ちます (chomp フィルタが先に適用されていた場合には, 最後の行にはないかもしれません).

norm

scalar => scalar

Normalize the data. Change non-Unix line endings to Unix line endings.

データを正規化(normalize)します. non-Unix 行末を, Unix 行末に変換します.

prepend=string

list => list

Prepend a string onto each of a list of strings.

文字列のリストの各要素に文字列を前置します.

read_file

scalar => scalar

Read the file named by the current content and return the file's content.

現在の内容で与えられる名前のファイルを読み込んで, ファイルの内容を返します.

regexp[=xism]

scalar => scalar

The regexp filter will turn your data section into a regular expression object. You can pass in extra flags after an equals sign.

regexp フィルタはデータセクションを正規表現オブジェクトに 変換します. 等号記号の後でフラグを指定できます.

If the text contains more than one line and no flags are specified, then the 'xism' flags are assumed.

テキストが2行以上あってフラグが指定されなかった時には, 'xism' フラグが適用されます.

reverse

list => list

Reverse the elements of a list.

リストの要素を反転します.

Reverse

list => list

Reverse the list of strings inside a list of array refs.

配列リファレンスのリストの中の文字列のリストを反転します.

slice=x[,y]

list => list

Returns the element number x through element number y of a list.

リストの x 番目から y 番目の要素を返します.

sort

list => list

Sorts the elements of a list in character sort order.

リストの要素を文字列順でソートします.

Sort

list => list

Sort the list of strings inside a list of array refs.

配列リファレンスのリストの中の文字列のリストをソートします.

split[=string|pattern]

scalar => list

Split a string in into a list. Takes a optional string or regexp as a parameter. Defaults to /\s+/. Same as Perl split.

文字列をリストに分割(split)します. 任意で文字列若しくは 正規表現をパラメータとして受け取ります. デフォルトは /\s+/ です. Perl の split と同様です.

Split[=string|pattern]

list => list

Split each of a list of strings and turn them into array refs.

文字列のリストの各要素を split して, 配列のリファレンスにします.

strict

scalar => scalar

Prepend the string:

ブロックのテキストに

    use strict; 
    use warnings;

to the block's text.

を前置します.

tail[=number]

list => list

Return a number of elements from the end of a list. The default number is one.

リストの末尾から指定数の要素を返します. 省略時は1つです.

trim

list => list

Remove extra blank lines from the beginning and end of the data. This allows you to visually separate your test data with blank lines.

データの開始及び終了両側から余計な空行を取り除きます. これを利用することでテストデータに空行を使った視覚的な セパレータを扱うことができます.

unchomp

list => list

Add a newline to each string value in a list.

リストの各文字列値に改行文字を追加します.

write_file[=filename]

scalar => scalar

Write the content of the section to the named file. Return the filename.

セクションの内容を名前付きファイルに書き出します. ファイル名を返します.

yaml

scalar => list

Apply the YAML::Load function to the data block and use the resultant structure. Requires YAML.pm.

データブロックに YAML::Load 関数を適用し, 得られた構造を 利用します. YAML.pm を require します.

著者

Ingy döt Net <ingy@cpan.org>

著作権

Copyright (c) 2006. Ingy döt Net. All rights reserved. Copyright (c) 2005. Brian Ingerson. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

このプログラムはフリーソフトウェアです。あなたは Perl と同じ ライセンスの 元で再配布及び変更を行うことが出来ます.

See http://www.perl.com/perl/misc/Artistic.html

参考 http://www.perl.com/perl/misc/Artistic.html