Sha256: 6483bfcefe54dc94824d86e3c561d1bdd0bf90de901ae581667e765fe0bffd89
Contents?: true
Size: 1.69 KB
Versions: 29
Compression:
Stored size: 1.69 KB
Contents
module JsDuck
module Process
# Auto-detector return values and @chainable tags.
#
# Adds @chainable tag when doc-comment contains @return {OwnerClass}
# this. Also the other way around: when @chainable found, adds
# appropriate @return.
class ReturnValues
def initialize(relations)
@relations = relations
@cls = nil
end
def process_all!
@relations.each do |cls|
@cls = cls
cls.find_members(:tagname => :method, :local => true, :static => false).each do |m|
process(m)
end
end
end
private
def process(m)
if constructor?(m)
add_return_new(m)
elsif chainable?(m)
add_return_this(m)
elsif returns_this?(m)
add_chainable(m)
end
end
def constructor?(m)
m[:name] == "constructor"
end
def chainable?(m)
m[:chainable]
end
def returns_this?(m)
m[:return] && m[:return][:type] == @cls[:name] && m[:return][:doc] =~ /\Athis\b/
end
def add_chainable(m)
m[:chainable] = true
end
def add_return_this(m)
if m[:return] == nil
m[:return] = {:type => @cls[:name], :doc => "this"}
end
end
def add_return_new(m)
if m[:return] == nil || m[:return][:type] == "Object"
# Create a whole new :return hash.
# If we were to just change the :type field it would modify
# the type of all the inherited constructor docs.
m[:return] = {
:type => @cls[:name],
:doc => m[:return] ? m[:return][:doc] : "",
}
end
end
end
end
end
Version data entries
29 entries across 29 versions & 3 rubygems