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 /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 ...
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
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.
--all
TPath, TPath::Attributes::Standard, TPath::Forester::File::Attributes. You should be able to obtain this information using either perldoc or man:
perldoc
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 <dfhoughton@gmail.com>
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.
To install App::tfind, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::tfind
CPAN shell
perl -MCPAN -e shell install App::tfind
For more information on module installation, please visit the detailed CPAN module installation guide.