NAME

tfind - command line file finding utility that understands TPath

VERSION

version 0.002

SYNOPSIS

  > tfind //@f[@uid = @me]       # all the current user's files in the current directory
  /home/fred/this.txt
  /home/fred/that.php
  /home/fred/the/other/file.c
  ...
  > tfind //~\.txt$~             # all files with the .txt extension
  /home/fred/this.txt
  /home/fred/yon/glorious/file.txt
  ...
  > tfind //@bin                 # all binary files
  /home/fred/java.class
  /home/fred/c.o
  /home/fred/and/another/c.o
  ...
  > tfind //@bin foo bar baz     # all binary files in the foo, bar, and baz directories
  /home/fred/foo/java.class
  /home/fred/bar/c.o
  /home/fred/baz/parrot.pbc
  ...
  > tfind //Some/Perl/Module.pm         # Some::Perl::Module
  /home/fred/perl5/lib/Some/Perl/Module.pm
  > tfind --perl //Some/Perl/Module.pm  # Some::Perl::Module in ~ or @INC
  /usr/lib/perl5/Some/Perl/Module.pm
  /home/fred/perl5/lib/Some/Perl/Module.pm
  > tfind --help                 # usage info
  ...

DESCRIPTION

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.

SEE ALSO

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.

AUTHOR

David F. Houghton <dfhoughton@gmail.com>

COPYRIGHT AND LICENSE

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.