V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
Wichna
V2EX  ›  分享创造

Rust Search Extension 0.9 发布!支持搜索任意第三方 crate 的文档了!

  •  
  •   Wichna ·
    folyd · 2020-04-27 11:17:04 +08:00 · 2127 次点击
    这是一个创建于 1703 天前的主题,其中的信息可能已经有所发展或是发生改变。

    Rust Search Extension 是一款可以在地址栏快速搜索 Rust 文档、crates 、内置属性和错误码等的浏览器插件,不仅支持 Chrome 和 Firefox,现在也支持 Edge 浏览器了,目前获得了社区很多 Rust 开发者的喜欢,非常感谢大家的支持!

    Rust Search Extension 也在持续更新中,这次发布的 0.9 版给大家带来了如下几项主要功能:

    • 支持搜索任意第三方 crate 的文档
    • 支持搜索 Clippy lint
    • 新的:label 命令 - 搜索 Rust 仓库里面的 issue label
    • 支持暗色模式
    • 支持 Microsoft Edge 浏览器

    如果还不了解 Rust Search Extension 的朋友,欢迎查看我之前发的另外一篇文章。

    支持搜索任意第三方 crate 的文档

    Rust Search Extension 过去的所有版本只支持搜索 std, proc_macro, test 这三个官方标准库里面的文档。但是显然不够,所以这一版最大的更新就是把文档的搜索范围扩大到了任意第三方 crate 。对,没听错,是任意第三方 crate ! 当然为了实现这一步,首先需要把你想要搜索的 crate 加入到插件中。为此 Rust Search Extension 会在 docs.rs 页面的顶栏加入一个黄色的按钮,如图所示:

    点击完按钮后,这个 crate 就会被收录至插件中,然后就可以在地址栏搜索该 crate 的文档了! 搜索方法也很简单,直接输入 @crate ,空格,然后加 关键字 即可!比如我把 tokio 加入到插件中之后,直接可以输入 @tokio spawn 就能立即搜索出 tokio 这个 crate 中跟spawn有关的文档!

    当然,如果某个 crate 名字比较长,在地址栏还要打出整个 crate 的名字会特别麻烦,所以插件会根据输入的字母匹配候选的 crate (前提是要加入到插件中),然后用 Tab 或上下键选中即可。

    如果不再需要搜索某个 crate 了,只需要在 crate 的 docs.rs 页面同样点击黄色按钮即可删除。

    值得注意的是,你加入插件的 crate 是区分版本的。你当时的 docs.rs 里面是什么版本,加入插件的就是那个版本。插件不会自动帮你升级版本号,毕竟 crate 作者更新版本号之后,并不一定适合立即跟进该版本,况且新的版本可能还不稳定。如果你收藏的版本比当前网页中版本要旧,则黄色按钮会显示一个升级图标,点击就可以更新至新版。就像这样:

    支持搜索 Clippy lint

    这是 Github 上一位用户提的需求,我觉得可能部分开发者也需要。cargo clippy 给出的 lint 建议都非常棒,不过详细的建议还是需要到 clippy 的官方文档页查看,不太方便的是需要自己打开文档搜索对应的 lint 名字。现在你可以直接在地址栏输入 >(大于符号)加 lint 名,即可快速定位到该 lint 的文档!

    新的:label命令 - 搜索 Rust 仓库里面的 issue label

    Rust 仓库的目前产生了将近 34 万个 issue (包括已关闭的),这么庞大数量的 issue 是通过接近 300 个 issue label 来有条不紊管理的。这些 issue label 是一个了解 rust 开发进度、新功能新进展、bug 修复情况的绝佳方式。这些 issue label 还会按照不同的维度按不同的前缀命名,比如 F 前缀的表示某个新 feature 相关的 issue,O 前缀表示和 OS 有关的 issue,S 前缀表示和状态有关的 issue,T 前缀表示某个 rust 官方 team 负责的 issue 等等。其中有一个非常重要的标签是 C-tracking-issue,通过这个标签能看到目前某个 RFC 功能汇总的进度状况,非常有用! 所以,:label 就是这样一个帮助大家非常方便快捷搜索这些 label 的命令,只需要输入:label即可。也可以在后面输入你想过滤的字母来快速查找 label 。选中回车之后就可以筛选出该 label 下面的所有 issue 。

    官网

    https://rust-search-extension.now.sh 官网上详细列举了各个功能,并配备了 GIF 图片示例。

    Github

    Rust Search Extension 在 Github https://github.com/huhu/rust-search-extension开源,欢迎大家提 issue 或 PR !

    下载地址

    5 条回复    2020-04-29 15:07:10 +08:00
    Pagliacii
        1
    Pagliacii  
       2020-04-27 11:20:05 +08:00
    用起来挺舒服的,帮顶
    saltbo
        2
    saltbo  
       2020-04-27 11:24:35 +08:00
    好用 手动点赞
    Yucklys
        3
    Yucklys  
       2020-04-27 20:36:28 +08:00
    更新很好,省了很多反复搜文档的时间
    Wichna
        4
    Wichna  
    OP
       2020-04-29 15:06:45 +08:00
    @Pagliacii 谢谢支持
    Wichna
        5
    Wichna  
    OP
       2020-04-29 15:07:10 +08:00
    @saltbo
    @Yucklys
    谢谢大家的喜欢
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5741 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 22ms · UTC 03:06 · PVG 11:06 · LAX 19:06 · JFK 22:06
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.