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:


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

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.

Files for findtools, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size findtools-1.1.0-py2.7.egg (8.3 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size findtools-1.1.0-py3.8.egg (8.5 kB) File type Egg Python version 3.8 Upload date Hashes View
Filename, size findtools-1.1.0.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page