A dotnet tool that displays project properties.

Install the Nito.ProjProps package.

projprops is a dotnet cli tool that evaluates and displays MSBuild project properties. It is primarily used in build scripts, but can be used anytime you need to evaluate MSBuild properties.

E.g., projprops --name version will evaluate the project file in the current directory and display its Version property. The project file is evaluated, so the project file may set Version directly, or Version may be inferred from VersionPrefix and VersionSuffix, or Version may be set by Directory.Build.props, etc.

projprops evaluates a single project, similar to how dotnet run works. projprops will evaluate the project in the current directory by default, or the project specified with the --project command line parameter.

Alternatively, you may pass --project-search, which will cause projprops to search for project files in any subdirectory of the current directory, and just use the first one it finds. This is most useful when displaying properties set in Directory.Build.props files.

By default, projprops displays all properties for the current project, including properties imported from SDK or other imported files, but excluding all other properties. You can include environment variable properties, global properties, or reserved properties by disabling the corresponding option (e.g., --exclude-reserved false).

You can also filter properties by name. The --name command line parameter takes a case-insensitive regular expression, and only properties matching that expression are displayed. projprops --name ".*pack.*" displays all properties with "pack" in the name, and projprops --name version displays only the Version property.

By default, projprops displays each property on a single line, with any non-printable or non-ASCII characters displayed as percent-encoded UTF-8 code points, e.g., %0A%0D for \r\n, and %25 for %. Percent-encoding is done for any character less than U+0020, greater than U+007E, or equal to U+0025 (the % symbol).

The --output-format option allows specifying Json, which displays all properties as a single JSON object, with the property names as keys and the property values as the string values of the JSON object.

--output-format can also specify SingleValueOnly, which only displays the value (unencoded) of a single property, which is useful for scripting scenarios. This option is generally used with --name to ensure only one property matches, e.g., projprops --name version --output-format SingleValueOnly.

projprops can set global properties via the --properties command line argument. E.g., projprops --properties Configuration=Release CI=true.

If you want voluminous output to track down what's going wrong, pass the --debug command line option. You might want to pipe it to a file, because this will generate a lot of output.

projprops was designed to work with .NET Core SDK-style project files. If you're using the old verbose project file syntax, then it probably will not work. Please do create an issue if this capability is important to you.

• Update to net6 using MSBuild 17.

• Initial release using net3.1 MSBuild 16.