bungle / lua-resty-ada

LuaJIT FFI bindings to Ada — WHATWG-compliant and fast URL parser

lua-resty-ada

lua-resty-ada implements a LuaJIT FFI bindings to Ada — WHATWG-compliant and fast URL parser.

Status

This library is considered production ready.

Synopsis

local ada = require("resty.ada")

local url = assert(ada.parse("https://www.7‑Eleven.com:1234/Home/../Privacy/Montréal"))

print(tostring(url))
-- prints: https://www.xn--7eleven-506c.com:1234/Privacy/Montr%C3%A9al

print(tostring(url:clear_port())) -- there are many more methods
-- prints: https://www.xn--7eleven-506c.com/Privacy/Montr%C3%A9al

url:free()
-- explicitly frees the memory without waiting for the garbage collector

-- There is also a static API

print(ada.get_href("https://www.7‑Eleven.com:1234/Home/../Privacy/Montréal"))
-- prints: https://www.xn--7eleven-506c.com:1234/Privacy/Montr%C3%A9al

print(ada.clear_port("https://www.7‑Eleven.com:1234/Home/../Privacy/Montréal"))
-- prints: https://www.xn--7eleven-506c.com/Privacy/Montr%C3%A9al

API

LDoc generated API docs can be viewed at bungle.github.io/lua-resty-ada.

Installation

Using OpenResty Package Manager

❯ opm get bungle/lua-resty-ada

OPM repository for lua-resty-ada is located at opm.openresty.org/package/bungle/lua-resty-ada.

Using LuaRocks

❯ luarocks install lua-resty-ada

LuaRocks repository for lua-resty-ada is located at luarocks.org/modules/bungle/lua-resty-ada.

Building Ada

Please consult Ada on how to build or install the ada library. The Ada library needs to installed in in the system library path or one of the paths in Lua's package.cpath.

This project can also build it by executing (requires cmake):

❯ make build

Or run the test suite with act:

❯ act

License

lua-resty-ada uses two clause BSD license.

Copyright (c) 2024 Aapo Talvensaari, 2024 Guilherme Salazar
All rights reserved.

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this
  list of conditions and the following disclaimer in the documentation and/or
  other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES