Документация как тесты в Ruby?

Существует отличный инструмент rustdoc (в настоящее время используется cargo) для тестовые примеры комментариев к документации в Rust. Дает ли нам rdoc или yard что-то подобное в Ruby?


ruby rustdoc yard rdoc
person Vitalii Elenhaupt    schedule 29.05.2015    source источник
comment
На домашней странице YARD есть реклама о запуске встроенных rspecs. Я также помню жемчужину для запуска примеров кода в комментариях, но не могу найти ее в данный момент. В любом случае запросы на инструменты/библиотеки/и т. д. считаются OT для SO. Однако я подтвержу, что они существуют.   -  person Dave Newton    schedule 29.05.2015
comment
@DaveNewton Извините за ОТ. Закроет запрос после вашего подтверждения. Спасибо!   -  person Vitalii Elenhaupt    schedule 29.05.2015
comment
Без проблем. Я не уверен, что подобные вопросы должны быть OT, но библиотеки/и т.д. относительно эфемерны, так что в этом есть смысл.   -  person Dave Newton    schedule 29.05.2015
comment
Обычно считается, что эта практика возникла с библиотекой Python doctest. Я не уверен, что на Lisp или Smalltalk нет даже более старых примеров, но doctest — это термин, который вам нужен. Для Ruby существует несколько библиотек doctest, но я не уверен, что какая-либо из них все еще поддерживается или хотя бы была зрелой с самого начала.   -  person Jörg W Mittag    schedule 29.05.2015
comment
Я удалил (или что-то еще). При этом этот вопрос больше не требует сторонних ресурсов, а вместо этого касается возможностей двух конкретных драгоценных камней.   -  person Wayne Conrad    schedule 29.05.2015

Ответы (1)


arrow_upward
1
arrow_downward

Что ж, примеров doctest в Ruby немного, и самый свежий (на данный момент) — yard- доктест:

Встречайте YARD::Doctest - простой и волшебный драгоценный камень, который автоматически анализирует ваши теги @example и превращает их в тесты!

Вероятно, не такой мощный, как rustdoc, но он делает то, что нужно.

person Vitalii Elenhaupt    schedule 31.05.2015