App::Ack - A container for functions for the ack program


Version 1.68


If you want to know about the ack program, see the ack file itself.

No user-serviceable parts inside. ack is all that should use this.



Reads the contents of the .ackrc file and returns the arguments.


Gets command-line arguments and does the Ack-specific tweaking.


Standard filter to pass as a File::Next descend_filter. It returns true if the directory is any of the ones we know we want to skip.

filetypes( $filename )

Returns a list of types that $filename could be. For example, a file foo.pod could be "perl" or "parrot".

The filetype will be undef if we can't determine it. This could be if the file doesn't exist, or it can't be read.

It will be 'skipped' if it's something that ack should always ignore, even under -a.

is_searchable( $filename )

Returns true if the filename is one that we can search, and false if it's one that we should ignore like a coredump or a backup file.

options_sanity_check( %opts )

Checks for sane command-line options. For example, -l doesn't make sense with -C.

build_regex( $str, \%opts )

Returns a regex object based on a string and command-line options.

warn( @_ )

Put out an ack-specific warning.

die( @_ )

Die in an ack-specific way.


Returns a list of all the types that we can detect.


Dumps the help page to the user.


Display the filetypes help subpage.

get_version_statement( $copyright )

Returns the version information for ack.

Prints the version information for ack.

Return the copyright for ack.


Set default colors, load Term::ANSIColor on non Windows platforms


File type filter, filtering based on the wanted file types

open_file( $filename )

Opens the file specified by $filename and returns a filehandle and a flag that says whether it could be binary.

If there's a failure, it throws a warning and returns an empty list.

close_file( $fh, $filename )

Close $fh opened from $filename.

search( $fh, $could_be_binary, $filename, $regex, \%opt )

Main search method

search_and_list( $fh, $filename, $regex, \%opt )

Optimized version of searching for -l and --count, which do not show lines.


Apply the default options


True/False - are the filetypes set?

Prints all the files returned by the iterator matching $regex. If $one is set, stop after the first.


Minor housekeeping before we go matching files.