Tài liệu sân và `define_method`

Question

Có cách nào để nhận xét các phương thức được xác định bằng define_method trong YardDoc không?

Tôi cố gắng này:

%w(one two three).each do |type| 
    # The #{type} way 
    # @return [String] the #{type} way 
    define_method("#{type}_way") do ... end 
end 

Nhưng, không may, không phải làm việc.

Answer 1

Nếu bạn di chuyển tạo ra phương pháp thành một phương pháp học, bạn có thể sử dụng một macro:

class Foo 

    # @!macro [attach] generate 
    # @method $1_way 
    # The $1 way 
    # @return [String] the $1 way 
    def self.generate(type) 
    define_method("#{type}_way") do 
    end 
    end 

    generate :one 
    generate :two 
    generate :three 

end 

YARD Output:

- (String) one_way 

Một cách

Returns:

(String) - một trong những cách

---

- (String) three_way 

Ba cách

Returns:

(String) - ba cách

---

- (String) two_way 

.210

Hai cách

Returns:

(String) - hai cách