2. packages-i18n
3. Japanese

This Perl class parses Perl string literals and things that are reasonably like string literals. Its real reason for being is to find interpolated variables for Perl::Critic policies and similar code.

The parse is fairly straightforward, and a little poking around with _eg/pqldump_ should show how it normally goes.

But there is at least one quote-like thing that probably needs some explanation.

この Perl クラスは Perl の文字列リテラルと、文字列リテラルのように記述されているものを処理します。 Perl::Critic ポリシーと同様のコードのための内挿された変数を見つけることが実際の理由です。

解析はかなり単純で、_eg/pqldump_ をちょっといじっただけで、通常はどうなるかわかるはずです。

しかし、少なくとも1つの引用のようなものがあり、おそらく何らかの説明が必要です。

Net::INET6Glue is a collection of modules to make common modules IPv6 ready by hotpatching them.

Unfortunatly the current state of IPv6 support in perl is that no IPv6 support is in the core and that a lot of important modules (like Net::FTP, Net::SMTP, LWP,...) do not support IPv6 even if the modules for IPv6 sockets like Socket6, IO::Socket::IP or IO::Socket::INET6 are available.

This module tries to mitigate this by hotpatching. Currently the following submodules are available:
* Net::INET6Glue::INET_is_INET6

Makes IO::Socket::INET behave like IO::Socket::IP (with fallback to like IO::Socket::INET6), especially make it capable to create IPv6 sockets. This makes LWP, Net::SMTP and others IPv6 capable.
* Net::INET6Glue::FTP

Hotpatches Net::FTP to support EPRT and EPSV commands which are needed to deal with FTP over IPv6. Also loads Net::INET6Glue::INET_is_INET6.

Net::INET6Glue はホットパッチを利用することによって、一般的なモジュールを IPv6 対応にするためのモジュール集です。

不幸にも、現状 Perl における IPv6 のサポートは中枢には取り入れられておらず、 Socket6, IO::Socket::IP, IO::Socket::INET6 など、 IPv6 対応のモジュールが存在しているにも関わらず、主要なモジュールの多く (Net::FTP や Net::SMTP, LWP など) は対応していません。

このモジュールは、ホットパッチの仕組みによってこれを緩和しようとする試みです。現時点では下記のサブモジュールを利用することができます:
* Net::INET6Glue::INET_is_INET6

IO::Socket::INET を IO::Socket::IP のように動作させ (IO::Socket::INET6 等へのフォールバック機能もあります) 、特に IPv6 ソケットへの対応を行なうことができる仕組みです。これにより、 LWP, Net::SMTP などを IPv6 対応にすることができます。
* Net::INET6Glue::FTP

Net::FTP を、 IPv6 に対応するのに必要な EPRT, EPSV コマンドに対応させます。 Net::INET6Glue::INET_is_INET6 モジュールも読みこまれます。

This module provides three utility subroutines that make it easier to develop interactive applications.

The 'ARGV' filehandle, the one that '<>' or an empty 'readline()' uses, has various magic associated with it. It's not actually opened until you try to read from it. Checking '-t ARGV' before you've tried to read from it might give you the wrong answer. Not only that, you might not read from 'ARGV'. If the value in '@ARGV' is the magic filename '-' (a convention to mean the standard filehandle for input or output), 'ARGV' might actually be 'STDIN'. You don't want to think about all of this. This module is discussed in _Perl Best Practices_ on page 218. Also see the 'ARGV' entry in perlvar and the 'readline' entry in perlfunc.
* 'is_interactive()'

This subroutine returns true if '*ARGV' and the currently selected filehandle (usually '*STDOUT') are connected to the terminal. The test is considerably more sophisticated than:

-t *ARGV && -t *STDOUT

as it takes into account the magic behaviour of '*ARGV'.

You can also pass 'is_interactive' a writable filehandle, in which case it requires that filehandle be connected to a terminal (instead of the currently selected). The usual suspect here is '*STDERR':

if ( is_interactive(*STDERR) ) { carp $warning; }
* 'interactive()'

This subroutine returns '*STDOUT' if 'is_interactive' is true. If 'is_interactive()' is false, 'interactive' returns a filehandle that does not print.

This makes it easy to create applications that print out only when the application is interactive:

print {interactive} "Please enter a value: "; my $value = <>;

You can also pass 'interactive' a writable filehandle, in which case it writes to that filehandle if it is connected to a terminal (instead of writing to '*STDOUT'). Once again, the usual suspect is '*STDERR':

print {interactive(*STDERR)} $warning;
* 'busy {...}'

This subroutine takes a block as its single argument and executes that block. Whilst the block is executed, '*ARGV' is temporarily replaced by a closed filehandle. That is, no input from '*ARGV' is possible in a 'busy' block. Furthermore, any attempts to send input into the 'busy' block through '*ARGV' is intercepted and a warning message is printed to '*STDERR'. The 'busy' call returns a filehandle that contains the intercepted input.

A 'busy' block is therefore useful to prevent attempts at input when the program is busy at some non-interactive task.

このモジュールは、対話的なアプリケーションを開発しやすくするための 3 種類のユーティリティサブルーチンを提供しています。

'<>' または空の 'readline()' が使用する 'ARGV' ファイルハンドルには、様々なマジックが関連付けられています。実際には、読み取ろうとするまで開かれません。読み取ろうとする前に '-t ARGV' をチェックすると、間違った答えが返ってくる可能性があります。それだけでなく、'ARGV' から読み取らない可能性もあります。'@ARGV' の値がマジックファイル名 '-' (入力または出力用の標準ファイルハンドルを意味する規約)の場合、'ARGV' は実際には 'STDIN' になる可能性があります。これらをすべて考慮する必要はありません。このモジュールについては、「Perlベスト・プラクティス」218 ページで説明しています。また、perlvarの 'ARGV' エントリおよび perlfunc の 'readline' エントリも参照してください。
* 'is_interactive()'

このサブルーチンは、 '*ARGV' と現在選択されているファイルハンドル (通常は '*STDOUT') が端末に接続されているかどうかを確認し、そうであれば true を返します。このテストは下記の方法よりも洗練された仕組みと考えることができます:

-t *ARGV && -t *STDOUT

また、 '*ARGV' に対する魔法のような処理も含まれています。

このほか、端末に (現在選択されているファイルハンドルではなく) ファイルハンドルを接続する必要がある場合は、 'is_interactive' に書き込み可能なファイルハンドルを指定することもできます。たとえば '*STDERR' などを接続することができます:

if ( is_interactive(*STDERR) ) { carp $warning; }
* 'interactive()'

このサブルーチンは、 'is_interactive' が true であった場合に、 '*STDOUT' を返します。 'is_interactive' が false であった場合は、何も表示しないファイルハンドルを返します。

このサブルーチンは、アプリケーション側で対話処理が必要な場合にのみ出力するような仕組みを作るためのものです:

print {interactive} "Please enter a value: "; my $value = <>;

このほか、端末に ('*STDOUT' ではなく) ファイルハンドルを接続する必要がある場合は、 'interactive' に書き込み可能なファイルハンドルを指定することもできます。たとえば、ここでも '*STDERR' などを接続することができます:

print {interactive(*STDERR)} $warning;
* 'busy {...}'

このサブルーチンはブロックを受け付ける仕組みで、 1 つのパラメータをとってブロックを実行します。ブロックが実行されている間、 '*ARGV' は一時的に、閉じられたファイルハンドルに置き換えられます。言い換えると、 'busy' 内のブロックでは、 '*ARGV' からの入力ができなくなります。これに加えて、 '*ARGV' を介して 'busy' ブロック内に入力を送信するような仕組みも遮られ、 '*STDERR' に警告メッセージが表示されるようになります。 'busy' が終了すると、遮られた入力を含むファイルハンドルを返します。

'busy' ブロックは、何らかの非対話処理を実施する際、プログラム側にデータが入力できないようにするための仕組みです。

Class providing URI query string manipulation

簡単に日時を取り扱うことができURI 問い合わせ文字列を提供するクラス

Before using this module, you should look at the alternatives, some of which are listed in SEE ALSO below.

This module provides a safe mechanism for loading a module at runtime, when you have the name of the module in a variable.

If you've ever had to do this...

eval "require $module";

to get around the bareword caveats on require(), this module is for you. It creates a universal require() class method that will work with every Perl module and its secure. So instead of doing some arcane eval() work, you can do this:

$module->require;

It doesn't save you much typing, but it'll make a lot more sense to someone who's not a ninth level Perl acolyte.

このモジュールを使用する前に、以下の SEE ALSO にリストされている選択肢を確認してください。

このモジュールは、変数内にモジュール名がある場合に、実行時にモジュールをロードするための安全なメカニズムを提供します。

下記のようなコードを見たことがありませんか？

eval "require $module";

これは require() における裸文字の警告に対する回避策ですが、このような問題を解決することができるのがこのモジュールです。このモジュールは汎用的な require() クラスメソッドを作成し、すべての Perl モジュールで利用できる安全な仕組みを提供します。そのため、 eval() のような裏技を使用しなくても、下記のように記述することができるようになります:

$module->require;

これにより入力量を大きく減らすことができるようになります。

Require() modules from a variable [deprecated]

変数からの require() モジュール「非推奨」

Test::Class provides a simple way of creating classes and objects to test your code in an xUnit style.

Built using Test::Builder, it was designed to work with other Test::Builder based modules (Test::More, Test::Differences, Test::Exception, etc.).

_Note:_ This module will make more sense, if you are already familiar with the "standard" mechanisms for testing perl code. Those unfamiliar with Test::Harness, Test::Simple, Test::More and friends should go take a look at them now. Test::Tutorial is a good starting point.

Test::Class は、 xUnit スタイルでのコードテスト用にクラスやオブジェクトを作成するシンプルな方法を提供します。

Test::Builder を利用して構築したことで、 Test::Builder ベースのモジュール (Test::More, Test::Differences, Test::Exception など) とともに動作するように設計されています。

_注意:_ このモジュールは、すでに Perl のコードをテストする "標準的な" 仕組みを知っている方に向けて作られています。 Test::Harness や Test::Simple, Test::More などに詳しくない方は、まず Test::Tutorial をお読みください。

Perl extension for retrieving terminal size (Perl version)

PlRPC サーバに書き込む端末サイズを取得するための Perl 拡張(Perl 版)

*Template::Tiny* is a reimplementation of a subset of the functionality from Template Toolkit in as few lines of code as possible.

It is intended for use in light-usage, low-memory, or low-cpu templating situations, where you may need to upgrade to the full feature set in the future, or if you want the retain the familiarity of TT-style templates.

For the subset of functionality it implements, it has fully-compatible template and stash API. All templates used with *Template::Tiny* should be able to be transparently upgraded to full Template Toolkit.

Unlike Template Toolkit, *Template::Tiny* will process templates without a compile phase (but despite this is still quicker, owing to heavy use of the Perl regular expression engine.

*Template::Tiny* は Template ツールキットの機能の一部を再実装したもので、できる限り少ないコード行数でこれを実現しています。

これはテンプレートの処理にあたって軽量でメモリの使用量も少なく、かつ CPU の消費量も少なくなるように作られています。そのため、将来的に全ての機能が必要となってアップグレードを行なうか、もしくは TT スタイルのテンプレート処理を使い続けるのかを選ぶことができるようになります。

実装は一部分の機能にとどまりますが、 template と stash の API との互換性は完全に確保されています。 *Template::Tiny* で使用される全てのテンプレートは、将来的に完全機能版の Template ツールキットに透過的に移行できるように作られています。

なお、 Template ツールキットとは異なり、 *Template::Tiny* はコンパイルフェーズでのテンプレート処理は行ないません (ただし Perl の正規表現エンジンを使用しているため、それでも高速に動作します) 。

Helper routines for using Sub::Exporter to build methods

メソッドを構築するために Sub::Exporter を利用するためのヘルパールーチン