NAME

tfind - command line file finding utility that understands TPath

VERSION

version 0.001

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.