Skip to main content

Fast File Count: Recursively count files and directories very quickly

Project description

Fast File Count in Python

build PyPI version Python package downloads

This is a Python package to quickly count the number of files and directories in a given path. Optionally you can count recursively and include hidden files in the total.

This package is a wrapper around fast-file-count by Christopher Schultz . Credit for the initial version belongs to Christopher Schultz, I wrote the Python wrapper, converted the Windows code to use builtin functionality, and packaged it up. See the file src/c_count.c for the other contributors and see the commit history of this package on GitHub for my exact changes.


Installation can be done easily with pip:

$ pip install ffcount


There is a command line application called ffcount, which recursively counts files and directories:

$ ffcount

See ffcount -h for options.

The package can also be used as a Python library, using the ffcount function. This function returns a tuple (number_of_files, number_of_dirs) and it can be used as follows:

>>> from ffcount import ffcount

# count everything under the current path
>>> ffcount()
(521013, 43012)

# count without hidden files
>>> ffcount(hidden=False)
(234012, 12082)

# use a different path
>>> ffcount('/tmp')
(81, 10)

Note that ffcount counts links as files, even if they point to a directory. In some cases, this explains the discrepancy with other ways of counting.

To obtain the full function documentation, simply run:

>>> import ffcount
>>> help(ffcount)


The original C code by Christopher Schultz was licensed under the Apache License 2.0. This package is therefore licensed under this license as well.

Project details

Download files

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

Source Distribution

ffcount-0.2.1.tar.gz (35.8 kB view hashes)

Uploaded source

Built Distributions

ffcount-0.2.1-cp310-cp310-win_amd64.whl (21.8 kB view hashes)

Uploaded cp310

ffcount-0.2.1-cp310-cp310-win32.whl (20.2 kB view hashes)

Uploaded cp310

ffcount-0.2.1-cp39-cp39-win_amd64.whl (21.8 kB view hashes)

Uploaded cp39

ffcount-0.2.1-cp39-cp39-win32.whl (20.2 kB view hashes)

Uploaded cp39

ffcount-0.2.1-cp38-cp38-win_amd64.whl (21.8 kB view hashes)

Uploaded cp38

ffcount-0.2.1-cp38-cp38-win32.whl (20.2 kB view hashes)

Uploaded cp38

ffcount-0.2.1-cp37-cp37m-win_amd64.whl (21.7 kB view hashes)

Uploaded cp37

ffcount-0.2.1-cp37-cp37m-win32.whl (20.0 kB view hashes)

Uploaded cp37

ffcount-0.2.1-cp36-cp36m-win_amd64.whl (21.6 kB view hashes)

Uploaded cp36

ffcount-0.2.1-cp36-cp36m-win32.whl (19.9 kB view hashes)

Uploaded cp36

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page