organize-csproj 1.1.3

Usage

Install as a global dotnet tool.

dotnet tool install -g organize-csproj

Then, use it via:

organize-csproj --input=your-project.csproj

CLI Arguments

--input

Description: The path to a .csproj file.

Default: None

Required: Yes

--output

Description: The filename to save the input.csproj after it has been sorted.

Default: The value of --input (overwrites existing file)

Required: No

--config

Description: The path to a configuration json file

Default: None

Required: No

Example

dotnet organize-csproj --input=project.csproj --output=project.sorted.csproj --config=my.config.json

Configuration

The default configuration can be seen here: csproj.config.defaults.json It should work as a solid reference to get yourself started. The configuration needs to map to SortConfiguration.cs.

If this isn't sufficient documentation, open an issue and I'll write out more.

Sort Options

Below are the primary steps taken when cleaning up a .csproj file.

They each can be disabled using your own configuration file, like so:

{
  "SortOptions": {
    "GroupByNodeType": true,
    "GroupByFileType": true,
    "RemoveEmptyItemGroups": true,
    "SortItemsWithinItemGroups": true
  }
}

They all default to true.

• GroupByNodeType

  • Groups all Items of the same type into their own <ItemGroup>

    (e.g., <Content>, <Compile>, <TypeScriptCompile>, etc)

• GroupByFileType
  • Creates <ItemGroup>s for each distinct filetype
  • Subdivides existing <ItemGroup>s into even more granular <ItemGroup>s
• RemoveEmptyItemGroups
  • Removes <ItemGroup>s without any children. The tool doesn't create empty <ItemGroup>s―this option is for tidying up.
• SortItemsWithinItemGroups
  • Whether to alphanum sort all <ItemGroup>s. Performed last.