Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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

Project description

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

Apache V2


pip install storage_stats


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
 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 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:


For example:


Note the period in each extension.

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


Released under Apache version 2.0 license.


  1. Fork the GitHub project
  2. Change the code and push into the forked project
  3. Submit a pull request

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for storage_stats, version 0.4.1
Filename, size File type Python version Upload date Hashes
Filename, size storage_stats-0.4.1-py2-none-any.whl (15.0 kB) File type Wheel Python version py2 Upload date Hashes View hashes
Filename, size (10.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page