lib/solargraph/api_map/source_to_yard.rb
# frozen_string_literal: true module Solargraph class ApiMap module SourceToYard # Get the YARD CodeObject at the specified path. # # @generic T # @param path [String] # @param klass [Class<generic<T>>] # @return [generic<T>, nil] def code_object_at path, klass = YARD::CodeObjects::Base obj = code_object_map[path] obj if obj&.is_a?(klass) end # @return [Array<String>] def code_object_paths code_object_map.keys end # @param store [ApiMap::Store] ApiMap pin store # @return [void] def rake_yard store YARD::Registry.clear code_object_map.clear store.namespace_pins.each do |pin| next if pin.path.nil? || pin.path.empty? if pin.code_object code_object_map[pin.path] ||= pin.code_object next end if pin.type == :class code_object_map[pin.path] ||= YARD::CodeObjects::ClassObject.new(root_code_object, pin.path) { |obj| next if pin.location.nil? || pin.location.filename.nil? obj.add_file(pin.location.filename, pin.location.range.start.line, !pin.comments.empty?) } else code_object_map[pin.path] ||= YARD::CodeObjects::ModuleObject.new(root_code_object, pin.path) { |obj| next if pin.location.nil? || pin.location.filename.nil? obj.add_file(pin.location.filename, pin.location.range.start.line, !pin.comments.empty?) } end code_object_map[pin.path].docstring = pin.docstring store.get_includes(pin.path).each do |ref| include_object = code_object_at(pin.path, YARD::CodeObjects::ClassObject) include_object.instance_mixins.push code_object_map[ref] unless include_object.nil? or include_object.nil? end store.get_extends(pin.path).each do |ref| extend_object = code_object_at(pin.path, YARD::CodeObjects::ClassObject) extend_object.instance_mixins.push code_object_map[ref] unless extend_object.nil? or extend_object.nil? extend_object.class_mixins.push code_object_map[ref] unless extend_object.nil? or extend_object.nil? end end store.method_pins.each do |pin| if pin.code_object code_object_map[pin.path] ||= pin.code_object next end code_object_map[pin.path] ||= YARD::CodeObjects::MethodObject.new(code_object_at(pin.namespace, YARD::CodeObjects::NamespaceObject), pin.name, pin.scope) { |obj| next if pin.location.nil? || pin.location.filename.nil? obj.add_file pin.location.filename, pin.location.range.start.line } method_object = code_object_at(pin.path, YARD::CodeObjects::MethodObject) method_object.docstring = pin.docstring method_object.visibility = pin.visibility || :public method_object.parameters = pin.parameters.map do |p| [p.name, p.asgn_code] end end end private # @return [Hash{String => YARD::CodeObjects::Base}] def code_object_map @code_object_map ||= {} end # @return [YARD::CodeObjects::RootObject] def root_code_object @root_code_object ||= YARD::CodeObjects::RootObject.new(nil, 'root') end end end end