OSDN -- Open-Source-Software-Entwicklung und Downloads
Übersetzungsstatus von Deutsch translation status for de

[perldocjp-cvs 1085] CVS update: docs/modules/Furl-0.22/lib

Zurück zum Archiv-Index

ktats****@users***** ktats****@users*****
2011年 2月 10日 (木) 11:38:18 JST 

Index: docs/modules/Furl-0.22/lib/Furl.pod
diff -u docs/modules/Furl-0.22/lib/Furl.pod:1.2 docs/modules/Furl-0.22/lib/Furl.pod:removed
--- docs/modules/Furl-0.22/lib/Furl.pod:1.2	Thu Feb 10 05:07:18 2011
+++ docs/modules/Furl-0.22/lib/Furl.pod	Thu Feb 10 11:38:18 2011
@@ -1,518 +0,0 @@
-=encoding utf8
-
-=encoding utf8
-
-=head1 名前
-
-=begin original
-
-Furl - Lightning-fast URL fetcher
-
-=end original
-
-Furl - 軽量で速い URL fecher
-
-=head1 概要
-
-    use Furl;
-
-    my $furl = Furl->new(
-        agent   => 'MyGreatUA/2.0',
-        timeout => 10,
-    );
-
-    my $res = $furl->get('http://example.com/');
-    die $res->status_line unless $res->is_success;
-    print $res->content;
-
-    my $res = $furl->post(
-        'http://example.com/', # URL
-        [...],                 # headers
-        [ foo => 'bar' ],      # form data (HashRef/FileHandle are also okay)
-    );
-
-    # Accept-Encoding is supported but optional
-    $furl = Furl->new(
-        headers => [ 'Accept-Encoding' => 'gzip' ],
-    );
-    my $body = $furl->get('http://example.com/some/compressed');
-
-=head1 説明
-
-=begin original
-
-Furl is yet another HTTP client library. LWP is the de facto standard HTTP
-client for Perl5, but it is too slow for some critical jobs, and too complex
-for weekend hacking. Furl resolves these issues. Enjoy it!
-
-=end original
-
-Furlはもう一つのHTTPクライアントライブラリです。LWPはPerl5のデファクトスタンダードな
-HTTPクライアントですが、クリティカルなジョブでは遅すぎますし、週末のハッキングには
-複雑過ぎます。Furlはこれらの問題を解決します。楽しんで下さい！
-
-=begin original
-
-This library is an B<beta> software. Any API may change without notice.
-
-=end original
-
-このライブラリは B<ベータ>ソフトウェアです。予告なくAPIが変更されるかも知れません。
-
-=head1 インターフェース
-
-=head2 クラスメソッド
-
-=head3 C<< Furl->new(%args | \%args) :Furl >>
-
-=begin original
-
-Creates and returns a new Furl client with I<%args>. Dies on errors.
-
-=end original
-
-I<%args>で新しいFurlクライアントを作ります。エラーがあれば死にます。
-
-=begin original
-
-I<%args> might be:
-
-=end original
-
-I<%args> は:
-
-=over
-
-=item agent :Str = "Furl/$VERSION"
-
-=item timeout :Int = 10
-
-=item max_redirects :Int = 7
-
-=item proxy :Str
-
-=item no_proxy :Str
-
-=item headers :ArrayRef
-
-=back
-
-=head2 インスタンスメソッド
-
-=head3 C<< $furl->request([$request,] %args) :Furl::Response >>
-
-=begin original
-
-Sends an HTTP request to a specified URL and returns a instance of L<Furl::Response>.
-
-=end original
-
-HTTPリクエストを指定のURLに送り、L<Furl::Response>のインスタンスを返します。
-
-=begin original
-
-I<%args> might be:
-
-=end original
-
-$<%args> は:
-
-=over
-
-=item scheme :Str = "http"
-
-=begin original
-
-Protocol scheme. May be C<http> or C<https>.
-
-=end original
-
-プロトコロスキーマ。C<http> か C<https> でしょう。
-
-=item host :Str
-
-=begin original
-
-Server host to connect.
-
-=end original
-
-接続するサーバホスト。
-
-=begin original
-
-You must specify at least C<host> or C<url>.
-
-=end original
-
-C<host> か C<url>のいずれかを指定しなければいけません。
-
-=item port :Int = 80
-
-=begin original
-
-Server port to connect. The default is 80 on C<< scheme => 'http' >>,
-or 443 on C<< scheme => 'https' >>.
-
-=end original
-
-接続するサーバのポート。デフォルトは、C<< schema => 'http' >>なら80で、
-C<< scheme => 'https' >>なら、443です。
-
-=item path_query :Str = "/"
-
-=begin original
-
-Path and query to request.
-
-=end original
-
-リクエストするパスとクエリ。
-
-=item url :Str
-
-=begin original
-
-URL to request.
-
-=end original
-
-リクエストするURL。
-
-=begin original
-
-You can use C<url> instead of C<scheme>, C<host>, C<port> and C<path_query>.
-
-=end original
-
-C<schema>、C<host>、C<port>、C<path_query>を指定する代わりにC<url>を使えます。
-
-=item headers :ArrayRef
-
-=begin original
-
-HTTP request headers. e.g. C<< headers => [ 'Accept-Encoding' => 'gzip' ] >>.
-
-=end original
-
-HTTPリクエストヘッダ。例 C<< headers => [ 'Accept-Encoding' => 'gzip' ] >>.
-
-=item content : Str | ArrayRef[Str] | HashRef[Str] | FileHandle
-
-=begin original
-
-Content to request.
-
-=end original
-
-リクエストする内容。
-
-=back
-
-=begin original
-
-If the number of arguments is an odd number, this method assumes that the
-first argument is an instance of C<HTTP::Request>. Remaining arguments
-can be any of the previously describe values (but currently there's no
-way to really utilize them, so don't use it)
-
-=end original
-
-引数の数が奇数の場合、このメソッドは最初の引数を C<HTTP::Request>のインスタンスと
-想定します。残りの引数は先に説明したいずれの値も取れます(ですが、今の所,
-それらの値は実際には役にたちません。ですので、使わないで下さい)。
-
-    my $req = HTTP::Request->new(...);
-    my $res = $furl->request($req);
-
-=begin original
-
-You can also specify an object other than HTTP::Request, but the object
-must implement the following methods:
-
-=end original
-
-HTTP::Request以外のオブジェクトも指定できますが、指定するオブジェクトは
-以下のメソッドを実装していなくてはいけません。
-
-=over 4
-
-=item uri
-
-=item method
-
-=item content
-
-=item headers
-
-=back
-
-=begin original
-
-These must return the same type of values as their counterparts in
-C<HTTP::Request>.
-
-=end original
-
-C<HTTP::Request>にあるメソッドと同じタイプの値を返さなくては行けません。 
-
-=begin original
-
-You must encode all the queries or this method will die, saying
-C<Wide character in ...>.
-
-=end original
-
-すべてのクエリをエンコードする必要があります。さもなくば、C<Wide character in ...>
-を吐いて死にます。
-
-=head3 C<< $furl->get($url :Str, $headers :ArrayRef[Str] ) >>
-
-=begin original
-
-This is an easy-to-use alias to C<request()>, sending the C<GET> method.
-
-=end original
-
-C<request()>簡単に使うためのエイリアスです。C<GET>メソッドを送ります。
-
-=head3 C<< $furl->head($url :Str, $headers :ArrayRef[Str] ) >>
-
-=begin original
-
-This is an easy-to-use alias to C<request()>, sending the C<HEAD> method.
-
-=end original
-
-C<request()>簡単に使うためのエイリアスです。C<HED>メソッドを送ります。
-
-=head3 C<< $furl->post($url :Str, $headers :ArrayRef[Str], $content :Any) >>
-
-=begin original
-
-This is an easy-to-use alias to C<request()>, sending the C<POST> method.
-
-=end original
-
-C<request()>簡単に使うためのエイリアスです。C<POST>メソッドを送ります。
-
-=head3 C<< $furl->put($url :Str, $headers :ArrayRef[Str], $content :Any) >>
-
-=begin original
-
-This is an easy-to-use alias to C<request()>, sending the C<PUT> method.
-
-=end original
-
-C<request()>簡単に使うためのエイリアスです。C<PUT>メソッドを送ります。
-
-=head3 C<< $furl->delete($url :Str, $headers :ArrayRef[Str] ) >>
-
-=begin original
-
-This is an easy-to-use alias to C<request()>, sending the C<DELETE> method.
-
-=end original
-
-C<request()>簡単に使うためのエイリアスです。C<DELETE>メソッドを送ります。
-
-=head3 C<< $furl->env_proxy() >>
-
-=begin original
-
-Loads proxy settings from C<< $ENV{HTTP_PROXY} >> and C<< $ENV{NO_PROXY} >>.
-
-=end original
-
-C<< $ENV{HTTP_PROXY} >> と C<< $ENV{NO_PROXY} >> からプロキシ設定を読みこみます。
-
-=head1 FAQ
-
-=over 4
-
-=item FurlはXSモジュールに依存しますか？
-
-=begin original
-
-=item Does Furl depends on XS modules?
-
-=end original
-
-=begin original
-
-No. Although some optional features require XS modules, basic features are
-available without XS modules.
-
-=end original
-
-いいえ、いくつかのオプショナルな機能はXSモジュールを必要としますが、
-基本的な機能はXSモジュールなしに使えます。
-
-=begin original
-
-Note that Furl requires HTTP::Parser::XS, which seems an XS module
-but includes a pure Perl backend, HTTP::Parser::XS::PP.
-
-=end original
-
-FurlはHTTP::Parser::XSを必要とします。これはXSモジュールのようですが、
-pure PerlのバックエンドであるHTTP::Parser::XS::PPを含んでいます。
-
-=begin original
-
-=item I need more speed.
-
-=end original
-
-=item もっとスピードが必要です。
-
-=begin original
-
-See L<Furl::HTTP>, which provides the low level interface of L<Furl>.
-It is faster than C<Furl.pm> since L<Furl::HTTP> does not create response objects.
-
-=end original
-
-L<Furl::HTTP> を見てください。L<Furl>の低レベルのインターフェースを提供しています。
-L<Furl::HTTP>はレスポンスオブジェクトを作らないのでC<Furl.pm>より速いです。
-
-=begin original
-
-=item How do you use cookie_jar?
-
-=end original
-
-=item cookie_jar を使うには?
-
-=begin original
-
-Furl does not directly support the cookie_jar option available in LWP. You can use L<HTTP::Cookies>, L<HTTP::Request>, L<HTTP::Response> like following.
-
-=end original
-
-Furl はLWPで使えるcookie_jarオプションを直接にはサポートしません。 L<HTTP::Cookies>、 L<HTTP::Request>、 L<HTTP::Response>を使って
-以下のようにできます。
-
-
-    my $f = Furl->new();
-    my $cookies = HTTP::Cookies->new();
-    my $req = HTTP::Request->new(...);
-    $cookies->add_cookie_header($req);
-    my $res = H$f->request_with_http_request($req)->as_http_response;
-    $res->request($req);
-    $cookies->extract_cookies($res);
-    # and use $res.
-
-=begin original
-
-=item How do you limit the response content length?
-
-=end original
-
-=item コンテントレングスをどのように制限できますか?
-
-=begin original
-
-You can limit the content length by callback function.
-
-=end original
-
-コールバック関数を使ってコンテントレングスを制限できます。
-
-    my $f = Furl->new();
-    my $content = '';
-    my $limit = 1_000_000;
-    my %special_headers = ('content-length' => undef);
-    my $res = $f->request(
-        method          => 'GET',
-        url             => $url,
-        special_headers => \%special_headers,
-        write_code      => sub {
-            my ( $status, $msg, $headers, $buf ) = @_;
-            if (($special_headers{'content-length'}||0) > $limit || length($content) > $limit) {
-                die "over limit: $limit";
-            }
-            $content .= $buf;
-        }
-    );
-
-=begin original
-
-=item How do you display the progress bar?
-
-=end original
-
-プログレスバーを表示できますか?
-
-    my $bar = Term::ProgressBar->new({count => 1024, ETA => 'linear'});
-    $bar->minor(0);
-    $bar->max_update_rate(1);
-
-    my $f = Furl->new();
-    my $content = '';
-    my %special_headers = ('content-length' => undef);;
-    my $did_set_target = 0;
-    my $received_size = 0;
-    my $next_update  = 0;
-    $f->request(
-        method          => 'GET',
-        url             => $url,
-        special_headers => \%special_headers,
-        write_code      => sub {
-            my ( $status, $msg, $headers, $buf ) = @_;
-            unless ($did_set_target) {
-                if ( my $cl = $special_headers{'content-length'} ) {
-                    $bar->target($cl);
-                    $did_set_target++;
-                }
-                else {
-                    $bar->target( $received_size + 2 * length($buf) );
-                }
-            }
-            $received_size += length($buf);
-            $content .= $buf;
-            $next_update = $bar->update($received_size)
-            if $received_size >= $next_update;
-        }
-    );
-
-=back
-
-=head1 著者
-
-Tokuhiro Matsuno E<lt>tokuhirom AAJKLFJEF GMAIL COME<gt>
-
-Fuji, Goro (gfx)
-
-=head1 謝辞
-
-Kazuho Oku
-
-mala
-
-mattn
-
-lestrrat
-
-walf443
-
-lestrrat
-
-=head1 参照
-
-L<LWP>
-
-L<Furl::HTTP>
-
-L<Furl::Response>
-
-=head1 ライセンス
-
-Copyright (C) Tokuhiro Matsuno.
-
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
-
-
-=cut
-


perldocjp-cvs メーリングリストの案内
Zurück zum Archiv-Index