1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
|
# File 'lib/vips/image.rb', line 1678
def self.generate_operation introspect
return if (introspect.flags & OPERATION_DEPRECATED) != 0
return if NO_GENERATE.include? introspect.name
method_args = introspect.method_args
required_output = introspect.required_output
optional_input = introspect.doc_optional_input
optional_output = introspect.doc_optional_output
print "# @!method "
print "self." unless introspect.member_x
print "#{introspect.name}("
print method_args.map { |x| x[:yard_name] }.join(", ")
print ", " if method_args.length > 0
puts "**opts)"
puts "# #{introspect.description.capitalize}."
method_args.each do |details|
yard_name = details[:yard_name]
gtype = details[:gtype]
blurb = details[:blurb]
puts "# @param #{yard_name} [#{gtype_to_ruby(gtype)}] #{blurb}"
end
puts "# @param opts [Hash] Set of options"
optional_input.each do |arg_name, details|
yard_name = details[:yard_name]
gtype = details[:gtype]
rtype = gtype_to_ruby gtype
blurb = details[:blurb]
puts "# @option opts [#{rtype}] :#{yard_name} #{blurb}"
end
optional_output.each do |arg_name, details|
yard_name = details[:yard_name]
gtype = details[:gtype]
rtype = gtype_to_ruby gtype
blurb = details[:blurb]
puts "# @option opts [#{rtype}] :#{yard_name} Output #{blurb}"
end
print "# @return ["
if required_output.length == 0
print "nil"
elsif required_output.length == 1
print gtype_to_ruby(required_output.first[:gtype])
else
print "Array<"
print required_output.map { |x| gtype_to_ruby(x[:gtype]) }.join(", ")
print ">"
end
if optional_output.length > 0
print ", Hash<Symbol => Object>"
end
print "] "
print required_output.map { |x| x[:blurb] }.join(", ")
if optional_output.length > 0
print ", " if required_output.length > 0
print "Hash of optional output items"
end
puts ""
puts ""
end
|