Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lunarmodules/expadom
An XML DOM Level 2 Core implementation in Lua, based on the (Lua)Expat parser.
https://github.com/lunarmodules/expadom
dom expat lua luaexpat xml
Last synced: 3 months ago
JSON representation
An XML DOM Level 2 Core implementation in Lua, based on the (Lua)Expat parser.
- Host: GitHub
- URL: https://github.com/lunarmodules/expadom
- Owner: lunarmodules
- License: mit
- Created: 2022-03-14T18:38:04.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-06T14:00:59.000Z (over 2 years ago)
- Last Synced: 2024-06-22T00:53:49.351Z (8 months ago)
- Topics: dom, expat, lua, luaexpat, xml
- Language: Lua
- Homepage: https://lunarmodules.github.io/expadom/topics/01-Introduction.md.html
- Size: 125 KB
- Stars: 2
- Watchers: 5
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# expadom
[](https://github.com/lunarmodules/expadom/actions)
[](https://github.com/lunarmodules/expadom/actions)
[](https://coveralls.io/github/lunarmodules/expadom)
[](#history)
[](https://github.com/Kong/insomnia/blob/master/LICENSE)
An [XML DOM Level 2 Core](https://www.w3.org/TR/DOM-Level-2-Core/) implementation in Lua,
based on the [(Lua)Expat parser](https://github.com/lunarmodules/luaexpat).
## Status
This library is under early development and does not have everything implemented
yet. Scan the code for `"TODO:"` to see what is still to be done.
## Synopsis
```lua
local DOM = require("expadom.DOMImplementation")()
local doc, root = DOM:createDocument(nil, "root")
root:appendChild(doc:createComment("let's create an address list"))
local list = doc:createElement("addresses")
list:setAttribute("country", "Netherlands")
root:appendChild(list)
local addr = doc:createElement("address")
list:appendChild(addr)
addr:appendChild(doc:createTextNode("address goes here"))
local xml_written = table.concat(doc:write())
-- result (formatting added for readability):
--
--
--
--
--
address goes here
--
--
-- now parse the document again:
local xml_parsed = require("expadom").parseDocument(xml_written)
local address = xml_parsed:getElementsByTagName("address")[1]
print(address.childNodes[1].nodeValue) --> "address goes here"
```
## Documentation
[The documentation and reference](https://lunarmodules.github.io/expadom/topics/01-Introduction.md.html) is available in the `/docs` folder, and online.
## Downloads, dependencies, and source code
Source code and downloads are available from the [Github project page](https://github.com/lunarmodules/expadom). Installation is typically easiest using LuaRocks.
### Dependencies
Expadom depends on the following packages:
* [LuaExpat](https://github.com/lunarmodules/luaexpat) for parsing XML. This requires
that [libexpat](https://github.com/libexpat/libexpat) itself is also installed.
* The Lua module [compat53](https://github.com/keplerproject/lua-compat-5.3) is required
for UTF-8 support on Lua versions lacking the `utf8` module (pre Lua 5.3).
When installing through LuaRocks, `libexpat` must be installed manually, the other
dependencies will be dealt with by LuaRocks.
## License & Copyright
The project is licensed under the [MIT License](https://github.com/lunarmodules/expadom/blob/main/LICENSE)
## History
#### unreleased
* Feat: return root element as well when creating a document (DOMimplementation)
[#5](https://github.com/lunarmodules/expadom/pull/5)
#### 22-Apr-2022 0.1.0 Initial release
* Most of the DOM level 2 has been implemented