controller.py

"""
Script for exposing the Bot API via HTTP server.

This script assumes there is a Minetest server running the Bot mod (found at
`bot/`), and we want to allow third-parties to control such bots easily. This
is done by connecting to the server, posing as a player, and proxy-ing messages
received from an HTTP server.

Run "python3 controller.py" to create an HTTP server that answers for
"/<bot name>/<command>" requests, forwarding them to the server through a
in-game character using chat commands.
"""
from client import MinetestClient
from queue import Queue

class MinetestRobotController(MinetestClient):
    """
    Creates a Minetest client specific for controlling bots by sending chat
    commands through a temporary player.
    """
    def __init__(self, host='localhost:30000', user='user', password=''):
        MinetestClient.__init__(self, host, user, password)

        self.answer_buffer = Queue()
        self.on_message = self._distinguish_message

    def command(self, robot, message):
        self.say('bot {} {}'.format(robot, message))
        return self.answer_buffer.get()

    def _distinguish_message(self, message):
        if message.startswith('Server -!- '):
            block_name = message[len('Server -!- '):]
            self.answer_buffer.put(block_name)
        else:
            print(message)

    def disconnect(self):
        MinetestClient.disconnect(self)


if __name__ == '__main__':
    import sys
    import time
    import math

    from flask import Flask
    app = Flask(__name__)

    controller = MinetestRobotController()

    @app.route("/poll")
    @app.route("/reset_all")
    def poll():
        return ""

    @app.route("/<command>/<parameter>/<name>")
    def command_with_param(name, parameter, command):
        return controller.command(name, command + " " + parameter)

    @app.route("/<command>/<name>")
    def command(name, command):
        return controller.command(name, command)

    try:
        app.run(port=50210)
    finally:
        controller.disconnect()