# typed: strict # frozen_string_literal: true require "shellwords" module RubyLsp module Listeners class CodeLens extend T::Sig include Requests::Support::Common BASE_COMMAND = T.let( begin Bundler.with_original_env { Bundler.default_lockfile } "bundle exec ruby" rescue Bundler::GemfileNotFound "ruby" end + " -Itest ", String, ) ACCESS_MODIFIERS = T.let([:public, :private, :protected], T::Array[Symbol]) SUPPORTED_TEST_LIBRARIES = T.let(["minitest", "test-unit"], T::Array[String]) DESCRIBE_KEYWORD = T.let(:describe, Symbol) IT_KEYWORD = T.let(:it, Symbol) DYNAMIC_REFERENCE_MARKER = T.let("", String) sig do params( response_builder: ResponseBuilders::CollectionResponseBuilder[Interface::CodeLens], global_state: GlobalState, uri: URI::Generic, dispatcher: Prism::Dispatcher, ).void end def initialize(response_builder, global_state, uri, dispatcher) @response_builder = response_builder @global_state = global_state @uri = T.let(uri, URI::Generic) @path = T.let(uri.to_standardized_path, T.nilable(String)) # visibility_stack is a stack of [current_visibility, previous_visibility] @visibility_stack = T.let([[:public, :public]], T::Array[T::Array[T.nilable(Symbol)]]) @group_stack = T.let([], T::Array[String]) @group_id = T.let(1, Integer) @group_id_stack = T.let([], T::Array[Integer]) # We want to avoid adding code lenses for nested definitions @def_depth = T.let(0, Integer) dispatcher.register( self, :on_class_node_enter, :on_class_node_leave, :on_module_node_enter, :on_module_node_leave, :on_def_node_enter, :on_def_node_leave, :on_call_node_enter, :on_call_node_leave, ) end sig { params(node: Prism::ClassNode).void } def on_class_node_enter(node) @visibility_stack.push([:public, :public]) class_name = node.constant_path.slice @group_stack.push(class_name) if @path && class_name.end_with?("Test") add_test_code_lens( node, name: class_name, command: generate_test_command(group_stack: @group_stack), kind: :group, ) @group_id_stack.push(@group_id) @group_id += 1 end end sig { params(node: Prism::ClassNode).void } def on_class_node_leave(node) @visibility_stack.pop @group_stack.pop class_name = node.constant_path.slice if @path && class_name.end_with?("Test") @group_id_stack.pop end end sig { params(node: Prism::DefNode).void } def on_def_node_enter(node) @def_depth += 1 return if @def_depth > 1 class_name = @group_stack.last return unless class_name&.end_with?("Test") visibility, _ = @visibility_stack.last if visibility == :public method_name = node.name.to_s if @path && method_name.start_with?("test_") add_test_code_lens( node, name: method_name, command: generate_test_command(method_name: method_name, group_stack: @group_stack), kind: :example, ) end end end sig { params(node: Prism::DefNode).void } def on_def_node_leave(node) @def_depth -= 1 end sig { params(node: Prism::ModuleNode).void } def on_module_node_enter(node) if (path = namespace_constant_name(node)) @group_stack.push(path) else @group_stack.push(DYNAMIC_REFERENCE_MARKER) end end sig { params(node: Prism::ModuleNode).void } def on_module_node_leave(node) @group_stack.pop end sig { params(node: Prism::CallNode).void } def on_call_node_enter(node) name = node.name arguments = node.arguments # If we found `private` by itself or `private def foo` if ACCESS_MODIFIERS.include?(name) if arguments.nil? @visibility_stack.pop @visibility_stack.push([name, name]) elsif arguments.arguments.first.is_a?(Prism::DefNode) visibility, _ = @visibility_stack.pop @visibility_stack.push([name, visibility]) end return end if [DESCRIBE_KEYWORD, IT_KEYWORD].include?(name) case name when DESCRIBE_KEYWORD add_spec_code_lens(node, kind: :group) @group_id_stack.push(@group_id) @group_id += 1 when IT_KEYWORD add_spec_code_lens(node, kind: :example) end end end sig { params(node: Prism::CallNode).void } def on_call_node_leave(node) _, prev_visibility = @visibility_stack.pop @visibility_stack.push([prev_visibility, prev_visibility]) if node.name == DESCRIBE_KEYWORD @group_id_stack.pop end end private sig { params(node: Prism::Node, name: String, command: String, kind: Symbol).void } def add_test_code_lens(node, name:, command:, kind:) # don't add code lenses if the test library is not supported or unknown return unless SUPPORTED_TEST_LIBRARIES.include?(@global_state.test_library) && @path arguments = [ @path, name, command, { start_line: node.location.start_line - 1, start_column: node.location.start_column, end_line: node.location.end_line - 1, end_column: node.location.end_column, }, ] grouping_data = { group_id: @group_id_stack.last, kind: kind } grouping_data[:id] = @group_id if kind == :group @response_builder << create_code_lens( node, title: "Run", command_name: "rubyLsp.runTest", arguments: arguments, data: { type: "test", **grouping_data }, ) @response_builder << create_code_lens( node, title: "Run In Terminal", command_name: "rubyLsp.runTestInTerminal", arguments: arguments, data: { type: "test_in_terminal", **grouping_data }, ) @response_builder << create_code_lens( node, title: "Debug", command_name: "rubyLsp.debugTest", arguments: arguments, data: { type: "debug", **grouping_data }, ) end sig do params( group_stack: T::Array[String], spec_name: T.nilable(String), method_name: T.nilable(String), ).returns(String) end def generate_test_command(group_stack: [], spec_name: nil, method_name: nil) command = BASE_COMMAND + T.must(@path) case @global_state.test_library when "minitest" last_dynamic_reference_index = group_stack.rindex(DYNAMIC_REFERENCE_MARKER) command += if last_dynamic_reference_index # In cases where the test path looks like `foo::Bar` # the best we can do is match everything to the right of it. # Tests are classes, dynamic references are only a thing for modules, # so there must be something to the left of the available path. group_stack = T.must(group_stack[last_dynamic_reference_index + 1..]) if method_name " --name " + "/::#{Shellwords.escape(group_stack.join("::")) + "#" + Shellwords.escape(method_name)}$/" else # When clicking on a CodeLens for `Test`, `(#|::)` will match all tests # that are registered on the class itself (matches after `#`) and all tests # that are nested inside of that class in other modules/classes (matches after `::`) " --name " + "\"/::#{Shellwords.escape(group_stack.join("::"))}(#|::)/\"" end elsif method_name # We know the entire path, do an exact match " --name " + Shellwords.escape(group_stack.join("::")) + "#" + Shellwords.escape(method_name) elsif spec_name " --name " + "/#{Shellwords.escape(spec_name)}/" else # Execute all tests of the selected class and tests in # modules/classes nested inside of that class " --name " + "\"/^#{Shellwords.escape(group_stack.join("::"))}(#|::)/\"" end when "test-unit" group_name = T.must(group_stack.last) command += " --testcase " + "/#{Shellwords.escape(group_name)}/" if method_name command += " --name " + Shellwords.escape(method_name) end end command end sig { params(node: Prism::CallNode, kind: Symbol).void } def add_spec_code_lens(node, kind:) arguments = node.arguments return unless arguments first_argument = arguments.arguments.first return unless first_argument name = case first_argument when Prism::StringNode first_argument.content when Prism::ConstantReadNode, Prism::ConstantPathNode constant_name(first_argument) end return unless name if @path add_test_code_lens( node, name: name, command: generate_test_command(spec_name: name), kind: kind, ) end end end end end