Документация RSpec, где она прячется?

Ужасно потрудились найти документацию по RSpec-2 (и rspec-rails). В частности, я хочу просмотреть все доступные сопоставители ... но как?

Я пробовал:

  • RSpec.info: устаревший - RSpec 1.x
  • rdoc.info: в любом случае мне кажется бесполезным. (неполный?)
  • RSpec-Relish: сбивает с толку. неполный? как искать доступные совпадения?
  • GitHub Wiki: разрозненная информация. неорганизованный. неполный?

Да, мне известно о Книге ... но серьезно , разве это не в сети?

Даже пробовал rake doc:plugins, но ничего не вышло. Слишком зеленый, чтобы знать почему ...

очевидно, раньше на rspec.rubyforge.org были приличные документы 1.x. но их, похоже, давно нет ...

Где прячутся эти документы?


ruby-on-rails rspec rspec2
person Meltemi    schedule 30.11.2010    source источник
comment
+1 за крутой заголовок вопроса   -  person Kibet Yegon    schedule 23.02.2012
comment
По состоянию на 27 декабря 2013 г. последняя версия - 2.14.3. rdoc.info/gems/rspec-expectations/2.14.3/frames. Вы можете найти встроенные сопоставители.   -  person shin    schedule 27.12.2013

Ответы (2)


arrow_upward
9
arrow_downward

Не уверен, почему вы считаете, что rdoc.info бесполезен - вот документация по сопоставлению:

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

Возможно, вы смотрите не в том месте; они были в геме RSpec :: Expectations, который отделен от ядра в Rspec 2.

person Keith Gaddis    schedule 30.11.2010
comment
Спасибо! Это полезно! Должно быть, я неправильно использую сайт rdoc.info, когда ищу rspec и получаю: http://rdoc.info/gems/rspec/2.2.0/frames. затем попробуйте найти совпадение и ничего не получите. и если я просматриваю, я теряюсь / запутываюсь в нескольких встроенных фреймах. - person Meltemi; 30.11.2010
comment
Хорошо, пожалуйста, терпите меня ... Я пытаюсь изучить Ruby / Rails, и мне невероятно сложно найти то, что я нахожу в коде ... например: с помощью rubydoc.info site Я попытался найти mock_model и снова оказался пустым ... То же самое и с as_null_object. Это самая запутанная документация, с которой я когда-либо сталкивался ... Конечно, я мог Google, и я был, но это дробный подход. Как мне подойти к проблеме поиска и понимания некоторых методов / символов и т.д., с которыми я сталкиваюсь в коде Ruby / Rails / RSpec / JQuery? - person Meltemi; 30.11.2010
comment
Что я делаю, так это создаю пакет на Railsapi.com, загружаю его и распаковываю на свой локальный жесткий диск. Затем я создаю гибкий односайтовый браузер (я использую Mac, использую Prism в Linux или Windows), указывающий на индексный файл из пакета. В документы railsapi.com встроен довольно хороший поисковый индекс, поэтому я обычно начинаю с него. Если я не могу найти в нем то, что мне нужно, я захожу на rdoc.info с некоторыми обоснованными предположениями о том, где должны быть документы. Google - мое последнее средство. - person Keith Gaddis; 30.11.2010
comment
например, ввод mock_model в мой браузер документации railsapi.com указывает на один результат, Spec :: Rails :: Mocks. as_null_object дает мне два результата: один в Spec :: Mocks :: Methods и один в Spec :: Mocks :: Proxy. Ни у одного из них нет большой документации, но оба могут показать источник рассматриваемого метода, и у обоих также есть ссылки на github. - person Keith Gaddis; 30.11.2010
comment
Превосходно! На Mac тоже ... Я посмотрю на railsapi.com. Спасибо за помощь! - person Meltemi; 01.12.2010

arrow_upward
18
arrow_downward

В первую очередь нужно перейти к официальным документам Relish, они значительно улучшились на протяжении многих лет и теперь я первое место, на которое я смотрю.

На момент написания этого ответа изначально эта суть была твердой. Он содержит сопоставители для следующего:

person Gavin Miller    schedule 18.12.2012
comment
Для меня это отличный ответ. - person Ziggy; 27.02.2013