Merge branch 'mr/add_gpr_dependency_custom_request' into 'master'

Add a custom request to fetch dependency between gpr files projets.

See merge request eng/ide/ada_language_server!2044

Author: Mathéo Rome

doc/gpr_dependencies.md

@@ -0,0 +1,63 @@
+# GPR dependencies
+
+## Short introduction
+
+This implements the functionality 'show gpr dependencies', allowing to
+query all the dependencies of a given GPR file.
+
+This request returns an array of items, each one containing a URI
+to another GPR file and the kind of dependency that binds them together.
+
+The dependencies are listed in the `ALS_GPR_DependencyKind` enum below.
+
+You can control whether you get the GPR files that depend on the
+requested GPR file or the requested GPR file's own dependencies.
+
+## Capabilities
+
+The `initialize` request returns `als-gpr-dependencies` in the list of
+supported commands if the server supports this functionality.
+
+## Change description
+
+We introduce four new types to represent the request parameters and results:
+
+```typescript
+export enum ALS_GPR_DependencyKind {
+   AGGREGATED,
+   EXTENDED,
+   EXTENDING,
+   IMPORTED,
+}
+
+export enum ALS_GprDependencyDirection {
+   SHOW_OUTGOING= 1 /* Get the outgoing dependencies */,
+   SHOW_INCOMING = 2 /* Get the incoming dependencies */,
+}
+
+interface ALS_GPR_DependenciesParams {
+   uri: DocumentUri /* The queried unit */;
+   direction: ALS_GprDependencyDirection /* The direction in which to fetch the dependencies */;
+}
+
+export type ALS_GPR_DependencyItem = {
+   uri: DocumentUri /* The dependency's gpr file */;
+   kind: ALS_GPRDependencyKind /* The dependency kind */;
+};
+```
+
+And a new command `als-show-dependencies`:
+
+```txt
+    method: `workspace/executeCommand`
+    "params": {
+       "command": "als-gpr-dependencies",
+       "arguments": [
+          <ALS_GRP_DependenciesParams>
+       ]
+    }
+```
+
+It returns list of `ALS_GPR_DependencyItem`:
+
+result: `ALS_GPR_DependencyItem[]`

source/ada/lsp-ada_driver.adb

@@ -77,6 +77,7 @@ with LSP.Ada_Handlers.Refactor.Replace_Type;
 with LSP.Ada_Handlers.Refactor.Sort_Dependencies;
 with LSP.Ada_Handlers.Refactor.Suppress_Seperate;
 with LSP.Ada_Handlers.Show_Dependencies_Commands;
+with LSP.Ada_Handlers.GPR_Dependencies_Commands;
 with LSP.Ada_Handlers.Source_Dirs_Commands;
 with LSP.Ada_Handlers.Suspend_Executions;
 with LSP.Ada_Inline_Value;
@@ -194,6 +195,8 @@ procedure LSP.Ada_Driver is
         (LSP.Ada_Handlers.Open_ALS_Log_File_Commands.Command'Tag);
       LSP.Ada_Commands.Register
         (LSP.Ada_Handlers.Show_Dependencies_Commands.Command'Tag);
+      LSP.Ada_Commands.Register
+        (LSP.Ada_Handlers.GPR_Dependencies_Commands.Command'Tag);
       LSP.Ada_Commands.Register
         (LSP.Ada_Handlers.Source_Dirs_Commands.Command'Tag);
       LSP.Ada_Commands.Register