Lib.rs

Crosstermion 是一个实用程序库，用于统一某些类型的两个库，允许在 Unix 系统上轻松构建使用更精简的 termion 库的应用程序，但在 Windows 系统上则使用 crossterm。

目前提供的功能包括

• 一个 Key 类型和一个 input_stream（异步）来接收按键
• 一个 AltenrativeRawTerminal，它将替代屏幕与原始模式相结合
• 创建一个使用 crossterm 或 termion 后端之一的 tui 或 tui-react 终端的方式。

那么如何处理颜色和样式呢？

• 使用 tui
  • 当使用 tui 时，您将获得对颜色和样式的本地跨后端支持。
• 不使用 tui
  • 使用 color 功能，结合 ansi_term 提供额外的颜色实用程序。
  • 否则，使用 ansi_term、colored 或 termcolor 将按预期工作。

如何在 Windows 上使用 crossterm 和在 Unix 上使用 termion 构建？

似乎没有简单的方法，因为 cargo 总是会构建依赖项，即使它们在您的平台上不应该被使用。这导致 termion 和 crossterm 都被构建，这在 Windows 上是致命的。因此，在创建发布构建时必须手动选择功能切换，即必须排除所有默认需要 TUI 的功能，并让用户启用他们需要的功能。

宏 compile_error!(…) 可以用来通知用户是否需要选择功能。或者，确保即使在没有任何选定的后端的情况下也能成功编译。

最后，可以始终选择编译针对 crossterm。

功能

所有功能都可以累加使用，但如果它们是互斥的，例如在 tui-react 和 tui，或者 crossterm 和 termion 的情况下，将选择更通用的一个。

• 互斥
  • crossterm
    • 提供从 crossbeam::event::KeyEvent 到 Key 的转换支持以及一个 AlternativeRawTerminal
    • 提供线程化的键盘输入通道
    • 累加
      • input-async-crossterm
        • 通过 mio 无需启动额外线程即可将原生异步能力添加到 crossterm。
        • 请注意，线程化键盘输入始终受支持。
  • termion
    • 提供从 termion::event::Key 到 Key 的转换支持以及一个 AlternativeRawTerminal
    • 提供线程化的键盘输入通道
    • 累加
      • input-async
        • 启动一个线程，并通过 futures Stream 提供输入事件
        • 请注意，线程化键盘输入始终受支持。
• 互斥
  • _using tui_ （互斥）
    • tui-termion 意味着 termion 功能
      • 结合 tui 和 termion，并提供一个具有 termion 后端的 tui::Terminal
    • tui-crossterm 意味着 crossterm 功能
      • 结合 tui 和 crossterm，并提供一个具有 crossterm 后端的 tui::Terminal
  • using tui-react （互斥）
    • tui-react-termion 意味着 termion 功能
      • 结合 tui-react 和 crossterm，并提供一个具有 crossterm 后端的 tui::Terminal
    • tui-react-crossterm 意味着 crossterm 功能
      • 结合 tui-react 和 crossterm，并提供一个具有 crossterm 后端的 tui::Terminal
• 颜色
  • 添加基于 ansi_term 的条件着色支持。该包体积小，针对性强，支持零拷贝绘制字节和 UTF-8 字符串，同时支持 Windows 10。
• 光标移动
  • 互斥
    • crossterm
      • 使用 crossterm 实现光标移动
    • termion
      • 使用 termion 实现光标移动