Color Of Code

SizeReporter generates a CSV/TSV/XML report of the disk usage:

• CSV: Comma separated values (";")
• TSV: Tab separated values
• XML: XML format

It runs from the console and can be triggered by scheduled jobs or be run by scripts. It does not make any GUI call (no pop-ups, no dialogs) so it can also be run safely by services or continuous integration systems (CI) like CruiseControl for example.

The CSV file can be read by MS excel directly or imported into Open office calc for example to process the results and create reports or diagrams.

The executable only has two parameters: the directory to parse (may be a network path) and the depth of reporting.

During a run, the tool displays the current state in the console and reports the current directory being parsed as well as intermediate results.

After running, the tool generates at least two files:

• sizereport_errors_20100414-193146.log
• sizereport_result_20100414-193146.csv or .xml
  

Example of output:

Depth    Files    Dirs    Virtual   Size on   Last modification     Relative Path
                          size (MB) disk (MB)   

3        9        0       1,091     1,113    2005-05-17 21:27:01    .\$hf_mig$\KB898461\update

2        12       1       1,326     1,355    2005-05-17 21:27:01    .\$hf_mig$\KB898461

It currently reports following items:

• level: the directory level from the root of parsing (level 0 is the directory that was given as a parameter on the command line)
• file count: The number of files in the directory and all sub-directories
• directory count: The number of directories and sub-directories inside the directory excluding the directory itself)
• virtual size (MB): the sum of the size of each file in the sub-tree
• size on disk (MB): the sum of bytes occupied on disk. Due to cluster rounding and eventual file compression, this often differs from the virtual size.
• last modification date: the date of the last modification in the sub-tree
• path: the path of the sub-tree, relatively to the path given as an argument

Help

There is an integrated help that is displayed on the command line by typing:

SizeReporter --help

The options get listed. The main options are

--culture        specify the culture to use for floats e.g. "en-US"
--empty          also report all empty files in an extra report
--tsv            create a Tab Separated Values file instead of a CSV
--xml            generate an XML report
--quiet          do not display anything on the console
--junctions      also follow and report space consumed in a junction

The "culture" is interesting if you have a computer in a different locale to generate the report and to process the results. For example you generate the reports on a German machine and want to process the results on a machine with English locale. Then specify "en-US" to generate the report to get the floating point numbers right. You can also import the files into Calc or Excel and specify the format but that is more work than double clicking on the CSV...

Release Notes

• 2010-06-11, Version 1.0.4: Added --xml and --empty flags
• 2010-04-26, Version 1.0.3: Fixed the --version and --help flags
• 2010-04-19, Version 1.0.2: Added option to set culture, tsv option and start/end time and duration report
• 2010-04-16, Version 1.0.1: Fixed directory modification time reporting, added option to include junction parsing
• 2010-04-14, Version 1.0.0: First official release after heavy testing.

Special remarks:

Installation

The tool does not come with an installer, just download the zip and unpack it where you like and tun the executable.

• Download SizeReporter-1.0.4.zip [14KB, 2010-06-11] and unpack it
• Make sure you have the prerequisities installed (see below)
• Run SizeReporter.exe from the command line

Prerequisities

• Windows XP, Vista, 7 or later
• Microsoft .NET Framework http://www.microsoft.com/downloads/details.aspx?...