storage_stats 0.4.1

Calculates count and average file size of files recorded by file extension

Calculates statistics about minimum, maximum and mean average file sizes for each file extension within a directory.

Intallation

pip install storage_stats

Documentation

Usage: storage_stats [-h] [-e MAPFILE] [-o OUTPUT] [--no-aggregation] [--no-recursion] [--no-timing] [-s] [-v] path [path ...]

Calculates file size statistics for the specified folder(s).

positional arguments:

path(s) the folder(s) to characterise

optional arguments:

-h, --help

Show the help message and exit

-e MAPFILE

User file overriding similar extension mappings

-o OUTPUT

CSV file to output statistics too

--no-aggregation

Do not aggregate results from all specified paths together

--no-recursion

Do not include sub-folders in stats

--no-timing

Turn off preprocessing of directory to improve run-time (no timing information provided)

-s, --silent

Turn off command line output (useful if you just want to output a CSV file)

-v, --version

Provide the version of this application

If multiple folders are specified, the results are aggregated together, unless the –no-aggregation flag is used. If –no-aggregation is specified along with the -o (output csv file) flag, then one csv file will be created per input folder (by appending a “-<index>” onto the end of the specified file name, e.g. stats-1.csv, stats-2.csv, etc.

MAPFILE

MAPFILE should be a text file with one group of similar file extensions per line, separated by commas. Each line should be in lowercase and take the form:

.main_ext,.alt1,.alt2,etc

For example:

.jpeg,.jpg
.tiff,.tif

Note the period in each extension.

The first extension listed will be the one referenced in the output.

Licence

Released under Apache version 2.0 license.

Contribute

1. Fork the GitHub project

2. Change the code and push into the forked project

3. Submit a pull request