Futilities/human/ff

From Woozle Writes Code
< Futilities‎ | human
Revision as of 16:42, 20 October 2022 by Woozle (talk | contribs) (→‎Options: automatically-built table, yay)
Jump to navigation Jump to search
FF: File Finder

About

Yes, I know, there's find and grep but I find those both opaque and difficult to use.

Options

This list is in revision.

name
standardlongshortmeaning
ff--case-sensitive -cs case must match (I think this is just filenames for now, but might also be content...)
ff--file-date= -fd= only include files created or edited on the given date
ff--list-matches -lm log matching files (same suboptions as -lf)
ff--show-commands -sc show any external commands used
spider--list-found=<params>-lf=<params> list all items found according to the rules in <params>, which is formatted like "<name>=<value>:<name>=<value>":
  • i=<what to include>: fi (file), fo (folder), or both
  • f=<filespec for output>
  • s: show on screen
base--config-file=<config spec>-cf=<config spec>name of config file to load instead of the default
base--show-progress-spupdate a line on the screen to show current activity

old list

options
long short meaning
--case-sensitive -cs case must match (I think this is just filenames for now, but might also be content...)
--file-date= -fd= only include files created or edited on the given date
--list-found -lf list all items as they are checked - fi for files, fo for folders, combine in either order for both
--log-matches -lm log found matches to a file
--show-commands -sc show any external commands used
--show-progress -sp display search progress on a single line (faster and less overwhelming)

Examples

Find all files in the Downloads folder which were created or edited on August 26, 2022:

./ff -fd:2022-08-26 -sp "/home/woozle/Downloads/*.*"

Note that the quotes are necessary in order to prevent bash from automatically unglobbing the "*.*" into a list of filenames.