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.