30 个版本 (6 个稳定版本)

1.2.0 2024年6月13日
1.1.1 2023年5月7日
1.0.2 2023年4月27日
1.0.1 2023年3月26日
0.6.0 2022年11月28日

#22命令行工具

每月 29 次下载

MIT 许可证

110KB
3K SLoC

🦀 wthrr-the-weathercrab

wthrr 生活在您的终端中,她对气象学充满热情。

如果您花时间在 TUI 中,您将有一个了解天气的小伴侣在身边。

内容

如何使用?

只需调用

wthrr

在没有添加地址或选项的情况下,wthrr 使用默认保存的 配置
如果您还没有配置任何默认设置,wthrr 可以尝试搜索附近的气象站,并将搜索到的位置保存为默认值。

始终可以指定地址。 例如,

wthrr melbourne

根据您要查找的地方,可能需要更具体一些。例如,上面的调用将获取澳大利亚的墨尔本。如果您是指美国的墨尔本,请请求 melbourne,florida。如果地址中包含空格,请用连字符或用引号括起来分隔它们(例如,new-york"new york")。

要显式搜索附近的气象站,请调用

wthrr auto

作为最后的例子,我们指示 wthrr 使用华氏度和英里/小时作为单位,并添加一天的逐小时预报

wthrr -u f,mph -f d

在帮助信息中查找进一步的用法参数

> wthrr -h

Usage: wthrr [OPTIONS] [ADDRESS]

Arguments:
  [ADDRESS]
          Address to check the weather

Options:
  -f, --forecast <FORECAST,...>
          [e.g.: -f w,d] [possible values: disable, (w)eek, to(d)ay, (t)omorrow, mo, tu, we, th, fr, sa, su]
  -F, --historical-weather <%Y-%m-%d,...>
          [e.g.: -F 2021-12-31]
  -u, --units <UNIT,...>
          [e.g.: -u f,12h,in] [possible values: (c)elsius, (f)ahrenheit, kmh, mph, (kn)ots, ms, 12h, 24h, %, mm, (in)ch]
  -l, --language <LANGUAGE>
          Output language [e.g.: en_US]
  -s, --save
          Save the supplied values as default
  -r, --reset
          Wipe wthrr's configuration data
  -h, --help
          Print help
  -V, --version
          Print version

展示

首次运行 逐小时预报
周预报 *终端颜色

*渲染和颜色受终端及其主题和字体的影响。
例如,上面的第一个截图显示了在 nvim(toggleterm) 中使用 kitty 作为终端的 wthrr,并使用 Dracula 主题和 JetBrainsMono Nerd 字体。最后一个截图显示了在 Yakuake/Konsole 中的 wthrr,也使用了 Dracula 颜色方案。

配置

地址、单位和默认预报可以通过在运行时添加 -s 标志将其保存为默认值。这将把配置保存到 wthrr.ron

平台位置
林:~/.config/weathercrab/
Mac:~/Library/Application Support/weathercrab/
Win:%USERPROFILE%\AppData\Roaming\weathercrab\

默认值

(
    address: "", // Address to check the weather, e.g.: "Berlin,DE"
    language: "en_US", // Language code of the output language
    forecast: [], // Forecast to display without adding the `-f` option: `[day]` | `[week]` | `[day, week]`
    units: (
        temperature: celsius, // Temperature units: `celsius` | `fahrenheit`
        speed: kmh, // (Wind)speed units: `kmh` | `mph` | `knots` | `ms`
        time: military, // Time Format: `military` | `ap_pm`
        precipitation: probability, // Precipitation units: `probability` | `mm` | `inch`
    ),
    gui: (
        border: rounded, // Border style: `rounded` | `single` | `solid` | `double`
        color: default, // Color: `default` | `plain`
        graph: (
            // Graph style: lines(solid) | lines(slim) | lines(dotted) | dotted | custom((char; 8))
            // `custom` takes exactly 8 chars. E.g. using a set of 4 chars: `custom(('⡀','⡀','⠄','⠄','⠂','⠂','⠁','⠁'))`,
            style: lines(solid),
            rowspan: double, // Graph height: `double` | `single`
            time_indicator: true, // Indication of the current time in the graph: `true` | `false`
        ),
        greeting: true, // Display greeting message: `true` | `false`
    ),
)

安装

使用Rust包管理器安装wthrr。

从crates.io

版本 命令
发布版 cargo安装wthrr
开发版 不可用

从git源

版本 命令
发布版 cargo安装 --githttps://github.com/ttytm/wthrr-the-weathercrab --标签v1.1.1
开发版 cargo安装 --githttps://github.com/ttytm/wthrr-the-weathercrab

需求和替代方案,以及特定平台的安装说明,可以在 INSTALL.md 中找到。

重要 要正确显示符号,使用的终端必须配置为使用NerdFont。

展望

问题部分列出了正在开发的一些功能。

欢迎提交🐛错误报告、⭐️星标和💡建议!

简单的变更日志可以在 发布页面 上找到。

贡献者

致谢

  • 该应用使用由 Open Meteo 提供的开放源代码天气API进行非商业用途。

依赖关系

~13–27MB
~380K SLoC