Sourcy is a Source Generator that gives you static compile-time properties to file paths within your repository.

This can be useful for things like tests, scripts or pipelines where you may need to locate something from the file system.

This can avoid having to deal with relative paths, or defining absolute paths which may change machine-to-machine.

After installing the Sourcy package(s) you want, properties can be found within the Sourcy namespace. So just start typing Sourcy. and your IDE should help you with the rest.

Sourcy searches from the root of your repository or project. It'll traverse upwards until it finds a folder either containing a .git folder, or a .sourcyroot file. That file doesn't need to have any contents, just simply exist. If it can't find these, it will not run.

Currently Sourcy has 4 packages:

Attempts to find your Git directory by parsing the result of git rev-parse --show-toplevel

Searches for Projects with a .csproj, .fsproj or .vbproj extension

Searches for Solutions with a .sln, .slnx or .slnf extension

Locates Node projects within your repository by looking for a package-lock.json or yarn.lock file

Locates Dockerfiles within your repository

For files you are given a FileInfo object, and for directories a DirectoryInfo object. This allows you to easy call things like EnumerateFiles on.

e.g.

var testResultsReport = Sourcy.Git.RootDirectory
            .EnumerateFiles("*.trx", SearchOption.AllDirectories)
            .First();