sourcegraph-configurable-references

Lets you configure reference finding using regular expressions

Usage no npm install needed!

<script type="module">
  import sourcegraphConfigurableReferences from 'https://cdn.skypack.dev/sourcegraph-configurable-references';
</script>

README

Sourcegraph Configurable References

travis npm

A Sourcegraph extension allowing you to add and configure reference finding for custom entities (for instance HTTP routes, build tasks, string literals...) using regular expressions.

Configuration

Custom references can be added through the "customReferences" property of the Sourcegraph client settings. Here is an example configuration to add reference finding for HTTP routes in go:

"customReferences": [
    {
      "name": "HTTP Route",
      "preview": ": `\"/$1\"`",
      "definitions": [{
          "search": "/httpPost\\(ctx, req.Repo, \"$1/",
          "capture": "httpPost\\(ctx, req\\.Repo, \"/?([^\"]+)\""
        }],
      "references": [{
          "search": "mux.HandleFunc\\(\\\"\\/$1",
          "capture": "mux.HandleFunc\\(\"/([^\"]+)"
      }],
      "implementations": [],
    }
  ]

With this configuration, hovering HTTP route definitions will trigger a tooltip a tooltip allowing to find references:

example

Defaults

If your Sourcegraph configuration does not have a "customReferences" field, the extension will create it, and include by default the configuration for string literal references