client -> server requst: Goto Parent Module

[matklad]

Parent Module

Server Capability: { "parentModule": boolean }

This request is send from client to server to handle "Goto Parent Module" editor action.

Method: experimental/parentModule

Request: TextDocumentPositionParams

Response: Location | Location[] | LocationLink[] | null

Example

// src/main.rs
mod foo;


// src/foo.rs

/* cursor here*/

experimental/parentModule returns a single Link to the mod foo; declaration.

Unresolved Question

• An alternative would be to use a more general "gotoSuper" request, which would work for super methods, super classes and super modules. This is the approach IntelliJ Rust is takeing. However, experience shows that super module (which generally has a feeling of navigation between files) should be separate. If you want super module, but the cursor happens to be inside an overriden function, the behavior with single "gotoSuper" request is surprising.

[rcjsuen]

Response: Location | Location[] | LocationLink[] | null

Would multiple files be opened if an array was returned?

[matklad]

The client should use exactly the same logic it uses for handling other goto definition requests (we use exactly the same return type for goto definition and goto to type I belive). Usually, the logic is to show a drop-down with for choosing which location exactly do you want to go to.

[dbaeumer]

@jrieken do we have a comparable request in VS Code ?

[Septias]

Why has this staled?