class YARD::Tags::AttributeDirective
Defines an attribute with a given name, using indented block data as the attribute's docstring. If the type specifier is supplied with “r”, “w”, or “rw”, the attribute is made readonly, writeonly or readwrite respectively. A readwrite attribute is the default, if no type is specified. The comment containing this directive does not need to be attached to any source, but if it is, that source code will be used as the method's source.
To define a regular method, see {tag:!method}
@note For backwards compatibility support, you do not need to indent
the attribute's docstring text. If an +@!attribute+ directive is seen with no indented block, the entire docstring is used as the new attribute's docstring text.
@example Defining a simple readonly attribute
# @!attribute [r] count # @return [Fixnum] the size of the list
@example Defining a simple readwrite attribute
# @!attribute name # @return [String] the name of the user
@see tag:!method @since 0.7.0
Public Instance Methods
after_parse()
click to toggle source
# File lib/yard/tags/directives.rb, line 446 def after_parse return unless handler use_indented_text create_attribute_data(create_object) end
Protected Instance Methods
method_name()
click to toggle source
# File lib/yard/tags/directives.rb, line 454 def method_name name = sanitized_tag_signature || handler.call_params.first name += '=' unless readable? name end
method_signature()
click to toggle source
# File lib/yard/tags/directives.rb, line 460 def method_signature if readable? "def #{method_name}" else "def #{method_name}(value)" end end
Private Instance Methods
create_attribute_data(object)
click to toggle source
# File lib/yard/tags/directives.rb, line 470 def create_attribute_data(object) return unless object clean_name = object.name.to_s.sub(/=$/, '') attrs = object.namespace.attributes[object.scope] attrs[clean_name] ||= SymbolHash[:read => nil, :write => nil] attrs[clean_name][:read] = object if readable? if writable? if object.name.to_s[-1, 1] == '=' writer = object writer.parameters = [['value', nil]] else writer = CodeObjects::MethodObject.new(object.namespace, object.name.to_s + '=', object.scope) writer.signature = "def #{object.name}=(value)" writer.visibility = object.visibility writer.dynamic = object.dynamic writer.source = object.source writer.group = object.group writer.parameters = [['value', nil]] writer.docstring = object.base_docstring handler.register_file_info(writer) end attrs[clean_name][:write] = writer end end
readable?()
click to toggle source
# File lib/yard/tags/directives.rb, line 500 def readable? !tag.types || tag.types.join =~ /(?!w)r/ end
writable?()
click to toggle source
# File lib/yard/tags/directives.rb, line 496 def writable? !tag.types || tag.types.join.include?('w') end