|
1 | 1 | # Lua binding to [libcurl](http://curl.haxx.se/libcurl) |
2 | | -[](https://travis-ci.org/Lua-cURL/lua-lcurl) |
3 | | -[](https://coveralls.io/r/Lua-cURL/lua-lcurl?branch=master) |
| 2 | +[](https://travis-ci.org/Lua-cURL/Lua-cURLv3) |
| 3 | +[](https://coveralls.io/r/Lua-cURL/Lua-cURLv3?branch=master) |
4 | 4 | [](LICENSE) |
5 | 5 |
|
| 6 | +##Status |
| 7 | + |
| 8 | +This module include three layer |
| 9 | + |
| 10 | +1. `lcurl` module provide low level pure C binding to libcurl.<br/> |
| 11 | +Almost ready and needs tests. I have no plans to change this API. |
| 12 | + |
| 13 | +2. `cURL` module provide compatibility for Lua-cURLv2 API.<br/> |
| 14 | +Almost ready and needs tests. |
| 15 | + |
| 16 | +3. `cURL` module provide new high level API.<br/> |
| 17 | +In fact for now it provide `lcurl` API directly and needed to redesign.<br/> |
| 18 | + |
| 19 | + |
6 | 20 | ## Documentation |
7 | | -[API](http://moteus.github.com/lcurl)<br/> |
8 | | -Also library provide `lcurl.cURL` compatibility module for [Lua-cURL](http://lua-curl.github.io/Lua-cURL) binding. |
| 21 | +[lcurl API](http://moteus.github.com/lcurl)<br/> |
| 22 | +[Lua-cURLv2 API](http://lua-curl.github.io/Lua-cURL)<br/> |
| 23 | +Lua-cURLv3 API - TODO |
9 | 24 |
|
10 | | -## Why one more curl binding |
| 25 | +## |
11 | 26 |
|
12 | | -Existing [Lua-cURL](http://lua-curl.github.io/Lua-cURL) binding has several problems: |
| 27 | +Lua-cURLv2 binding has several problems: |
13 | 28 |
|
14 | 29 | * it can not return error codes but just raise Lua errors |
15 | 30 | * it raise Lua error from callback that may result resource leak in libcurl |
16 | 31 | * it does not provide building multipart/formdata explicitly |
17 | 32 | * it has memory leak when send multipart/formdata |
18 | 33 | * it does not save string for curl options that may result crush in libcurl |
19 | 34 | * there no way to get result for operations in multi interface (e.g. if one of easy operation fail you can not get result code/error message) |
20 | | -* you can not use multi interface for upload operation |
| 35 | +* you can not use multi interface for upload operation (?) |
21 | 36 | * you can not use your own callback function to perform operation with multi interface |
22 | 37 | * you can not pass your context to callback functions |
23 | 38 |
|
|
0 commit comments