kore/examples/async-curl/README.md

Kore asynchronous libcurl integration example.

This example demonstrates how you can use the asynchronous libcurl
api from Kore to perform HTTP client requests, or FTP requests, or send
emails all in an asynchronous fashion.

Run:
```
	$ kodev run
	$ curl https://127.0.0.1:8888
	$ curl https://127.0.0.1:8888/ftp
```
Add asynchronous libcurl support. This commit adds the CURL=1 build option. When enabled allows you to schedule CURL easy handles onto the Kore event loop. It also adds an easy to use HTTP client API that abstracts away the settings required from libcurl to make HTTP requests. Tied together with HTTP request state machines this means you can write fully asynchronous HTTP client requests in an easy way. Additionally this exposes that API to the Python code as well allowing you do to things like: client = kore.httpclient("https://kore.io") status, body = await client.get() Introduces 2 configuration options: - curl_recv_max Max incoming bytes for a response. - curl_timeout Timeout in seconds before a transfer is cancelled. This API also allows you to take the CURL easy handle and send emails with it, run FTP, etc. All asynchronously. 2019-04-24 00:10:47 +02:00			`Kore asynchronous libcurl integration example.`

			`This example demonstrates how you can use the asynchronous libcurl`
			`api from Kore to perform HTTP client requests, or FTP requests, or send`
			`emails all in an asynchronous fashion.`

			`Run:`
			```
			`$ kodev run`
			`$ curl https://127.0.0.1:8888`
			`$ curl https://127.0.0.1:8888/ftp`
			```