Added getURLContent() as a top-level function which handles
binary and text downloads by looking at the Content-Type field
of the header.
getURLContent() also raises errors for requests with a status in the "400"
class (e.g. 404 for Not Found) and the errors have (S3) classes that allow
them to be handled via tryCatch().
Added getBinaryURL() function as a convenience for downloading
binary files. Binary content from POSTing or GETing forms
can be done by mimicing the few curl settings illustrated
in getBinaryURL().
Slightly improved error messages when unnamed options are passed
to curlOptions().
Fixed a bug in reading binary files when enlarging the "raw" buffer.
getForm() and postForm() now issue a warning if a curl option
appears in the parameters for the form.
This can be legitimate if the form happens to use a parameter
with the same name as a curl option (see listCurlOptions())
and the error message can be silenced by explicitly providing
a value for the .opts parameter in the call.
The value can be list() or some actual curl options;
the point is to indicate in the call that you have considered
the parameters and the curl options.
The 'statusMessage' field of the HTTP header now contains
the entire error message rather than the first word.
Thanks to Valerie Obenchain for identifying the problem.
Errors from HTTP requests now have their own class and use the
condition system in R (see tryCatch(), simpleError, etc.).
The names of these error classes come from the HTTP
specification and are gathered programmatically from the
specification document. (See inst/HTTPErrors/).
Unknown/non-matching error status values return a
GenericHTTPError class. The others return a vector of class
names containing a more specific class name (whose name is the
status number) and the more general "HTTPError" class name.
0.9-4
Fix escaping in the split string used in
findHTTPHeaderEncoding which gave rise to warnings about vector
lengths in an if() condition in getEncoding().
0.9-3
Changes to remove some simple compiler warnings.
0.9-2
Fix for base64() computing whether to encode or not incorrectly
due to lazy evaluation.
Now we use the base64 encode and decode routines from the
libcurl distribution with our own names on the routines to avoid synchronization problems.
Fix in chunkToLineReader to report number of "characters" read
and warning emitted in C code if full number of "characters"
not consumed.
0.9-1
Configuration-time check to see if Curl_base64_encode() in
libcurl (unexported) has the new additional parameter and so requires us to use that..
0.9-0
Moved the tests/ directory to inst/examples/.
This has some quite rich/advanced examples that should be
available to people and also take some time to run during R CMD
check.
Allow for an .encoding parameter in getURL()/getURI() for
explicitly specifying the encoding of the response from the HTTP.
A mechanism that reads the HTTP response header and finds the
Content-Type field and attempts to infer the encoding of the response.
Note that this registers a handler routine for processing the
header. This continues to work when an R function is provided as
for the headerfunction option, but will not work correctly
if a routine is provided for the headerfunction option.
Updates to deal with encoding of strings.
The basic text gathering function (used as the argument for
write and the curl option writefunction) returns
nchar(, "bytes") which may be more than the number
of characters in an encoded string.
Replaced internal calls to allocString() with mkCharLenCE() when
available (i.e. R >= 2.8.0), or explicitly copy the string given
to us from libcurl and create an encoded character string.
0.8-3
Support for CURLOPT_POST and using
application/x-www-form-urlencoded as the Content-Type in
POST'ing a form. This is controlled via the style parameter in postForm.
Construct body of a form-urlencoded POST in R with the relevant escaping.
0.8-1
Added code to support the new hashing of strings in R-devel
(for what will be 2.6.0).
Bug fix which caused segmentation faults when external pointer
objects were used as options for curl.
Allow dynamic symbol lookup in the RCurl DLL/SO to permit the
use of routines such as R_curl_write_binary_data.
0.7-0
Added support for base64 encoding and decoding using the code from libcurl
(copyright
See the file COPYING.
0.7-0
Added mechanism and example for reading binary data from a request.
This is not connected to R's connection mechanism as the API
for that is not public and external extensions (i.e. via
packages) are not feasible. (R's internals are not object
oriented; one must work through the interpreted language even if
working directly in compiled languages.)
This is useful for handling gzip/bzip2 files, images, etc.
To uncompress such in-memory data directly, see the
Rcompression package.
fileUpload() function and mechanism for specifying details
about a file whose contents are to be included in a form
submission via postForm.
0.6-4
Fix the problem identified by Seth Falcon of
releasing/free'ing an R function object in the RCurl memory
management.
Added a type to the RCurlMemory structure so we know when we
should R_Release() an object. Probably will also duplicate
such functions when preserving them.
0.6-3
Introduced mechanism for converting options to target types, including enumerated values.
Works for netrc option and extensible for any of the values.
Added support for specifying an R function or C routine
for the SSL_CTX_FUNCTION option.
Accept a logical value from the R function used for the write
callback. FALSE indicates an error and TRUE means that the
function processed the text successfully.
Fixed bug in memory management and garbage collection of the
curl handles.
0.6-2
Further changes re postForm() with a curl handle provided.
Problem was NULL for httppost setting.
0.6-1
Fixed type in postForm() that caused error when a curl handle
was specified.
Name matching in ... of curlSetOpt() caught the cur which
should have been curl.
Thanks to Jim McDonal for catching this one and using the
curl handle mechanism for repeated calls.
0.6-0
Allow C routines to be passed as values for the CURL options
that can be R functions. Use
getNativeSymbolInfo(routine, package)$address
to identify the routine.
Support for concurrent, asynchronous HTTP requests using the
curl_multi interface.
Fix for R-devel and counting of \0's in strings for the length.
0.5-1
When POSTing a form, only the first string in each element
of the list was written to the body of the form. In other
words, multi-valued elements such as for checkboxes with several
elements selected were mishandled.
0.5-0
Internal correction for passing numbers as options.
Manifested itself with progress function not being called.
0.4-0
Use the return value from a CURLOPT_WRITEFUNCTION
This allows the user to raise an error.
Support the CURLOPT_PROGRESSFUNCTION
CURL_CFLAGS and CURL_LIBS computed in configure so as to handle
no-GNU versions of make.
0.3-0
Ensure that parameters for postForm are a list when passed to
C code.