| // Copyright 2018 The Fuchsia Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #pragma once |
| |
| #include "garnet/bin/zxdb/console/command.h" |
| #include "garnet/bin/zxdb/console/console_context.h" |
| #include "garnet/bin/zxdb/console/line_input.h" |
| #include "garnet/lib/debug_ipc/helper/fd_watcher.h" |
| #include "garnet/lib/debug_ipc/helper/message_loop.h" |
| #include "garnet/public/lib/fxl/macros.h" |
| |
| namespace zxdb { |
| |
| class OutputBuffer; |
| class Session; |
| |
| // The console has some virtual functions for ease of mocking the interace |
| // for tests. |
| class Console : public debug_ipc::FDWatcher { |
| public: |
| explicit Console(Session* session); |
| virtual ~Console(); |
| |
| static Console* get() { return singleton_; } |
| |
| ConsoleContext& context() { return context_; } |
| |
| // Prints the first prompt to the screen. This only needs to be called once. |
| void Init(); |
| |
| // Prints the buffer/string to the console. |
| void Output(OutputBuffer output); |
| void Output(const std::string& s); |
| void Output(const Err& err); |
| |
| // Clears the contents of the console. |
| void Clear(); |
| |
| // The result of dispatching input is either to keep running or quit the |
| // message loop to exit. |
| enum class Result { kContinue, kQuit }; |
| |
| // DispatchInputLine will generate the result by parsing the command. |
| // Depending on this result, this function could stop the MessageLoop. |
| // We pass the result out for callers to use and react accordingly, which |
| // can indicate whether they want the console to continue processing |
| // commands. |
| virtual Result ProcessInputLine(const std::string& line, |
| CommandCallback callback = nullptr); |
| |
| protected: |
| Result DispatchInputLine(const std::string& line, |
| CommandCallback callback = nullptr); |
| |
| // FDWatcher implementation. |
| void OnFDReadable(int fd) override; |
| |
| static Console* singleton_; |
| |
| ConsoleContext context_; |
| |
| debug_ipc::MessageLoop::WatchHandle stdio_watch_; |
| |
| LineInputStdout line_input_; |
| |
| // Saves the last nonempty input line for re-running when the user just |
| // presses "Enter" with no parameters. This must be re-parsed each time |
| // because the context can be different. |
| std::string previous_line_; |
| |
| FXL_DISALLOW_COPY_AND_ASSIGN(Console); |
| }; |
| |
| } // namespace zxdb |