tfind - command line file finding utility that understands TPath


version 0.001


  > tfind //@f[@uid = @me]       # all the current user's files in the current directory
  > tfind //~\.txt$~             # all files with the .txt extension
  > tfind //@bin                 # all binary files
  > tfind //@bin foo bar baz     # all binary files in the foo, bar, and baz directories
  > tfind //Some/Perl/         # Some::Perl::Module
  > tfind --perl //Some/Perl/  # Some::Perl::Module in ~ or @INC
  > tfind --help                 # usage info


The tfind utility applies TPath expressions to directory hierarchies to find files. It expects a TPath expression and zero or more directories (or files). If no directory is supplied, it uses the current directory. It's options are minimal. For option details, type

  tfind --help

Most information will be supplied via the expression, not options.

Unless the --all flag is specified, files and directories whose name begins with a dot will be ignored.


TPath, TPath::Attributes::Standard, TPath::Forester::File::Attributes. You should be able to obtain this information using either perldoc or man:

  man TPath
  perldoc TPath::Attributes::Standard

The first of these, TPath, will describe the syntax of tpath expressions. The second two will list the attributes available for expressions understood by tfind.


David F. Houghton <>


This software is copyright (c) 2013 by David F. Houghton.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.