diff options
Diffstat (limited to 'research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL')
| -rw-r--r-- | research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/LICENSE.md | 23 | ||||
| -rw-r--r-- | research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/README.md | 72 |
2 files changed, 95 insertions, 0 deletions
diff --git a/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/LICENSE.md b/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/LICENSE.md new file mode 100644 index 0000000..b6f1d7e --- /dev/null +++ b/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/LICENSE.md @@ -0,0 +1,23 @@ +LibCURL.jl is licensed under the MIT "Expat" License: + +> Copyright (c) 2013: JuliaWeb contributors +> +> Permission is hereby granted, free of charge, to any person obtaining +> a copy of this software and associated documentation files (the +> "Software"), to deal in the Software without restriction, including +> without limitation the rights to use, copy, modify, merge, publish, +> distribute, sublicense, and/or sell copies of the Software, and to +> permit persons to whom the Software is furnished to do so, subject to +> the following conditions: +> +> The above copyright notice and this permission notice shall be +> included in all copies or substantial portions of the Software. +> +> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +> EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +> MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +> NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE +> LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION +> OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +> WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + diff --git a/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/README.md b/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/README.md new file mode 100644 index 0000000..14b256b --- /dev/null +++ b/research/flossing/external/julia-1.6.7/share/julia/stdlib/v1.6/LibCURL/README.md @@ -0,0 +1,72 @@ +LibCURL.jl +========== + +*Julia wrapper for libCURL* + +[](https://travis-ci.com/JuliaWeb/LibCURL.jl) +[](https://ci.appveyor.com/project/shashi/libcurl-jl) +[](http://codecov.io/github/JuliaWeb/LibCURL.jl?branch=master) + +--- +This is a simple Julia wrapper around http://curl.haxx.se/libcurl/ generated using [Clang.jl](https://github.com/ihnorton/Clang.jl). Please see the [libcurl API documentation](https://curl.haxx.se/libcurl/c/) for help on how to use this package. + +### Example (fetch a URL) + +```julia +using LibCURL + +# init a curl handle +curl = curl_easy_init() + +# set the URL and request to follow redirects +curl_easy_setopt(curl, CURLOPT_URL, "http://example.com") +curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1) + + +# setup the callback function to recv data +function curl_write_cb(curlbuf::Ptr{Cvoid}, s::Csize_t, n::Csize_t, p_ctxt::Ptr{Cvoid}) + sz = s * n + data = Array{UInt8}(undef, sz) + + ccall(:memcpy, Ptr{Cvoid}, (Ptr{Cvoid}, Ptr{Cvoid}, UInt64), data, curlbuf, sz) + println("recd: ", String(data)) + + sz::Csize_t +end + +c_curl_write_cb = @cfunction(curl_write_cb, Csize_t, (Ptr{Cvoid}, Csize_t, Csize_t, Ptr{Cvoid})) +curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, c_curl_write_cb) + + +# execute the query +res = curl_easy_perform(curl) +println("curl url exec response : ", res) + +# retrieve HTTP code +http_code = Array{Clong}(undef, 1) +curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, http_code) +println("httpcode : ", http_code) + +# release handle +curl_easy_cleanup(curl) + +``` + +### Binaries + +This package uses the [LibCURL_jll](https://github.com/JuliaBinaryWrappers/libCURL_jll.jl) binary package to install compiled libCURL binaries on all supported platforms. The following products are defined in the jll + +* `libcurl`: A `LibraryProduct` referencing the shared library +* `curl`: An `ExecutableProduct` referencing the binary + +This package also uses the [MozillaCACerts_jll](https://github.com/JuliaBinaryWrappers/MozillaCACerts_jll.jl) package to supply the Mozilla CA root certificate bundle. Note that the `cacert` symbol is re-exported from this package for ease of use. + +* `cacert`: A `FileProduct` referencing the Mozilla CA certificate bundle + +### SSL certificates + +Making SSL/TLS connections usually needs access to a CA certificate to validate peers. The Mozilla CA bundle can be used via this package. To use this certificate bundle, set the following option: + +```julia +curl_easy_setopt(curl, CURLOPT_CAINFO, LibCURL.cacert) +``` |