Add to README

Author: scr-oath

http/README.md

@@ -3,6 +3,7 @@
 ## Functions
 
 - `client()` - returns http client instance for further usage. Avaliable options as table:
+
 ```
 proxy="http(s)://<user>:<password>@host:<port>",
 timeout= 10,
@@ -21,10 +22,13 @@ client_private_key_pem_file = nil,
 # Prefer this over insecure_ssl when possible
 root_cas_pem_file = "",
 ```
+
 - `request(method, url, [data])` - make request userdata.
 
 ## Methods
+
 ### client
+
 - `do_request(request)` - returns result of request. Avaliable data are: 'body', 'headers', 'code'
 
 ## Examples
@@ -38,9 +42,15 @@ local client = http.client()
 -- GET
 local request = http.request("GET", "http://hostname.com")
 local result, err = client:do_request(request)
-if err then error(err) end
-if not(result.code == 200) then error("code") end
-if not(result.body == "xxx.xxx.xxx.xxx") then error("body") end
+if err then
+    error(err)
+end
+if not (result.code == 200) then
+    error("code")
+end
+if not (result.body == "xxx.xxx.xxx.xxx") then
+    error("body")
+end
 
 -- auth basic
 local request = http.request("GET", "http://hostname.com")
@@ -52,18 +62,18 @@ local request = http.request("POST", "http://hostname.com/api.json", "{}")
 request:header_set("Content-Type", "application/json")
 
 -- with proxy
-local client = http.client({proxy="http(s)://login:password@hostname.com"})
+local client = http.client({ proxy = "http(s)://login:password@hostname.com" })
 local request = http.request("POST", "http://hostname.com/api.json", "{}")
 
 -- ignore ssl
-local client = http.client({insecure_ssl=true})
+local client = http.client({ insecure_ssl = true })
 local request = http.request("POST", "http://hostname.com/api.json", "{}")
 
 -- set headers for all request
-local client = http.client({ headers={key="value"} })
+local client = http.client({ headers = { key = "value" } })
 
 -- set basic auth for all request
-local client = http.client({basic_auth_user="admin", basic_auth_password="123456"})
+local client = http.client({ basic_auth_user = "admin", basic_auth_password = "123456" })
 ```
 
 ### Server
@@ -72,40 +82,44 @@ local client = http.client({basic_auth_user="admin", basic_auth_password="123456
 
 ```lua
 local server, err = http.server("127.0.0.1:1113")
-if err then error(err) end
+if err then
+    error(err)
+end
 
 while true do
-  local request, response = server:accept() -- lock and wait request
-
-  -- print request
-  print("host:", request.host)
-  print("method:", request.method)
-  print("referer:", request.referer)
-  print("proto:", request.proto)
-  print("path:", request.path)
-  print("raw_path:", request.raw_path)
-  print("raw_query:", request.raw_query)
-  print("request_uri:", request.request_uri)
-  print("remote_addr:", request.remote_addr)
-  print("user_agent: "..request.user_agent)
-
-  -- get body
-  local body, err = request.body()
-  if err then error(err) end
-  print("body:", body)
-
-  for k, v in pairs(request.headers) do
-    print("header: ", k, v)
-  end
-  for k, v in pairs(request.query) do
-    print("query params: ", k, "=" ,v)
-  end
-  -- write response
-  response:code(200) -- write header
-  response:header("content-type", "application/json")
-  response:write(request.request_uri) -- write data
-  -- response:redirect("http://google.com")
-  response:done() -- end response
+    local request, response = server:accept() -- lock and wait request
+
+    -- print request
+    print("host:", request.host)
+    print("method:", request.method)
+    print("referer:", request.referer)
+    print("proto:", request.proto)
+    print("path:", request.path)
+    print("raw_path:", request.raw_path)
+    print("raw_query:", request.raw_query)
+    print("request_uri:", request.request_uri)
+    print("remote_addr:", request.remote_addr)
+    print("user_agent: " .. request.user_agent)
+
+    -- get body
+    local body, err = request.body()
+    if err then
+        error(err)
+    end
+    print("body:", body)
+
+    for k, v in pairs(request.headers) do
+        print("header: ", k, v)
+    end
+    for k, v in pairs(request.query) do
+        print("query params: ", k, "=", v)
+    end
+    -- write response
+    response:code(200) -- write header
+    response:header("content-type", "application/json")
+    response:write(request.request_uri) -- write data
+    -- response:redirect("http://google.com")
+    response:done() -- end response
 
 end
 ```
@@ -114,7 +128,9 @@ end
 
 ```lua
 local server, err = http.server("127.0.0.1:1113")
-if err then error(err) end
+if err then
+    error(err)
+end
 
 server:do_handle_string([[ -- do_handle_file
 
@@ -132,6 +148,67 @@ response:done()
 ]]
 ```
 
+#### Handle variant (multithreaded as function)
+
+```lua
+local server, err = http.server("127.0.0.1:1113")
+assert(not err, tostring(err))
+
+server:do_handle_function(function(response, request)
+    response:code(200)
+    response:write("OK\n")
+    response:done()
+end)
+```
+
+#### Listen to an open port and get the address (host:port)
+
+```lua
+local server, err = http.server {}
+assert(not err, tostring(err))
+local addr = server:addr()
+```
+
+#### TLS support
+
+```lua
+local server, err = http.server {
+    addr = "127.0.0.1:1113",
+    
+    -- Setting both of these enables TLS
+    server_public_cert_pem_file = "test/data/test.cert.pem",
+    server_private_key_pem_file = "test/data/test.key.pem",
+}
+assert(not err, tostring(err))
+
+server:do_handle_function(function(response, request)
+    response:code(200)
+    response:write("OK\n")
+    response:done()
+end)
+```
+
+#### mTLS support (enforce client certs)
+
+```lua
+local server, err = http.server {
+    addr = "127.0.0.1:1113",
+    client_cas_pem_file = "test/data/test.cert.pem",
+    client_auth = "RequireAndVerifyClientCert", -- See https://pkg.go.dev/crypto/tls@go1.19.2#ClientAuthType
+
+    -- Setting both of these enables TLS
+    server_public_cert_pem_file = "test/data/test.cert.pem",
+    server_private_key_pem_file = "test/data/test.key.pem",
+}
+assert(not err, tostring(err))
+
+server:do_handle_function(function(response, request)
+    response:code(200)
+    response:write("OK\n")
+    response:done()
+end)
+```
+
 #### Serve Static files
 
 ```lua

http/test/test_server.lua

@@ -13,8 +13,8 @@ function Test_do_handle_function(t)
         addr_ch:send(server:addr())
         server:do_handle_function(function(response, request)
             print(string.format("response = %s", response))
-            response:write("OK\n")
             response:code(200)
+            response:write("OK\n")
             response:done()
         end)
     ]]