Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.


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
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
storage_stats-0.4.1-py2-none-any.whl (15.0 kB) Copy SHA256 Checksum SHA256 py2 Wheel May 22, 2016 (10.6 kB) Copy SHA256 Checksum SHA256 Source May 22, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting