Skip to content

A GitHub Action that adds rich code navigation to a repo's branches and pull requests.

License

Notifications You must be signed in to change notification settings

noellelc/RichCodeNavIndexer

 
 

Repository files navigation

GitHub Action for Rich Code Navigation indexing

GitHub Actions status

This action indexes the repo it runs within and uploads the language service data to the Rich Code Nav service.

Pre-requisite:
You must sign-up and be approved for Rich Code Navigation Private Preview prior to installing this GitHub Action.

Example usage

- uses: microsoft/RichCodeNavIndexer@v0.1
  with:
    repo-token: ${{ github.token }}

Inputs

You may have specific requirements that need additional configurations beyond the default. There are a number of optional inputs that are accepted to support various repository requirements.

Name Default Description
repo-token Required input to get access to the repo and should be set to ${{ github.token }}.
languages List of languages to use when discovering repository symbols, separated by ,
nugetFeed Feed source to use when installing Rich Code Navigation NuGet packages
nugetVersion latest The version of the Rich Code Navigation nuget packages to use. Use latest to download the latest package (including prereleases).
environment production development, staging, or production
richNavLogOutputDirectory A comma-separated list of log files created from the build when RichCodeNav.EnvVarDump is a package reference
sourceRootDir The directory on the machine where the source code is located, if different from the default.
uploadRichNavArtifacts false A boolean indicating whether Rich Nav log files should be uploaded as a build artifact. Not yet supported for GitHub Actions. Instead, please use the output variable lspLogsPath to publish Rich Nav artifacts.
configFiles The config file(s) for the project(s) to be indexed either as glob patterns or specific file paths relative to the root of the repo, separated by ','
maxParallelIndexingJobs 2 The number of indexers to be run in parallel.
typescriptVersion 0.6.0-next.13 Optional version of TypeScript tools to use. See https://www.npmjs.com/package/lsif
advancedOptionsCpp Additional command line arguments to the c++ LSIF tool. E.g. --arch x86 --verbose
csharpVersion 4.0.0-3.21372.2 Optional version of Csharp tools to use. For versions see https://dnceng.visualstudio.com/public/_packaging?_a=feed&feed=dotnet-tools

Outputs

Name Description
lspLogsPath The path to LSP logs that may be uploaded as an artifact for diagnostics.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

About

A GitHub Action that adds rich code navigation to a repo's branches and pull requests.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 73.2%
  • JavaScript 26.8%