|
6043
|
1 // urlwrite and urlread, a curl front-end for octave |
|
|
2 /* |
|
|
3 |
|
|
4 Copyright (C) 2006 Alexander Barth |
|
|
5 |
|
|
6 This file is part of Octave. |
|
|
7 |
|
|
8 Octave is free software; you can redistribute it and/or modify it |
|
|
9 under the terms of the GNU General Public License as published by the |
|
|
10 Free Software Foundation; either version 2, or (at your option) any |
|
|
11 later version. |
|
|
12 |
|
|
13 Octave is distributed in the hope that it will be useful, but WITHOUT |
|
|
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
|
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
|
16 for more details. |
|
|
17 |
|
|
18 You should have received a copy of the GNU General Public License |
|
|
19 along with Octave; see the file COPYING. If not, write to the Free |
|
|
20 Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
|
|
21 02110-1301, USA. |
|
|
22 |
|
|
23 */ |
|
|
24 |
|
|
25 // Author: Alexander Barth <abarth@marine.usf.edu> |
|
|
26 // Adapted-By: jwe |
|
|
27 |
|
|
28 #ifdef HAVE_CONFIG_H |
|
|
29 #include <config.h> |
|
|
30 #endif |
|
|
31 |
|
|
32 #include <string> |
|
|
33 #include <fstream> |
|
|
34 #include <iomanip> |
|
|
35 |
|
|
36 #include "oct-env.h" |
|
|
37 |
|
|
38 #include "defun-dld.h" |
|
|
39 #include "error.h" |
|
|
40 #include "oct-obj.h" |
|
|
41 #include "ov-cell.h" |
|
|
42 #include "pager.h" |
|
|
43 |
|
|
44 #if defined (HAVE_CURL) |
|
|
45 |
|
|
46 #include <curl/curl.h> |
|
|
47 #include <curl/types.h> |
|
|
48 #include <curl/easy.h> |
|
|
49 |
|
|
50 // Write callback function for curl. |
|
|
51 |
|
|
52 int |
|
|
53 write_data (void *buffer, size_t size, size_t nmemb, void *streamp) |
|
|
54 { |
|
|
55 // *stream is actually an ostream object. |
|
|
56 std::ostream& stream = *(static_cast<std::ostream*> (streamp)); |
|
|
57 stream.write (static_cast<const char*> (buffer), size*nmemb); |
|
|
58 return (stream.fail () ? 0 : size * nmemb); |
|
|
59 } |
|
|
60 |
|
|
61 // Progress callback function for curl. |
|
|
62 |
|
|
63 int |
|
|
64 progress_func (const char *url, double dltotal, double dlnow, |
|
|
65 double /*ultotal*/, double /*ulnow*/) |
|
|
66 { |
|
|
67 // macro that picks up Ctrl-C signalling |
|
|
68 OCTAVE_QUIT; |
|
|
69 |
|
|
70 #if !defined (URL_QUITE_DOWNLOAD) |
|
|
71 if (dltotal != 0) |
|
|
72 { |
|
|
73 // Is the carriage return character "\r" portable? |
|
|
74 octave_stdout << "\r" << url << ": " |
|
|
75 << std::fixed << std::setw(5) << std::setprecision(1) |
|
|
76 << dlnow*100.0/dltotal << " %"; |
|
|
77 |
|
|
78 octave_stdout.flush (); |
|
|
79 } |
|
|
80 #endif |
|
|
81 |
|
|
82 return 0; |
|
|
83 } |
|
|
84 |
|
|
85 // Form the query string based on param. |
|
|
86 |
|
|
87 std::string |
|
|
88 form_query_string (CURL *curl, const Cell& param) |
|
|
89 { |
|
|
90 std::ostringstream query; |
|
|
91 |
|
|
92 for (int i = 0; i < param.numel (); i += 2) |
|
|
93 { |
|
|
94 std::string name = param(i).string_value (); |
|
|
95 std::string text = param(i+1).string_value (); |
|
|
96 |
|
|
97 // Encode strings. |
|
|
98 char *enc_name = curl_easy_escape (curl, name.c_str (), name.length ()); |
|
|
99 char *enc_text = curl_easy_escape (curl, text.c_str (), text.length ()); |
|
|
100 |
|
|
101 query << enc_name << "=" << enc_text; |
|
|
102 |
|
|
103 curl_free (enc_name); |
|
|
104 curl_free (enc_text); |
|
|
105 |
|
|
106 if (i < param.numel()-1) |
|
|
107 query << "&"; |
|
|
108 } |
|
|
109 |
|
|
110 query.flush (); |
|
|
111 |
|
|
112 return query.str (); |
|
|
113 } |
|
|
114 |
|
|
115 // curl front-end |
|
|
116 |
|
|
117 CURLcode |
|
|
118 urlget (const std::string& url, const std::string& method, |
|
|
119 const Cell& param, std::ostream& stream) |
|
|
120 { |
|
|
121 CURL *curl; |
|
|
122 |
|
|
123 curl_global_init(CURL_GLOBAL_DEFAULT); |
|
|
124 |
|
|
125 curl = curl_easy_init(); |
|
|
126 |
|
|
127 if (! curl) |
|
|
128 return CURLE_FAILED_INIT; |
|
|
129 |
|
|
130 // handle paramters of GET or POST request |
|
|
131 |
|
|
132 std::string query_string = form_query_string (curl,param); |
|
|
133 //octave_stdout << "query_string " << query_string << std::endl; |
|
|
134 |
|
|
135 if (method == "get") |
|
|
136 { |
|
|
137 query_string = url + "?" + query_string; |
|
|
138 curl_easy_setopt (curl, CURLOPT_URL, query_string.c_str ()); |
|
|
139 } |
|
|
140 else if (method == "post") |
|
|
141 { |
|
|
142 curl_easy_setopt (curl, CURLOPT_URL, url.c_str ()); |
|
|
143 curl_easy_setopt (curl, CURLOPT_POSTFIELDS, query_string.c_str ()); |
|
|
144 } |
|
|
145 else |
|
|
146 { |
|
|
147 curl_easy_setopt (curl, CURLOPT_URL,url.c_str()); |
|
|
148 } |
|
|
149 |
|
|
150 // Define our callback to get called when there's data to be written. |
|
|
151 curl_easy_setopt (curl, CURLOPT_WRITEFUNCTION, write_data); |
|
|
152 |
|
|
153 // Set a pointer to our struct to pass to the callback. |
|
|
154 curl_easy_setopt (curl, CURLOPT_WRITEDATA, static_cast<void*> (&stream)); |
|
|
155 |
|
6390
|
156 // Follow redirects. |
|
|
157 curl_easy_setopt (curl, CURLOPT_FOLLOWLOCATION, 1); |
|
|
158 |
|
6043
|
159 curl_easy_setopt (curl, CURLOPT_NOPROGRESS, false); |
|
|
160 curl_easy_setopt (curl, CURLOPT_PROGRESSFUNCTION, progress_func); |
|
|
161 curl_easy_setopt (curl, CURLOPT_PROGRESSDATA, url.c_str ()); |
|
|
162 curl_easy_setopt (curl, CURLOPT_FAILONERROR, true); |
|
|
163 |
|
|
164 // Switch on full protocol/debug output |
|
|
165 // curl_easy_setopt(curl, CURLOPT_VERBOSE, true); |
|
|
166 |
|
|
167 CURLcode res = curl_easy_perform(curl); |
|
|
168 |
|
|
169 #if !defined (URL_QUITE_DOWNLOAD) |
|
|
170 if (res == CURLE_OK) |
|
|
171 { |
|
|
172 // download is complete |
|
|
173 progress_func (url.c_str (), 1, 1, 0, 0); |
|
|
174 // new line after progress_func |
|
|
175 octave_stdout << std::endl; |
|
|
176 } |
|
|
177 #endif |
|
|
178 |
|
|
179 // always cleanup |
|
|
180 curl_easy_cleanup (curl); |
|
|
181 |
|
|
182 curl_global_cleanup (); |
|
|
183 |
|
|
184 return res; |
|
|
185 } |
|
|
186 |
|
|
187 #endif |
|
|
188 |
|
|
189 DEFUN_DLD (urlwrite, args, nargout, |
|
|
190 "-*- texinfo -*-\n\ |
|
|
191 @deftypefn {Loadable Function} {} urlwrite (@var{URL}, @var{localfile})\n\ |
|
|
192 @deftypefnx {Loadable Function} {@var{f} =} urlwrite (@var{url}, @var{localfile})\n\ |
|
|
193 @deftypefnx {Loadable Function} {[@var{f}, @var{success}] =} urlwrite (@var{url}, @var{localfile})\n\ |
|
|
194 @deftypefnx {Loadable Function} {[@var{f}, @var{success}, @var{message}] =} urlwrite (@var{url}, @var{localfile})\n\ |
|
|
195 Download a remote file specified by its @var{URL} and save it as\n\ |
|
|
196 @var{localfile}. For example,\n\ |
|
|
197 \n\ |
|
|
198 @example\n\ |
|
|
199 urlwrite ('ftp://ftp.octave.org/pub/octave/README', 'README.txt');\n\ |
|
|
200 @end example\n\ |
|
|
201 \n\ |
|
|
202 The full path of the downloaded file is returned in @var{f}. The\n\ |
|
|
203 variable @var{success} is 1 if the download was successful,\n\ |
|
|
204 otherwise it is 0 in which case @var{message} contains an error\n\ |
|
|
205 message. If no output argument is specified and if an error occurs,\n\ |
|
|
206 then the error is signaled through octave's error handling mechanism.\n\ |
|
|
207 \n\ |
|
|
208 This function uses libcurl. Curl supports, among others, the HTTP,\n\ |
|
|
209 FTP and FILE protocols. Username and password may be specified in\n\ |
|
|
210 the URL, for example:\n\ |
|
|
211 \n\ |
|
|
212 @example\n\ |
|
|
213 urlwrite ('http://username:password@@example.com/file.txt', 'file.txt');\n\ |
|
|
214 @end example\n\ |
|
|
215 \n\ |
|
|
216 GET and POST requests can be specified by @var{method} and @var{param}.\n\ |
|
|
217 The parameter @var{method} is either 'get' or 'post' and @var{param} is a\n\ |
|
|
218 cell array of parameter and value pairs. For example:\n\ |
|
|
219 \n\ |
|
|
220 @example\n\ |
|
|
221 urlwrite ('http://www.google.com/search', 'search.html', 'get', @{'query', 'octave'@});\n\ |
|
|
222 @end example\n\ |
|
|
223 @seealso{urlread}\n\ |
|
|
224 @end deftypefn") |
|
|
225 { |
|
|
226 octave_value_list retval; |
|
|
227 |
|
|
228 #if defined (HAVE_CURL) |
|
|
229 |
|
|
230 int nargin = args.length (); |
|
|
231 |
|
|
232 // verify arguments |
|
|
233 if (nargin != 2 && nargin != 4) |
|
|
234 { |
|
|
235 print_usage (); |
|
|
236 return retval; |
|
|
237 } |
|
|
238 |
|
|
239 std::string url = args(0).string_value(); |
|
|
240 |
|
|
241 if (error_state) |
|
|
242 { |
|
|
243 error ("urlwrite: url must be a character string"); |
|
|
244 return retval; |
|
|
245 } |
|
|
246 |
|
|
247 // name to store the file if download is succesful |
|
|
248 std::string filename = args(1).string_value(); |
|
|
249 |
|
|
250 if (error_state) |
|
|
251 { |
|
|
252 error ("urlwrite: localfile must be a character string"); |
|
|
253 return retval; |
|
|
254 } |
|
|
255 |
|
|
256 std::string method; |
|
|
257 Cell param; // empty cell array |
|
|
258 |
|
|
259 if (nargin == 4) |
|
|
260 { |
|
|
261 method = args(2).string_value(); |
|
|
262 |
|
|
263 if (error_state) |
|
|
264 { |
|
|
265 error ("urlwrite: method can only be \"get\" or \"post\""); |
|
|
266 return retval; |
|
|
267 } |
|
|
268 |
|
|
269 if (method != "get" && method != "post") |
|
|
270 { |
|
|
271 error ("urlwrite: method can only be \"get\" or \"post\""); |
|
|
272 return retval; |
|
|
273 } |
|
|
274 |
|
|
275 param = args(3).cell_value(); |
|
|
276 |
|
|
277 if (error_state) |
|
|
278 { |
|
|
279 error ("urlwrite: parameters for get and post requests must be given as a cell"); |
|
|
280 return retval; |
|
|
281 } |
|
|
282 |
|
|
283 |
|
|
284 if (param.numel () % 2 == 1 ) |
|
|
285 { |
|
|
286 error ("urlwrite: number of elements in param must be even"); |
|
|
287 return retval; |
|
|
288 } |
|
|
289 } |
|
|
290 |
|
|
291 // create and open file stream |
|
|
292 |
|
|
293 std::ofstream stream (filename.c_str(), std::ios::out | std::ios::binary); |
|
|
294 |
|
|
295 if (! stream.is_open ()) |
|
|
296 { |
|
|
297 error ("urlwrite: unable to open file"); |
|
|
298 return retval; |
|
|
299 } |
|
|
300 |
|
|
301 CURLcode res = urlget (url, method, param, stream); |
|
|
302 |
|
|
303 // close the local file |
|
|
304 stream.close (); |
|
|
305 |
|
|
306 if (nargout > 0) |
|
|
307 { |
|
|
308 // FIXME: urlwrite should return full file path |
|
|
309 retval(0) = octave_env::make_absolute (filename, octave_env::getcwd ()); |
|
|
310 // retval(0) = filename; |
|
|
311 retval(1) = res == CURLE_OK; |
|
|
312 // return empty string if no error occured |
|
|
313 retval(2) = std::string (res == CURLE_OK ? "" : curl_easy_strerror (res)); |
|
|
314 } |
|
|
315 |
|
6484
|
316 if (nargout < 2 && res != CURLE_OK) |
|
6043
|
317 error ("urlwrite: curl: %s", curl_easy_strerror (res)); |
|
|
318 |
|
|
319 #else |
|
6335
|
320 retval(2) = "urlwrite: not available in this version of Octave"; |
|
|
321 retval(1) = 0; |
|
|
322 retval(0) = ""; |
|
6043
|
323 #endif |
|
|
324 |
|
|
325 return retval; |
|
|
326 } |
|
|
327 |
|
|
328 DEFUN_DLD (urlread, args, nargout, |
|
|
329 "-*- texinfo -*-\n\ |
|
|
330 @deftypefn {Loadable Function} {@var{s} =} urlread(@var{url})\n\ |
|
|
331 @deftypefnx {Loadable Function} {[@var{s}, @var{success}] =} urlread (@var{url})\n\ |
|
|
332 @deftypefnx {Loadable Function} {[@var{s}, @var{success}, @var{message}] =} urlread(@var{url})\n\ |
|
|
333 @deftypefnx {Loadable Function} {[...] =} urlread (@var{url}, @var{method}, @var{param})\n\ |
|
|
334 Download a remote file specified by its @var{URL} and return its content\n\ |
|
|
335 in string @var{s}. For example,\n\ |
|
|
336 \n\ |
|
|
337 @example\n\ |
|
|
338 s = urlread ('ftp://ftp.octave.org/pub/octave/README');\n\ |
|
|
339 @end example\n\ |
|
|
340 \n\ |
|
|
341 The variable @var{success} is 1 if the download was successful,\n\ |
|
|
342 otherwise it is 0 in which case @var{message} contains an error\n\ |
|
|
343 message. If no output argument is specified and if an error occurs,\n\ |
|
|
344 then the error is signaled through octave's error handling mechanism.\n\ |
|
|
345 \n\ |
|
|
346 This function uses libcurl. Curl supports, among others, the HTTP,\n\ |
|
|
347 FTP and FILE protocols. Username and password may be specified in the\n\ |
|
|
348 URL. For example,\n\ |
|
|
349 \n\ |
|
|
350 @example\n\ |
|
|
351 s = urlread ('http://username:password@@example.com/file.txt');\n\ |
|
|
352 @end example\n\ |
|
|
353 \n\ |
|
|
354 GET and POST requests can be specified by @var{method} and @var{param}.\n\ |
|
|
355 The parameter @var{method} is either 'get' or 'post' and @var{param} is a\n\ |
|
|
356 cell array of parameter and value pairs. For example,\n\ |
|
|
357 \n\ |
|
|
358 @example\n\ |
|
|
359 s = urlread ('http://www.google.com/search', 'get', @{'query', 'octave'@});\n\ |
|
|
360 @end example\n\ |
|
|
361 @seealso{urlwrite}\n\ |
|
|
362 @end deftypefn") |
|
|
363 { |
|
|
364 // octave's return value |
|
|
365 octave_value_list retval; |
|
|
366 |
|
|
367 #if defined (HAVE_CURL) |
|
|
368 |
|
|
369 int nargin = args.length (); |
|
|
370 |
|
|
371 // verify arguments |
|
|
372 if (nargin != 1 && nargin != 3) |
|
|
373 { |
|
|
374 print_usage (); |
|
|
375 return retval; |
|
|
376 } |
|
|
377 |
|
|
378 std::string url = args(0).string_value(); |
|
|
379 |
|
|
380 if (error_state) |
|
|
381 { |
|
|
382 error ("urlread: url must be a character string"); |
|
|
383 return retval; |
|
|
384 } |
|
|
385 |
|
|
386 std::string method; |
|
|
387 Cell param; // empty cell array |
|
|
388 |
|
|
389 if (nargin == 3) |
|
|
390 { |
|
|
391 method = args(1).string_value(); |
|
|
392 |
|
|
393 if (error_state) |
|
|
394 { |
|
|
395 error ("urlread: method can only be \"get\" or \"post\""); |
|
|
396 return retval; |
|
|
397 } |
|
|
398 |
|
|
399 if (method != "get" && method != "post") |
|
|
400 { |
|
|
401 error ("urlread: method can only be \"get\" or \"post\""); |
|
|
402 return retval; |
|
|
403 } |
|
|
404 |
|
|
405 param = args(2).cell_value(); |
|
|
406 |
|
|
407 if (error_state) |
|
|
408 { |
|
|
409 error ("urlread: parameters for get and post requests must be given as a cell"); |
|
|
410 return retval; |
|
|
411 } |
|
|
412 |
|
|
413 if (param.numel () % 2 == 1 ) |
|
|
414 { |
|
|
415 error ("urlread: number of elements in param must be even"); |
|
|
416 return retval; |
|
|
417 } |
|
|
418 } |
|
|
419 |
|
|
420 // string stream for output |
|
|
421 std::ostringstream stream; |
|
|
422 |
|
|
423 CURLcode res = urlget (url, method, param, stream); |
|
|
424 |
|
|
425 if (nargout > 0) |
|
|
426 { |
|
|
427 retval(0) = stream.str (); |
|
|
428 retval(1) = res == CURLE_OK; |
|
|
429 // return empty string if no error occured |
|
|
430 retval(2) = std::string (res == CURLE_OK ? "" : curl_easy_strerror (res)); |
|
|
431 } |
|
|
432 |
|
6484
|
433 if (nargout < 2 && res != CURLE_OK) |
|
6043
|
434 error ("urlread: curl: %s", curl_easy_strerror (res)); |
|
|
435 |
|
|
436 #else |
|
6335
|
437 retval(2) = "urlread: not available in this version of Octave"; |
|
|
438 retval(1) = 0; |
|
|
439 retval(0) = ""; |
|
6043
|
440 #endif |
|
|
441 |
|
|
442 return retval; |
|
|
443 } |
