… | |
… | |
46 | use AnyEvent::Util (); |
46 | use AnyEvent::Util (); |
47 | use AnyEvent::Handle (); |
47 | use AnyEvent::Handle (); |
48 | |
48 | |
49 | use base Exporter::; |
49 | use base Exporter::; |
50 | |
50 | |
51 | our $VERSION = '2.13'; |
51 | our $VERSION = '2.15'; |
52 | |
52 | |
53 | our @EXPORT = qw(http_get http_post http_head http_request); |
53 | our @EXPORT = qw(http_get http_post http_head http_request); |
54 | |
54 | |
55 | our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; |
55 | our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; |
56 | our $MAX_RECURSE = 10; |
56 | our $MAX_RECURSE = 10; |
… | |
… | |
123 | C<590>-C<599> and the C<Reason> pseudo-header will contain an error |
123 | C<590>-C<599> and the C<Reason> pseudo-header will contain an error |
124 | message. Currently the following status codes are used: |
124 | message. 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 | |
159 | Whether to recurse requests or not, e.g. on redirects, authentication |
159 | Whether to recurse requests or not, e.g. on redirects, authentication and |
160 | retries and so on, and how often to do so. |
160 | other retries and so on, and how often to do so. |
161 | |
161 | |
162 | =item headers => hashref |
162 | =item headers => hashref |
163 | |
163 | |
164 | The request headers to use. Currently, C<http_request> may provide its own |
164 | The request headers to use. Currently, C<http_request> may provide its own |
165 | C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and |
165 | C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and |
… | |
… | |
689 | |
689 | |
690 | $cb->(undef, $hdr); |
690 | $cb->(undef, $hdr); |
691 | () |
691 | () |
692 | } |
692 | } |
693 | |
693 | |
|
|
694 | our %IDEMPOTENT = ( |
|
|
695 | DELETE => 1, |
|
|
696 | GET => 1, |
|
|
697 | HEAD => 1, |
|
|
698 | OPTIONS => 1, |
|
|
699 | PUT => 1, |
|
|
700 | TRACE => 1, |
|
|
701 | |
|
|
702 | ACL => 1, |
|
|
703 | "BASELINE-CONTROL" => 1, |
|
|
704 | BIND => 1, |
|
|
705 | CHECKIN => 1, |
|
|
706 | CHECKOUT => 1, |
|
|
707 | COPY => 1, |
|
|
708 | LABEL => 1, |
|
|
709 | LINK => 1, |
|
|
710 | MERGE => 1, |
|
|
711 | MKACTIVITY => 1, |
|
|
712 | MKCALENDAR => 1, |
|
|
713 | MKCOL => 1, |
|
|
714 | MKREDIRECTREF => 1, |
|
|
715 | MKWORKSPACE => 1, |
|
|
716 | MOVE => 1, |
|
|
717 | ORDERPATCH => 1, |
|
|
718 | PROPFIND => 1, |
|
|
719 | PROPPATCH => 1, |
|
|
720 | REBIND => 1, |
|
|
721 | REPORT => 1, |
|
|
722 | SEARCH => 1, |
|
|
723 | UNBIND => 1, |
|
|
724 | UNCHECKOUT => 1, |
|
|
725 | UNLINK => 1, |
|
|
726 | UNLOCK => 1, |
|
|
727 | UPDATE => 1, |
|
|
728 | UPDATEREDIRECTREF => 1, |
|
|
729 | "VERSION-CONTROL" => 1, |
|
|
730 | ); |
|
|
731 | |
694 | sub http_request($$@) { |
732 | sub http_request($$@) { |
695 | my $cb = pop; |
733 | my $cb = pop; |
696 | my ($method, $url, %arg) = @_; |
734 | my ($method, $url, %arg) = @_; |
697 | |
735 | |
698 | my %hdr; |
736 | my %hdr; |
… | |
… | |
773 | $hdr{"user-agent"} = $USERAGENT unless exists $hdr{"user-agent"}; |
811 | $hdr{"user-agent"} = $USERAGENT unless exists $hdr{"user-agent"}; |
774 | |
812 | |
775 | $hdr{"content-length"} = length $arg{body} |
813 | $hdr{"content-length"} = length $arg{body} |
776 | if length $arg{body} || $method ne "GET"; |
814 | if length $arg{body} || $method ne "GET"; |
777 | |
815 | |
778 | my $idempotent = $method =~ /^(?:GET|HEAD|PUT|DELETE|OPTIONS|TRACE)$/; |
816 | my $idempotent = $IDEMPOTENT{$method}; |
779 | |
817 | |
780 | # default value for keepalive is true iff the request is for an idempotent method |
818 | # default value for keepalive is true iff the request is for an idempotent method |
781 | my $persistent = exists $arg{persistent} ? !!$arg{persistent} : $idempotent; |
819 | my $persistent = exists $arg{persistent} ? !!$arg{persistent} : $idempotent; |
782 | my $keepalive = exists $arg{keepalive} ? !!$arg{keepalive} : !$proxy; |
820 | my $keepalive = exists $arg{keepalive} ? !!$arg{keepalive} : !$proxy; |
783 | my $was_persistent; # true if this is actually a recycled connection |
821 | my $was_persistent; # true if this is actually a recycled connection |
… | |
… | |
1050 | _destroy_state %state; |
1088 | _destroy_state %state; |
1051 | |
1089 | |
1052 | %state = (); |
1090 | %state = (); |
1053 | $state{recurse} = |
1091 | $state{recurse} = |
1054 | http_request ( |
1092 | http_request ( |
1055 | $method => $url, |
1093 | $method => $url, |
1056 | %arg, |
1094 | %arg, |
|
|
1095 | recurse => $recurse - 1, |
1057 | keepalive => 0, |
1096 | keepalive => 0, |
1058 | sub { |
1097 | sub { |
1059 | %state = (); |
1098 | %state = (); |
1060 | &$cb |
1099 | &$cb |
1061 | } |
1100 | } |
… | |
… | |
1193 | Sets the default proxy server to use. The proxy-url must begin with a |
1232 | Sets the default proxy server to use. The proxy-url must begin with a |
1194 | string of the form C<http://host:port>, croaks otherwise. |
1233 | string of the form C<http://host:port>, croaks otherwise. |
1195 | |
1234 | |
1196 | To clear an already-set proxy, use C<undef>. |
1235 | To clear an already-set proxy, use C<undef>. |
1197 | |
1236 | |
1198 | When AnyEvent::HTTP is laoded for the first time it will query the |
1237 | When AnyEvent::HTTP is loaded for the first time it will query the |
1199 | default proxy from the operating system, currently by looking at |
1238 | default proxy from the operating system, currently by looking at |
1200 | C<$ENV{http_proxy>}. |
1239 | C<$ENV{http_proxy>}. |
1201 | |
1240 | |
1202 | =item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end] |
1241 | =item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end] |
1203 | |
1242 | |
… | |
… | |
1215 | |
1254 | |
1216 | The key C<version> has to contain C<1>, otherwise the hash gets |
1255 | The key C<version> has to contain C<1>, otherwise the hash gets |
1217 | emptied. All other keys are hostnames or IP addresses pointing to |
1256 | emptied. All other keys are hostnames or IP addresses pointing to |
1218 | hash-references. The key for these inner hash references is the |
1257 | hash-references. The key for these inner hash references is the |
1219 | server path for which this cookie is meant, and the values are again |
1258 | server path for which this cookie is meant, and the values are again |
1220 | hash-references. The keys of those hash-references is the cookie name, and |
1259 | hash-references. Each key of those hash-references is a cookie name, and |
1221 | the value, you guessed it, is another hash-reference, this time with the |
1260 | the value, you guessed it, is another hash-reference, this time with the |
1222 | key-value pairs from the cookie, except for C<expires> and C<max-age>, |
1261 | key-value pairs from the cookie, except for C<expires> and C<max-age>, |
1223 | which have been replaced by a C<_expires> key that contains the cookie |
1262 | which have been replaced by a C<_expires> key that contains the cookie |
1224 | expiry timestamp. |
1263 | expiry timestamp. Session cookies are indicated by not having an |
|
|
1264 | C<_expires> key. |
1225 | |
1265 | |
1226 | Here is an example of a cookie jar with a single cookie, so you have a |
1266 | Here is an example of a cookie jar with a single cookie, so you have a |
1227 | chance of understanding the above paragraph: |
1267 | chance of understanding the above paragraph: |
1228 | |
1268 | |
1229 | { |
1269 | { |
… | |
… | |
1253 | |
1293 | |
1254 | The default value for the C<recurse> request parameter (default: C<10>). |
1294 | The default value for the C<recurse> request parameter (default: C<10>). |
1255 | |
1295 | |
1256 | =item $AnyEvent::HTTP::TIMEOUT |
1296 | =item $AnyEvent::HTTP::TIMEOUT |
1257 | |
1297 | |
1258 | The default timeout for conenction operations (default: C<300>). |
1298 | The default timeout for connection operations (default: C<300>). |
1259 | |
1299 | |
1260 | =item $AnyEvent::HTTP::USERAGENT |
1300 | =item $AnyEvent::HTTP::USERAGENT |
1261 | |
1301 | |
1262 | The default value for the C<User-Agent> header (the default is |
1302 | The default value for the C<User-Agent> header (the default is |
1263 | C<Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>). |
1303 | C<Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>). |
… | |
… | |
1277 | use 6, and Opera uses 8 because like, they have the fastest browser and |
1317 | use 6, and Opera uses 8 because like, they have the fastest browser and |
1278 | give a shit for everybody else on the planet. |
1318 | give a shit for everybody else on the planet. |
1279 | |
1319 | |
1280 | =item $AnyEvent::HTTP::PERSISTENT_TIMEOUT |
1320 | =item $AnyEvent::HTTP::PERSISTENT_TIMEOUT |
1281 | |
1321 | |
1282 | The time after which idle persistent conenctions get closed by |
1322 | The time after which idle persistent connections get closed by |
1283 | AnyEvent::HTTP (default: C<3>). |
1323 | AnyEvent::HTTP (default: C<3>). |
1284 | |
1324 | |
1285 | =item $AnyEvent::HTTP::ACTIVE |
1325 | =item $AnyEvent::HTTP::ACTIVE |
1286 | |
1326 | |
1287 | The number of active connections. This is not the number of currently |
1327 | The number of active connections. This is not the number of currently |
… | |
… | |
1328 | # other formats fail in the loop below |
1368 | # other formats fail in the loop below |
1329 | |
1369 | |
1330 | for (0..11) { |
1370 | for (0..11) { |
1331 | if ($m eq $month[$_]) { |
1371 | if ($m eq $month[$_]) { |
1332 | require Time::Local; |
1372 | require Time::Local; |
1333 | return Time::Local::timegm ($S, $M, $H, $d, $_, $y); |
1373 | return eval { Time::Local::timegm ($S, $M, $H, $d, $_, $y) }; |
1334 | } |
1374 | } |
1335 | } |
1375 | } |
1336 | |
1376 | |
1337 | undef |
1377 | undef |
1338 | } |
1378 | } |