ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent-HTTP/HTTP.pm
(Generate patch)

Comparing AnyEvent-HTTP/HTTP.pm (file contents):
Revision 1.109 by root, Wed Jul 27 16:11:55 2011 UTC vs.
Revision 1.115 by root, Fri Jan 18 22:55:39 2013 UTC

… …
46use AnyEvent::Util (); 46use AnyEvent::Util ();
47use AnyEvent::Handle (); 47use AnyEvent::Handle ();
48 48
49use base Exporter::; 49use base Exporter::;
50 50
51our $VERSION = '2.13'; 51our $VERSION = '2.15';
52 52
53our @EXPORT = qw(http_get http_post http_head http_request); 53our @EXPORT = qw(http_get http_post http_head http_request);
54 54
55our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; 55our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)";
56our $MAX_RECURSE = 10; 56our $MAX_RECURSE = 10;
… …
123C<590>-C<599> and the C<Reason> pseudo-header will contain an error 123C<590>-C<599> and the C<Reason> pseudo-header will contain an error
124message. Currently the following status codes are used: 124message. Currently the following status codes are used:
125 125
126=over 4 126=over 4
127 127
128=item 595 - errors during connection etsbalishment, proxy handshake. 128=item 595 - errors during connection establishment, proxy handshake.
129 129
130=item 596 - errors during TLS negotiation, request sending and header processing. 130=item 596 - errors during TLS negotiation, request sending and header processing.
131 131
132=item 597 - errors during body receiving or processing. 132=item 597 - errors during body receiving or processing.
133 133
… …
154 154
155=over 4 155=over 4
156 156
157=item recurse => $count (default: $MAX_RECURSE) 157=item recurse => $count (default: $MAX_RECURSE)
158 158
159Whether to recurse requests or not, e.g. on redirects, authentication 159Whether to recurse requests or not, e.g. on redirects, authentication and
160retries and so on, and how often to do so. 160other retries and so on, and how often to do so.
161 161
162=item headers => hashref 162=item headers => hashref
163 163
164The request headers to use. Currently, C<http_request> may provide its own 164The request headers to use. Currently, C<http_request> may provide its own
165C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and 165C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and
… …
1050 _destroy_state %state; 1050 _destroy_state %state;
1051 1051
1052 %state = (); 1052 %state = ();
1053 $state{recurse} = 1053 $state{recurse} =
1054 http_request ( 1054 http_request (
1055 $method => $url, 1055 $method => $url,
1056 %arg, 1056 %arg,
1057 recurse => $recurse - 1,
1057 keepalive => 0, 1058 keepalive => 0,
1058 sub { 1059 sub {
1059 %state = (); 1060 %state = ();
1060 &$cb 1061 &$cb
1061 } 1062 }
… …
1193Sets the default proxy server to use. The proxy-url must begin with a 1194Sets the default proxy server to use. The proxy-url must begin with a
1194string of the form C<http://host:port>, croaks otherwise. 1195string of the form C<http://host:port>, croaks otherwise.
1195 1196
1196To clear an already-set proxy, use C<undef>. 1197To clear an already-set proxy, use C<undef>.
1197 1198
1198When AnyEvent::HTTP is laoded for the first time it will query the 1199When AnyEvent::HTTP is loaded for the first time it will query the
1199default proxy from the operating system, currently by looking at 1200default proxy from the operating system, currently by looking at
1200C<$ENV{http_proxy>}. 1201C<$ENV{http_proxy>}.
1201 1202
1202=item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end] 1203=item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end]
1203 1204
… …
1215 1216
1216The key C<version> has to contain C<1>, otherwise the hash gets 1217The key C<version> has to contain C<1>, otherwise the hash gets
1217emptied. All other keys are hostnames or IP addresses pointing to 1218emptied. All other keys are hostnames or IP addresses pointing to
1218hash-references. The key for these inner hash references is the 1219hash-references. The key for these inner hash references is the
1219server path for which this cookie is meant, and the values are again 1220server path for which this cookie is meant, and the values are again
1220hash-references. The keys of those hash-references is the cookie name, and 1221hash-references. Each key of those hash-references is a cookie name, and
1221the value, you guessed it, is another hash-reference, this time with the 1222the value, you guessed it, is another hash-reference, this time with the
1222key-value pairs from the cookie, except for C<expires> and C<max-age>, 1223key-value pairs from the cookie, except for C<expires> and C<max-age>,
1223which have been replaced by a C<_expires> key that contains the cookie 1224which have been replaced by a C<_expires> key that contains the cookie
1224expiry timestamp. 1225expiry timestamp. Session cookies are indicated by not having an
1226C<_expires> key.
1225 1227
1226Here is an example of a cookie jar with a single cookie, so you have a 1228Here is an example of a cookie jar with a single cookie, so you have a
1227chance of understanding the above paragraph: 1229chance of understanding the above paragraph:
1228 1230
1229 { 1231 {
… …
1253 1255
1254The default value for the C<recurse> request parameter (default: C<10>). 1256The default value for the C<recurse> request parameter (default: C<10>).
1255 1257
1256=item $AnyEvent::HTTP::TIMEOUT 1258=item $AnyEvent::HTTP::TIMEOUT
1257 1259
1258The default timeout for conenction operations (default: C<300>). 1260The default timeout for connection operations (default: C<300>).
1259 1261
1260=item $AnyEvent::HTTP::USERAGENT 1262=item $AnyEvent::HTTP::USERAGENT
1261 1263
1262The default value for the C<User-Agent> header (the default is 1264The default value for the C<User-Agent> header (the default is
1263C<Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>). 1265C<Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>).
… …
1328 # other formats fail in the loop below 1330 # other formats fail in the loop below
1329 1331
1330 for (0..11) { 1332 for (0..11) {
1331 if ($m eq $month[$_]) { 1333 if ($m eq $month[$_]) {
1332 require Time::Local; 1334 require Time::Local;
1333 return Time::Local::timegm ($S, $M, $H, $d, $_, $y); 1335 return eval { Time::Local::timegm ($S, $M, $H, $d, $_, $y) };
1334 } 1336 }
1335 } 1337 }
1336 1338
1337 undef 1339 undef
1338} 1340}

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines