119 lines
3.6 KiB
C++
119 lines
3.6 KiB
C++
//////////////////////////////////////////////////////
|
|
//
|
|
// LuaConsole:
|
|
//
|
|
// Used to parse commands that are being interactively typed
|
|
// in by a user. The common usage pattern is:
|
|
//
|
|
// 1. Print the prompt suggested by 'get_prompt'.
|
|
// 2. Read a line of text from stdin.
|
|
// 3. Add the line to the LuaConsole using 'add'.
|
|
// 4. Get the command word using get_command.
|
|
// 5. If the command is empty, do nothing.
|
|
// 6. If the command is nonempty, get the args and execute it.
|
|
//
|
|
// The LuaConsole expects you to type a lua command, or one
|
|
// of the following slash-commands:
|
|
//
|
|
// /quit - exit the program
|
|
// /view - display the nearby tangibles
|
|
// /menu [tanid] - display the menu for tangible
|
|
// /tick [timevalue] - advance the simulation clock
|
|
// /choose [number] - choose menu item number
|
|
// /1234 - choose menu item 1234
|
|
//
|
|
// If you type anything else, the LuaConsole will generate a
|
|
// syntax error. Note that not all of the commands above are
|
|
// supported in all interpreters.
|
|
//
|
|
// Lua commands can be one of the following:
|
|
//
|
|
// <expression> - invoke "<expression>""
|
|
// = <expression> - invoke "return <expression>"
|
|
// ? <expression> - probe "<expression>"
|
|
// ?= <expression> - probe "return <expression>"
|
|
//
|
|
// Once a command has been typed (or a syntax error has been
|
|
// typed), the LuaConsole will return the command. The command
|
|
// can be fetched using command(), int_arg(), and str_arg()
|
|
//
|
|
//////////////////////////////////////////////////////
|
|
|
|
#ifndef LUACONSOLE_HPP
|
|
#define LUACONSOLE_HPP
|
|
|
|
#include "wrap-string.hpp"
|
|
#include "wrap-vector.hpp"
|
|
|
|
#include "luastack.hpp"
|
|
|
|
class LuaConsole : public eng::nevernew {
|
|
public:
|
|
using StringVec = eng::vector<eng::string>;
|
|
|
|
private:
|
|
lua_State *lua_state_;
|
|
eng::string raw_input_;
|
|
int lines_;
|
|
eng::string prompt_;
|
|
StringVec words_;
|
|
|
|
void clear_raw_input();
|
|
|
|
public:
|
|
LuaConsole();
|
|
~LuaConsole();
|
|
|
|
// Fetch the recommended prompt.
|
|
//
|
|
// You should update the prompt immediately after 'add'.
|
|
//
|
|
const eng::string &get_prompt() { return prompt_; }
|
|
|
|
// Get the command words.
|
|
//
|
|
StringVec get_command();
|
|
|
|
// Add a line of text that was just read from the console.
|
|
//
|
|
void add(eng::string line);
|
|
};
|
|
|
|
//////////////////////////////////////////////////////
|
|
//
|
|
// CommonCommands is parses slash-commands that are understood by
|
|
// lpxclient and lpxserver. That way, these two separate
|
|
// sourcefiles don't have to duplicate the code for parsing.
|
|
//
|
|
// After parsing, this module calls a virtual function
|
|
// to execute the command. lpxserver and lpxclient
|
|
// implement these virtual functions in different ways.
|
|
//
|
|
//////////////////////////////////////////////////////
|
|
|
|
class CommonCommands {
|
|
public:
|
|
using StringVec = eng::vector<eng::string>;
|
|
|
|
protected:
|
|
virtual void do_syntax_error(std::string_view error) = 0;
|
|
virtual void do_unknown_command(std::string_view name) = 0;
|
|
virtual void do_view_command() = 0;
|
|
virtual void do_moveto_command(int x, int y) = 0;
|
|
virtual void do_quit_command() = 0;
|
|
virtual void do_cpl_command() = 0;
|
|
virtual void do_work_command() = 0;
|
|
virtual void do_display_command() = 0;
|
|
virtual void do_aborthttp_command() = 0;
|
|
virtual void do_connect_command(std::string_view hostname) = 0;
|
|
virtual void do_luainvoke_command(std::string_view cmd) = 0;
|
|
virtual void do_luaprobe_command(std::string_view cmd) = 0;
|
|
|
|
public:
|
|
// Parse a command and call one of the virtual command functions above.
|
|
//
|
|
void do_command(const StringVec &command);
|
|
};
|
|
|
|
#endif // LUACONSOLE_HPP
|