Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blocknotes/curl-crystal
Crystal C bindings for libcurl
https://github.com/blocknotes/curl-crystal
crystal curl libcurl
Last synced: 2 months ago
JSON representation
Crystal C bindings for libcurl
- Host: GitHub
- URL: https://github.com/blocknotes/curl-crystal
- Owner: blocknotes
- License: mit
- Archived: true
- Created: 2017-01-06T10:12:07.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-04-12T15:57:29.000Z (over 4 years ago)
- Last Synced: 2024-09-26T17:07:45.955Z (3 months ago)
- Topics: crystal, curl, libcurl
- Language: Crystal
- Size: 31.3 KB
- Stars: 14
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-crystal - curl-crystal - Bindings for [libcurl](https://curl.haxx.se/libcurl/) (C bindings)
- awesome-crystal - curl-crystal - Bindings for [libcurl](https://curl.haxx.se/libcurl/) (C bindings)
README
# libcurl for Crystal - PROJECT UNMAINTAINED [](https://travis-ci.org/blocknotes/curl-crystal)
> *This project is not maintained anymore*
>
> *If you like it or continue to use it fork it please.*
* * *
* * *
Crystal C bindings for libcurl, the multiprotocol file transfer library - see [libcurl](https://curl.haxx.se/libcurl/)
## Installation
Add this to your application's `shard.yml`:
```yaml
dependencies:
curl-crystal:
github: blocknotes/curl-crystal
```
## Usage
CURL version:
```ruby
require "curl-crystal"
puts String.new LibCurl.curl_version
```
Fetch an URL an print the content to the STDOUT:
```ruby
require "curl-crystal"
curl = LibCurl.curl_easy_init # init
LibCurl.curl_easy_setopt curl, LibCurl::CURLoption::CURLOPT_URL, "https://www.google.com" # set URL
LibCurl.curl_easy_setopt curl, LibCurl::CURLoption::CURLOPT_FOLLOWLOCATION, 1 # follow redirect
LibCurl.curl_easy_perform curl # run
LibCurl.curl_easy_cleanup curl # deinit
```
Simple POST request:
```ruby
require "curl-crystal"
curl = LibCurl.curl_easy_init # init
LibCurl.curl_easy_setopt curl, LibCurl::CURLoption::CURLOPT_URL, "http://localhost"
LibCurl.curl_easy_setopt curl, LibCurl::CURLoption::CURLOPT_POSTFIELDS, "param1=Just+a+test¶m2=12.345"
LibCurl.curl_easy_perform curl # run
LibCurl.curl_easy_cleanup curl # deinit
```
Invalid URL error:
```ruby
require "curl-crystal"
curl = LibCurl.curl_easy_init
LibCurl.curl_easy_setopt curl, LibCurl::CURLoption::CURLOPT_URL, "https://aaa.bbb.ccc.ddd"
ret = LibCurl.curl_easy_perform curl # CURLE_COULDNT_RESOLVE_HOST
puts ret.to_s + ": " + String.new( LibCurl.curl_easy_strerror( ret ) )
LibCurl.curl_easy_cleanup curl
```
## More examples
- [examples](https://github.com/blocknotes/curl-crystal/tree/master/examples) folder
- libcurl C [examples](https://curl.haxx.se/libcurl/c/example.html)
## Notes
Base on curl version: **7.52.1**
## Contributors
- [Mattia Roccoberton](http://blocknot.es) - creator, maintainer, Crystal fan :)