Skip to main content

Python implementation of GNU Findutils

Project description


Findtools is a pythonic implementation of file search routines inspired by GNU Findutils.

from findtools.find_files import (find_files, Match)

# Recursively find all *.sh files in **/usr/bin**
sh_files_pattern = Match(filetype='f', name='*.sh')
found_files = find_files(path='/usr/bin', match=sh_files_pattern)

for found_file in found_files:

The above is equivalent to

find /usr/bin -type f -name '*.sh'


You can install this library by via pip:

pip install findtools


Alternatively you can clone this git repository. Then if you are using pyenv or miniconda as your local development setup

git clone findtools && cd findtools pip install -e .

This will symlink you local copy and help you testign the package locally.


You can run tests yourself with built-in unittest lib:

cd tests && python

or with pytest:

cd tests && pytest

Package has been tested on python3.8+ and python2.7+.

Upgrade to latest with pip install findtools==1.1.0

Please report issues if this breaks for you.

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

findtools-1.1.0.tar.gz (4.5 kB view hashes)

Uploaded source

Built Distributions

findtools-1.1.0-py3.8.egg (8.5 kB view hashes)

Uploaded 3 8

findtools-1.1.0-py2.7.egg (8.3 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page