https://github.com/moteus/lua-lluv-curl

Make asyncronus requests using libuv and libcurl
https://github.com/moteus/lua-lluv-curl

async curl libcurl libuv lua

Last synced: 3 months ago
JSON representation

Make asyncronus requests using libuv and libcurl

• Host: GitHub
• URL: https://github.com/moteus/lua-lluv-curl
• Owner: moteus
• License: mit
• Created: 2017-02-09T15:23:28.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2019-07-02T07:51:46.000Z (over 5 years ago)
• Last Synced: 2024-10-01T02:41:12.481Z (4 months ago)
• Topics: async, curl, libcurl, libuv, lua
• Language: Lua
• Homepage:
• Size: 27.3 KB
• Stars: 20
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# lua-lluv-curl

Make asyncronus requests using libuv and libcurl

This module provide async version of curl multi class.

Also module implement async request queue class which allows

control number of parallel requests.

### Examples

#### Basic asyncronus request using easy handle

```Lua

local uv   = require "lluv"

local curl = require "lluv.curl"

local easy = curl.easy{

  url = "http://example.com";

  writefunction = io.write;

}

local multi = curl.multi()

multi:add_handle(easy, function(easy, err)

  print("Done:", err or easy:getinfo_response_code())

end)

uv.run()

```

#### Implementation of [uvwget](http://nikhilm.github.io/uvbook/utilities.html#external-i-o-with-polling) example from [An Introduction to libuv](http://nikhilm.github.io/uvbook/index.html) book

```Lua

local curl = require "lluv.curl"

-- Create request queue object

local queue = curl.queue{

  -- Allow up to 10 parallel requests

  concurent = 10;

  -- Default options for easy handles

  defaults = { -- this is valuses used by defualt

    fresh_connect = true;

    forbid_reuse  = true;

  };

}

for i, url in ipairs(arg) do

  local path, file = tostring(i) .. '.download'

  -- this function actually put reques in queue

  -- and returns special `request` object.

  -- Also it is possible pass any `cURL` options.

  queue:perform(url, {followlocation = true}, function(request) request

    -- Here we can configure created request object before it will be used

    -- calls after configuration done but before actually start perform

    :on('start', function(_, _, easy)

      file = assert(io.open(path, 'wb+'))

      easy:setopt_writefunction(file)

    end)

    -- calls in any case when task is finish

    :on('close', function()

      if file then file:close() end

    end)

     -- Some error (e.g. SSL fail or user interupted)

    :on('error', function(_, _, err)

      io.stderr:write(url ..  ' - FAIL: ' .. tostring(err) .. '\n')

    end)

    -- This means that request done without any error

    :on('done', function(_, _, easy)

      local code = easy:getinfo_response_code()

      io.stdout:write(url ..  ' - DONE: ' .. tostring(code) .. '; Path: ' ..path .. '\n')

    end)

  end)

end

```