kakoune/src/command_manager.hh

159 lines
4.6 KiB
C++
Raw Normal View History

#ifndef command_manager_hh_INCLUDED
#define command_manager_hh_INCLUDED
#include "coord.hh"
#include "completion.hh"
2015-01-06 14:40:56 +01:00
#include "array_view.hh"
#include "shell_manager.hh"
#include "parameters_parser.hh"
2013-04-09 20:05:40 +02:00
#include "string.hh"
#include "optional.hh"
2013-04-09 20:05:40 +02:00
#include "utils.hh"
#include "hash_map.hh"
2013-04-09 20:05:40 +02:00
#include <functional>
#include <initializer_list>
namespace Kakoune
{
2014-01-27 21:28:38 +01:00
class Context;
using CommandParameters = ConstArrayView<String>;
2017-11-04 09:00:34 +01:00
using CommandFunc = std::function<void (const ParametersParser& parser,
Context& context,
const ShellContext& shell_context)>;
2015-10-22 14:59:23 +02:00
using CommandCompleter = std::function<Completions (const Context& context,
CompletionFlags,
CommandParameters,
size_t, ByteCount)>;
2015-10-22 14:59:23 +02:00
using CommandHelper = std::function<String (const Context& context, CommandParameters)>;
enum class CommandFlags
{
None = 0,
Hidden = 1,
};
constexpr bool with_bit_ops(Meta::Type<CommandFlags>) { return true; }
struct CommandInfo { String name, info; };
struct Token
{
enum class Type
{
Raw,
RawQuoted,
RawEval,
ShellExpand,
RegisterExpand,
OptionExpand,
ValExpand,
ArgExpand,
CommandSeparator
};
2017-09-01 12:09:34 +02:00
Type type;
ByteCount pos;
BufferCoord coord;
2017-09-01 12:09:34 +02:00
String content;
};
struct Reader
{
public:
Reader(StringView s) : str{s}, pos{s.begin()}, line_start{s.begin()}, line{} {}
Codepoint operator*() const;
Codepoint peek_next() const;
Reader& operator++();
explicit operator bool() const { return pos < str.end(); }
StringView substr_from(const char* start) const { return {start, pos}; }
BufferCoord coord() const { return {line, (int)(pos - line_start)}; }
StringView str;
const char* pos;
const char* line_start;
LineCount line;
};
class CommandParser
{
public:
CommandParser(StringView command_line);
Optional<Token> read_token(bool throw_on_unterminated);
const char* pos() const { return m_reader.pos; }
BufferCoord coord() const { return m_reader.coord(); }
bool done() const { return not m_reader; }
private:
Reader m_reader;
};
2011-09-23 16:29:42 +02:00
class CommandManager : public Singleton<CommandManager>
{
public:
2014-04-21 22:49:25 +02:00
void execute(StringView command_line, Context& context,
2015-10-23 10:49:06 +02:00
const ShellContext& shell_context = ShellContext{});
2011-11-26 19:32:57 +01:00
Completions complete(const Context& context, CompletionFlags flags,
2014-04-21 22:49:25 +02:00
StringView command_line, ByteCount cursor_pos);
Completions complete(const Context& context, CompletionFlags flags,
CommandParameters params,
size_t token_to_complete, ByteCount pos_in_token);
Optional<CommandInfo> command_info(const Context& context,
StringView command_line) const;
bool command_defined(StringView command_name) const;
2017-11-04 09:00:34 +01:00
void register_command(String command_name, CommandFunc func,
2014-02-12 10:02:09 +01:00
String docstring,
ParameterDesc param_desc,
CommandFlags flags = CommandFlags::None,
CommandHelper helper = CommandHelper(),
2012-11-22 14:28:14 +01:00
CommandCompleter completer = CommandCompleter());
2017-06-29 08:43:20 +02:00
Completions complete_command_name(const Context& context, StringView query) const;
void clear_last_complete_command() { m_last_complete_command = String{}; }
private:
2013-07-26 01:17:12 +02:00
void execute_single_command(CommandParameters params,
2015-10-22 14:59:23 +02:00
Context& context,
const ShellContext& shell_context,
BufferCoord pos);
2017-11-04 09:00:34 +01:00
struct Command
{
2017-11-04 09:00:34 +01:00
CommandFunc func;
2014-02-12 10:02:09 +01:00
String docstring;
ParameterDesc param_desc;
CommandFlags flags;
CommandHelper helper;
CommandCompleter completer;
};
2017-11-04 09:00:34 +01:00
using CommandMap = HashMap<String, Command, MemoryDomain::Commands>;
CommandMap m_commands;
String m_last_complete_command;
int m_command_depth = 0;
CommandMap::const_iterator find_command(const Context& context,
StringView name) const;
};
String expand(StringView str, const Context& context,
2015-10-23 10:49:06 +02:00
const ShellContext& shell_context = ShellContext{});
String expand(StringView str, const Context& context,
const ShellContext& shell_context,
const std::function<String (String)>& postprocess);
}
#endif // command_manager_hh_INCLUDED