zoek - find files and directories

zoek (Dutch for "search") is a Python library and command-line utility aiming to duplicate and extend the functionality of the find command-line utility.

Installation

pip can be used to install zoek:

pip install zoek

However, we recommend to install zoek using pipx:

pipx install zoek

Usage

zoek can be used as a command-line utility as follows:

pyfind <dir>

zoek currently supports the following flags:

• --depth or -d to indicate the depth of directories and files to return (default: 1):

pyfind <dir> -d <int>

• --startswith or -s to return files and directories starting with the provided string:

pyfind <dir> -s <str>

• --contains or -c to return files and directories that contain the provided string:

pyfind <dir> -c <str>

• --minsize or -m to filter output on size, a positive int returns files equal or larger, a negative int returns files smaller than input:

pyfind <dir> -m <int>

• --datecreated or -dc to filter output on time created, a positive int returns files created more than int minutes ago, a negative int return files less than int minutes ago:

pyfind <dir> -dc <int>

• --datemodified or -dm similar to --datecreated, but then for filtering date modified:

pyfind <dir> -dc <int>

As filters stack, multiple flags can be used simultaneously.

Contributing

Please refer to CONTRIBUTING.md

License

BSD-3