RSpec 文档...它藏在哪里？答案

【问题标题】：RSpec documentation...where is it hiding?RSpec 文档...它藏在哪里？
【发布时间】：2011-05-18 01:20:08
【问题描述】：

很难找到 RSpec-2（和 rspec-rails）文档。具体来说，我想查找所有可用的匹配器......但是如何？

我试过了：

RSpec.info：过时 - RSpec 1.x
rdoc.info ：对我来说似乎没用。（不完整？）
RSpec-Relish：令人困惑。不完整？如何查找可用的 Matchers？
GitHub Wiki：零散信息。无组织的。不完整？

是的，我知道The Book...但是，说真的，这不是网上的东西吗？

甚至尝试过rake doc:plugins，但没有成功。太绿了，不知道为什么...

显然，rspec.rubyforge.org 上曾经有一些不错的 1.x 文档。但它们似乎早已不复存在......

这些文档藏在哪里？

【问题讨论】：

+1 表示很酷的问题标题
截至 2013 年 12 月 27 日，2.14.3 是最新的。 rdoc.info/gems/rspec-expectations/2.14.3/frames。你可以找到内置的匹配器。

标签： ruby-on-rails rspec rspec2

【解决方案1】：

不知道为什么你觉得 rdoc.info 没有用 - 这里是匹配器文档：

http://rubydoc.info/gems/rspec-expectations/2.0.1/RSpec/Matchers

可能是你找错地方了；这些在 RSpec::Expectations gem 中，它在 Rspec 2 中从核心中分离出来。

【讨论】：

谢谢！这很有帮助！当我搜索“rspec”并得到：http://rdoc.info/gems/rspec/2.2.0/frames 时，我一定是错误地使用了 rdoc.info 站点。然后尝试搜索匹配器并一无所获。如果我浏览，我会在多个嵌入式框架中迷失/困惑。
好的，请多多包涵……我正在努力学习 Ruby/Rails，发现查找代码中的内容非常困难……例如：使用 rubydoc.info 网站我尝试搜索mock_model 并再次出现空...与as_null_object 相同。这是我遇到过的最令人困惑的文档...当然，我可以 Google，而且我一直这样做，但这是一种霰弹枪的方法。我应该如何解决在 Ruby/Rails/RSpec/JQuery 代码中遇到的查找和理解某些方法/符号等的“问题”？
我所做的是在 Railsapi.com 上创建一个包，下载它，然后将它解压缩到我的本地硬盘驱动器上。然后我创建了一个流畅的单站点浏览器（我在 mac 上，在 linux 或 windows 上使用 prism）指向包中的索引文件。 railsapi.com 的文档中内置了一个非常好的搜索索引，所以我通常从那里开始。如果我在其中找不到我需要的东西，那么我会在 rdoc.info 上对文档应该在哪里进行一些有根据的猜测。谷歌是我最后的选择。
例如，在我的 railsapi.com 文档浏览器中输入“mock_model”会指向一个结果，Spec::Rails::Mocks。 “as_null_object”给了我两个结果，一个在 Spec::Mocks::Methods 中，一个在 Spec::Mocks::Proxy 中。两者都没有太多的文档方式，但都可以显示相关方法的来源，并且都具有指向 github 的链接。
太棒了！在 Mac 上也是如此......我将研究 railsapi.com。感谢您的帮助！

【解决方案2】：

第一个去的地方是官方Relish docs，这些年来他们已经有了很大的改进，现在是我第一个去的地方。

在最初写这个答案的时候，这个gist 是可靠的。它包含以下匹配器：

【讨论】：

这对我来说是一个很好的答案。