HTTPBlocks

Nodes

HTTPblock

The HTTPBlock takes in a digilines message containing a URL and then returns the content of it.

digiline_send("httpblock", "http://example.com/textfile.txt")

will return somthing like this:

<!doctype html>
<html>
<body>
<div>
    <h1>Example Domain</h1>
    <p>This domain is for use in illustrative examples in documents. You may use this
    domain in literature without prior coordination or asking for permission.</p>
    <p><a href="https://www.iana.org/domains/example">More information...</a></p>
</div>
</body>
</html>

This is a script which returns raw HTML and sends it to a processing block:

if event.type ==  "on" or event.type == "program" then
    digiline_send("httpblock", "http://example.com")
end

if event.type == "digiline" and event.channel == "lol" then
    digiline_send("processor", event.msg)
end

Selector

Note This node is not usable; Implementation is mostly done except the actual selecting bit.

The selector takes in HTML and a selector:

digiline_send([[
    <li id='breaking'>Breaking: The server enables the HTTPBlock mod, making the world an IOT device!</li>
    <li>The boring player does yet another thing</li>
    <li id='breaking'>The server goes into recession. Sell your houses before they become worthless!</li>}},
    "#breaking"
)

To those familiar with Jquery, this returns the same text as $("#breaking").html() would.

You will then recieve a table which contains the contents of all HTML elements which match:

{
    "Breaking: The server enables the HTTPBlock mod, making the world an IOT device!",
    "Breaking: The server goes into recession. Sell your houses before they become worthless!"
}

Poster

Send a table containing the URL and data to post:

digiline_send("poster", {
    url = "thing.com",
    data = "stuff"
})

When the post request is done, you will recieve the error code. If it's not 200, something's gone wrong. ContentDB

Installation/Setup/Set Up

Install like any other mod, but ensure you add this mod to trusted mods or Minetest probably won't let you send HTTP requests.

Roadmap

Currently, the mod only contains the httpblock:httpblock. However, there are plans for more complicated blocks now that the Minetest interfacing code is mostly done:

Here are the ones which are 75% the way there but need a little more effort to become stable:

HTML Query block - give it table containing HTML and a query (like #id or .class), and it will return the contents of all elements matching the query. (i am currently working on this as we speak)
HTTP Posters - sends a post request

And here are the hypothetical ones:

JSON converters - turns JSON into a lua table for use later
Image-shower - Takes in images and turns them into a format suitable for use with the digilines screen

There are also plans for a web-based service to allow Minetest to interface with, allowing for admins to have an API to interface with scripts. For example, the server wiki might have a script scraping the first news item and sending it to endpoint 127.0.0.1/news.txt for the mod to send to LCD screens across the server.

In any case, if i don't make these before 2023-10-01, feel free to make them yourself.

Credits

The code and textures are a lightly modified version of the digilines RTC - credit to the devs!

Beurocracy

The license for the code is LGPL and the license for the image is CC0.