I was recently asked in an email if I knew of any tools that would translate the XML results file from the JetBrains ReSharper command line tool inspectcode into a human readable format, such as HTML. For your viewing pleasure, here was my response:
There aren't any tools out there yet to convert the XML to HTML, but the XML format is fairly simple, so I suspect it wouldn't take much to write your own.
The file is broken into two sections <IssueTypes> and <Issues>
Under <IssueTypes>, there's a collection of <IssueType> elements, which list all of the violation types that were discovered in your code. Each one has the following possible attributes:
- Id
- This is the unique identifier for the rule
- Category
- This is a general grouping for the rule types
- SubCategory (optional)
- some of the groupings are further split
- Description
- This is a general description of what the rule is checking
- Severity
- One of these values: ERROR, WARNING, SUGGESTION, HINT, DO_NOT_SHOW
- WikiUrl (optional)
- A link to a jetbrains webpage that has additional details about the rule
In the <Issues> section are the specific instances of rule violations found in your code. Under <Issues>, you will find a collection of <Project> elements, each with a Name attribute which will match your Visual Studio project name. Under each <Project> attribute will be a collection of <Issue> elements, each with the following attributes:
- TypeId
- A reference to the rule in the
- File
- The file path that contains the violation. This path is relative to the Visual Studio Solution's folder
- Line
- The line number in the file where the issue occurred
- Message
- A message about why this line of code violated the rule. The message is case-specific and often include the variable name or other context information specific to this line of code.
- Offset
- I'm 100% sure what this actually represents, but from what I can tell, it's the character range (offset from start of file) of the specific text in the file that violates the rule. In Visual Studio, this would be the text that is highlighted/underlined, etc. So a value of "1684-1722" would be the 1684th character in the file through the 1722nd character.
Hope that helps