#typing #tui #historical #results #logging #words #visualized

app thokr

具有可视化结果和历史记录的简洁打字TUI

7个不稳定版本 (3个重大变更)

0.4.1 2022年6月13日
0.4.0 2022年5月30日
0.3.0 2022年5月2日
0.2.0 2022年4月29日
0.0.1 2022年4月25日

#499 in 命令行界面

MIT 许可证

59KB
730

thokr

✨ 具有可视化结果和历史记录的简洁打字TUI

GitHub Build Workflow GitHub Deploy Workflow License Crate Version Github Stars

demo

用法

运行 thokr -h 以获取详细用法。

thokr 0.4.1
sleek typing tui with visualized results and historical logging

USAGE:
    thokr [OPTIONS]

OPTIONS:
    -f, --full-sentences <NUMBER_OF_SENTENCES>
            number of sentences to use in test

    -h, --help
            Print help information

    -l, --supported-language <SUPPORTED_LANGUAGE>
            language to pull words from [default: english] [possible values: english, english1k,
            english10k]

    -p, --prompt <PROMPT>
            custom prompt to use

    -s, --number-of-secs <NUMBER_OF_SECS>
            number of seconds to run test

    -V, --version
            Print version information

    -w, --number-of-words <NUMBER_OF_WORDS>
            number of words to use in test [default: 15]

安装

Cargo

$ cargo install thokr

Docker

$ docker run -it thatvegandev/thokr

Arch Linux

从AUR安装 thokr-git

用法

运行 thokr -h 以获取详细用法。

示例

命令 测试内容
thokr 最常见的200个英文单词中的50个
thokr-w100 最常见的200个英文单词中的100个
thokr-w100 -l english1k 最常见的1000个英文单词中的100个
thokr-w10 -s5 最常见的200个英文单词中的10个(硬停5秒)
thokr-p"$(cat foo.txt)" 具有 cat foo.txt 输出的自定义提示
thokr-f4 4个带句号的语法句子;覆盖单词设置

在测试期间,您可以按 ← 重新开始或按 → 查看新的提示(假设您没有提供自定义提示)

支持的语言

默认支持以下语言

名称 描述
english 最常见的200个英文单词
english1k 最常见的1000个英文单词
english10k 最常见的10000个英文单词

日志记录

测试完成后,您的结果将附加到以下平台特定文件夹中的 log.csv 文件中。这样,您可以轻松地跟踪您随时间的变化。

平台 示例
Linux $XDG_CONFIG_HOME/_project_path 或 $HOME/.config/_project_path /home/colby/.config/thokr
macOS $HOME/Library/Application Support/_project_path /Users/Colby/Library/Application Support/thokr
Windows {FOLDERID_RoamingAppData}_project_path\config C:\Users\Colby\AppData\Roaming\thokr\config

路线图

  • ⚡️ 性能
    • 目前存在一些已知的问题,涉及在每个时间间隔和/或按键时渲染 tui。理想情况下,每次渲染都应该以前一次渲染为基础,仅进行必要的调整(可能使用 StatefulWidget),但我还没有解决这个问题。
  • 🔠 多语言支持
    • 由于我在尝试输入带重音的字符时遇到了一些奇特的渲染问题,所以我决定不将 thokr 以英语以外的语言发布。这就像我无法在 raw 模式中正确输入字符一样。我非常希望能够在发布其他语言之前解决这个问题,因为我觉得体验有点令人不快。我将为此打开一个包含更多详细信息和复制步骤的 bug 报告——非常希望有更多的人关注这个问题!
  • 🧪 测试
    • 到目前为止,我只编写了一小部分测试。我没有坐下来真正思考当输出依赖于用户终端大小、字体大小等时,测试应该是什么样子。如果您对此有任何想法,请创建一个 issue 并开始讨论!

贡献

所有贡献都 非常欢迎

如果您有任何使 thokr 更好的建议,请 fork 仓库并创建一个 pull request。您也可以简单地打开一个 issue 并选择 Feature Request

  1. Fork 仓库
  2. 创建您的功能分支(git checkout -b [your_username]/xyz
  3. 提交您的更改(git commit -m 'add some xyz'
  4. 从 main 分支重新创建(git fetch --all && git rebase origin/main
  5. 将更改推送到您的分支(git push origin [your_username]/xyz
  6. 填写 pull request 模板

查看 open issues 以获取完整的功能(和已知问题)列表。

许可协议

在 MIT 许可协议下分发。有关更多信息,请参阅 LICENSE.md

致谢

查看这些启发 thokr 的出色项目!

关注

github twitter youtube

依赖项

~8–19MB
~283K SLoC