ruby-on-rails – 在rails中添加模型范围的文档

前端之家收集整理的这篇文章主要介绍了ruby-on-rails – 在rails中添加模型范围的文档前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我不确定这是否真的可行,但我正在尝试通过在app / models文件添加范围文档来使rails应用程序的文档更加完整.我想要尝试做的是:
# This is a description of what the scope does and the action that it performs
scope :newest_records,order("created_at desc").limit(50)

然后当我在应用程序上运行rdoc时,我希望将newest_records列为公共类方法以及更为传统的方法,这些方法将记录如下:

# some more documentation about this method
def self.a_class method
  ....
end

编辑

我意识到这个问题可能有点含糊不清.所以这里是一个澄清的尝试:目前,当我尝试在范围声明上方添加注释行时,我没有获得RDoc为范围生成的文档.我知道RDoc可以获取方法/属性,否则它不会在使用attr_accessor声明的文档中显示属性.所以我的问题是如何在我的文件添加注释,以便:

>该方法出现在我的RDoc生成的文档中
>它显示为公共类方法(与公共实例方法等相对)

解决方法

在RDoc Docs中进行了一些挖掘后,我想我已经设法回答了我自己的问题.

您可以按如下方式记录范围:

##
# :singleton-method:
# Documentation for the scope to explain what it does
scope :newest_records,order("created_at desc").limit(50)

双哈希用于获取元编程方法,如果您正在创建实例方法,那么这就是您所需要的.但是,当作用域创建一个类方法时,您还需要使用:singleton-method:行来表示.在以下行中记录正常继续.

您可以在RDoc Documentation中查看用于记录元方法等的完整语法

原文链接:https://www.f2er.com/ruby/269684.html

猜你在找的Ruby相关文章