language_server-protocol 3.7.0.0 → 3.15.0.0

data/lib/language_server/protocol/interface/work_done_progress_options.rb

@@ -0,0 +1,30 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkDoneProgressOptions
+        def initialize(work_done_progress: nil)
+          @attributes = {}
+
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+
+          @attributes.freeze
+        end
+
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/work_done_progress_params.rb

@@ -0,0 +1,33 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkDoneProgressParams
+        def initialize(work_done_token: nil)
+          @attributes = {}
+
+          @attributes[:workDoneToken] = work_done_token if work_done_token
+
+          @attributes.freeze
+        end
+
+        #
+        # An optional token that a server can use to report work done progress.
+        #
+        # @return [string | number]
+        def work_done_token
+          attributes.fetch(:workDoneToken)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/work_done_progress_report.rb

@@ -0,0 +1,70 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkDoneProgressReport
+        def initialize(kind:, cancellable: nil, message: nil, percentage: nil)
+          @attributes = {}
+
+          @attributes[:kind] = kind
+          @attributes[:cancellable] = cancellable if cancellable
+          @attributes[:message] = message if message
+          @attributes[:percentage] = percentage if percentage
+
+          @attributes.freeze
+        end
+
+        # @return ["report"]
+        def kind
+          attributes.fetch(:kind)
+        end
+
+        #
+        # Controls enablement state of a cancel button. This property is only valid if a cancel
+        # button got requested in the `WorkDoneProgressStart` payload.
+        #
+        # Clients that don't support cancellation or don't support control the button's
+        # enablement state are allowed to ignore the setting.
+        #
+        # @return [boolean]
+        def cancellable
+          attributes.fetch(:cancellable)
+        end
+
+        #
+        # Optional, more detailed associated progress message. Contains
+        # complementary information to the `title`.
+        #
+        # Examples: "3/25 files", "project/src/module2", "node_modules/some_dep".
+        # If unset, the previous progress message (if any) is still valid.
+        #
+        # @return [string]
+        def message
+          attributes.fetch(:message)
+        end
+
+        #
+        # Optional progress percentage to display (value 100 is considered 100%).
+        # If not provided infinite progress is assumed and clients are allowed
+        # to ignore the `percentage` value in subsequent in report notifications.
+        #
+        # The value should be steadily rising. Clients are free to ignore values
+        # that are not following this rule.
+        #
+        # @return [number]
+        def percentage
+          attributes.fetch(:percentage)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/workspace_edit.rb

@@ -14,18 +14,24 @@ module LanguageServer
         #
         # Holds changes to existing resources.
         #
-        # @return [{ [uri: string]: TextEdit[]; }]
+        # @return [{}]
         def changes
           attributes.fetch(:changes)
         end
 
         #
-        # An array of `TextDocumentEdit`s to express changes to n different text documents
-        # where each text document edit addresses a specific version of a text document.
+        # Depending on the client capability `workspace.workspaceEdit.resourceOperations` document changes
+        # are either an array of `TextDocumentEdit`s to express changes to n different text documents
+        # where each text document edit addresses a specific version of a text document. Or it can contain
+        # above `TextDocumentEdit`s mixed with create, rename and delete file / folder operations.
+        #
         # Whether a client supports versioned document edits is expressed via
-        # `WorkspaceClientCapabilities.workspaceEdit.documentChanges`.
+        # `workspace.workspaceEdit.documentChanges` client capability.
+        #
+        # If a client neither supports `documentChanges` nor `workspace.workspaceEdit.resourceOperations` then
+        # only plain `TextEdit`s using the `changes` property are supported.
         #
-        # @return [TextDocumentEdit[]]
+        # @return [TextDocumentEdit[] | (TextDocumentEdit | CreateFile | RenameFile | DeleteFile)[]]
         def document_changes
           attributes.fetch(:documentChanges)
         end

data/lib/language_server/protocol/interface/workspace_edit_client_capabilities.rb

@@ -0,0 +1,53 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkspaceEditClientCapabilities
+        def initialize(document_changes: nil, resource_operations: nil, failure_handling: nil)
+          @attributes = {}
+
+          @attributes[:documentChanges] = document_changes if document_changes
+          @attributes[:resourceOperations] = resource_operations if resource_operations
+          @attributes[:failureHandling] = failure_handling if failure_handling
+
+          @attributes.freeze
+        end
+
+        #
+        # The client supports versioned document changes in `WorkspaceEdit`s
+        #
+        # @return [boolean]
+        def document_changes
+          attributes.fetch(:documentChanges)
+        end
+
+        #
+        # The resource operations the client supports. Clients should at least
+        # support 'create', 'rename' and 'delete' files and folders.
+        #
+        # @return [ResourceOperationKind[]]
+        def resource_operations
+          attributes.fetch(:resourceOperations)
+        end
+
+        #
+        # The failure handling strategy of a client if applying the workspace edit
+        # fails.
+        #
+        # @return [FailureHandlingKind]
+        def failure_handling
+          attributes.fetch(:failureHandling)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/workspace_folder.rb

@@ -20,8 +20,8 @@ module LanguageServer
         end
 
         #
-        # The name of the workspace folder. Defaults to the
-        # uri's basename.
+        # The name of the workspace folder. Used to refer to this
+        # workspace folder in the user interface.
         #
         # @return [string]
         def name

data/lib/language_server/protocol/interface/workspace_folders_server_capabilities.rb

@@ -0,0 +1,48 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkspaceFoldersServerCapabilities
+        def initialize(supported: nil, change_notifications: nil)
+          @attributes = {}
+
+          @attributes[:supported] = supported if supported
+          @attributes[:changeNotifications] = change_notifications if change_notifications
+
+          @attributes.freeze
+        end
+
+        #
+        # The server has support for workspace folders
+        #
+        # @return [boolean]
+        def supported
+          attributes.fetch(:supported)
+        end
+
+        #
+        # Whether the server wants to receive workspace folder
+        # change notifications.
+        #
+        # If a string is provided, the string is treated as an ID
+        # under which the notification is registered on the client
+        # side. The ID can be used to unregister for these events
+        # using the `client/unregisterCapability` request.
+        #
+        # @return [string | boolean]
+        def change_notifications
+          attributes.fetch(:changeNotifications)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/workspace_symbol_client_capabilities.rb

@@ -0,0 +1,42 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkspaceSymbolClientCapabilities
+        def initialize(dynamic_registration: nil, symbol_kind: nil)
+          @attributes = {}
+
+          @attributes[:dynamicRegistration] = dynamic_registration if dynamic_registration
+          @attributes[:symbolKind] = symbol_kind if symbol_kind
+
+          @attributes.freeze
+        end
+
+        #
+        # Symbol request supports dynamic registration.
+        #
+        # @return [boolean]
+        def dynamic_registration
+          attributes.fetch(:dynamicRegistration)
+        end
+
+        #
+        # Specific capabilities for the `SymbolKind` in the `workspace/symbol` request.
+        #
+        # @return [{ valueSet?: any[]; }]
+        def symbol_kind
+          attributes.fetch(:symbolKind)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/workspace_symbol_options.rb

@@ -0,0 +1,25 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkspaceSymbolOptions < WorkDoneProgressOptions
+        def initialize(work_done_progress: nil)
+          @attributes = {}
+
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+
+          @attributes.freeze
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/interface/workspace_symbol_params.rb

@@ -4,17 +4,19 @@ module LanguageServer
       #
       # The parameters of a Workspace Symbol Request.
       #
-      class WorkspaceSymbolParams
-        def initialize(query:)
+      class WorkspaceSymbolParams < PartialResultParams
+        def initialize(partial_result_token: nil, query:)
           @attributes = {}
 
+          @attributes[:partialResultToken] = partial_result_token if partial_result_token
           @attributes[:query] = query
 
           @attributes.freeze
         end
 
         #
-        # A non-empty query string
+        # A query string to filter symbols by. Clients may send an empty
+        # string here to request all symbols.
         #
         # @return [string]
         def query

data/lib/language_server/protocol/interface/workspace_symbol_registration_options.rb

@@ -0,0 +1,25 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class WorkspaceSymbolRegistrationOptions < WorkspaceSymbolOptions
+        def initialize(work_done_progress: nil)
+          @attributes = {}
+
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+
+          @attributes.freeze
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

data/lib/language_server/protocol/transport.rb

@@ -1 +1,2 @@
+require "language_server/protocol/transport/io"
 require "language_server/protocol/transport/stdio"

data/lib/language_server/protocol/transport/io.rb

@@ -0,0 +1,2 @@
+require "language_server/protocol/transport/io/reader"
+require "language_server/protocol/transport/io/writer"

data/lib/language_server/protocol/transport/io/reader.rb

@@ -0,0 +1,47 @@
+require "json"
+
+module LanguageServer
+  module Protocol
+    module Transport
+      module Io
+        class Reader
+          def initialize(io)
+            @io = io
+          end
+
+          def read(&block)
+            buffer = ""
+            header_parsed = false
+            content_length = nil
+
+            while char = io.getc
+              buffer << char
+
+              unless header_parsed
+                if buffer[-4..-1] == "\r\n" * 2
+                  content_length = buffer.match(/Content-Length: (\d+)/i)[1].to_i
+
+                  header_parsed = true
+                  buffer.clear
+                end
+              else
+                if buffer.bytesize == content_length
+                  request = JSON.parse(buffer, symbolize_names: true)
+
+                  block.call(request)
+
+                  header_parsed = false
+                  buffer.clear
+                end
+              end
+            end
+          end
+
+          private
+
+          attr_reader :io
+        end
+      end
+    end
+  end
+end