http.download
Downloads an HTTP resource from the specified URL to a file.
http.download(url, file,{ options })
Parameters
url is the URL to be downloaded.
file is the destination file that will be written to.
options is a table of options used for this HTTP request.
Return Values
There are two return values.
result_str, response_code = http.download(url, file,{ options })
result_stris set to "OK" if successful or contains a description of the failure.result_codeis the HTTP result code of the download.
Examples
local result_str, response_code = http.download("http://example.com/file.zip","file.zip")
functionprogress(total, current)
local ratio = current / total;
ratio = math.min(math.max(ratio,0),1);
local percent = math.floor(ratio *100);
print("Download progress (".. percent .."%/100%)")
end
local result_str, response_code = http.download("http://example.com/file.zip","file.zip",{
progress = progress,
headers ={"From: Premake","Referer: Premake"},
userpwd ="username:password"
})
Backward compatible function signature
The previous signature of this function was
http.download(url, file, progress, headers)
and continues to be supported. This is equivalent to
http.download(url, file,{ progress = progress, headers = headers })
Availability
Premake 5.0 or later.