README
1** Net::Curl 0.44 **
2
3STATUS: This package is working and the interface is mostly stable.
4
5** BUILDING **
6- you need libcurl 7.15.5 or newer, try to get one as recent as you can
7 * it is highly suggested to build libcurl with asynchdns (c-ares) support
8 (besides the usual extensions: libz, ssl)
9
10- you should have ExtUtils::PkgConfig installed, it should pick all the
11 libcurl options needed to build this module
12 * if the above isn't working for you, you can edit Makefile.PL,
13 there is a %curl hash on the top of the file, which should be filled
14 with correct value
15
16- have in mind that tests depend on network availability and may not cover
17 all the quirks found in your operating system, some of them even depend on
18 proper timing, so sometimes they could fail without an apparent reason
19 (in case of very slow network connection or very heavily loaded system)
20
21
22
23** WWW::Curl compatibility **
24
25For packages requiring WWW::Curl you can use Net::Curl instead of WWW::Curl
26if you don't want to install WWW::Curl in your system. Can be useful in
27space-constrained systems if you already have something that requires
28Net::Curl anyways.
29
30Set environment variable WWW_COMPAT to "ext" before calling Makefile.PL
31to install WWW/Curl/* wrapper files directly.
32
33By default build system creates Net::Curl::Compat package which can be used
34to enable WWW::Curl compatibility in Net::Cutl, but it must be loaded manually
35before something tries to use WWW::Curl.
36
37
38** WARNING **
39- pushopt() may disappear yet.
40
41
42** TODO **
43
44XS:
45- under coro and threads, when forcibly destroyed, there are some ways to
46 make it leak or double-free memory, must be investigated further.
47
48Easy:
49- test callback arguments just before perform (maybe only for default writers)
50- write more documentation
51- in case of multi interface CLOSESOCKET will be called long after destroying
52 the easy handle, this will be deadly
53
54Form:
55- implement read callback
56- write more documentation
57
58Multi:
59- write more documentation
60
61Share:
62- write more documentation
63
64tests:
65- review and renumerate
66