Use Hackage for Documentation and Source links

[Saizan]

This is enabled by the new linkToHackage configuration option.

This is useful if you don't have local documentation or sources built, or other minor downsides of using local files. The vscode-haskell provides similar functionality but by trying to mangle the local file links, which is error prone because the path structure has changed between ghc versions.

If local documentation/source exists it gets used as a hint for which module to link to, which generally gives better results in case of re-exports. Otherwise we pick the module where the name is defined, and generate the link using its package name and version.

I am quite unsure if how I wired in the linkToHackage config option is appropriate. But I didn't want to do any refactor without some feedback first.

Initially I figured linkToHackage should be a plugin config for ghcide-hover-and-symbols, but the flag affects the GetDocMap rule which structurally appears to be more part of the core? The first way I wrote it I got import cycles so I backed off.

I am happy to have the flag where it is or move it if desired. And in any case I will split it into linkDocToHackage and linkSrcToHackage for flexibility.

[fendor]

One suggestion and can we add a regression test case, somehow to make sure this doesn't accidentally break?

Otherwise, LGTM :)

[Saizan]

@fendor I got a bit lost trying to add regression tests, would it look something like the ones in FindDefinitionAndHoverTests ?

[vidit-od]

We can use https here

[vidit-od]

( personal nitpick , this is also fine)
can make these one lines
i.e

    LinkToHackage -> toHackageDocUriText env mod (takeFileName <$> doc)
    LinkToLocal -> toFileUriText doc
src_link = case linkSource of
    LinkToHackage ->  toHackageSrcUriText env mod (takeFileName <$> src)
    LinkToLocal -> toFileUriText src

[vidit-od]

@Saizan Overall looks good,
regarding regression tests,

what you linked is a good pattern to follow, but from what i could see,
FindDefinitionAndHoverTests will use LinkToLocal by default. You'll need to write a separate test function that uses testithconfig with a custom Testconfig that sets to LinkToHackage maybe