Extract new ccsh filter "inspect"

[Richargh]

Feature request

Create new ccsh filter "inspect"

Description

As an auditor, I want to extract a filter that shows me the structure of a cc.json so that I can verify the structure of a cc.json without uncompressing, prettyfying and opening it in my editor.

In audits we quickly want to verify that a cc.json has the expected contents. Often we need to do this before merging two or more cc.json files. Imagine one .git.cc.json file was created in the git root and a sonar.cc.json was created for a sub-project (happens in mono-repos) then we cannot simply merge them, because the nodes would not align. We already have a filter to show the contents of a cc.json. It is ccsh modify -p 1 xyz.cc.json but it is not obvious that "modify" can also print the contents of a cc.json. I make this feature request so the --print-levels parameter is removed from "modify" and moved to a new filter "inspect".

Acceptance criteria

• a new filter exists that can print the levels of a compressed or uncompressed cc.json

Usage suggestion

ccsh inspect xyz.cc.json --> prints the first level of the cc.json
ccsh inspect --level 3 xyz.cc.json --> prints the first three levels of the cc.json. Alternative to --level is --depth

Assumptions & Exclusions

No new features are added here. It is simply about extracting the --print-levels functionality from modify and make it easier to find.

Development notes (optional Task Breakdown)

• [ ]
• [ ]
• [ ]

Open questions