Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/beyondgrep/ack3

ack is a grep-like search tool optimized for source code.
https://github.com/beyondgrep/ack3

ack cli grep perl

Last synced: 6 days ago
JSON representation

ack is a grep-like search tool optimized for source code.

Awesome Lists containing this project

README

        

# ack 3

ack is a code-searching tool, similar to grep but optimized for
programmers searching large trees of source code. It is highly
portable and runs on any platform that runs Perl.

ack is written and maintained by Andy Lester ([email protected]).

* [Project home page](https://beyondgrep.com/)
* [Code home page](https://github.com/beyondgrep/ack3)
* [Issue tracker](https://github.com/beyondgrep/ack3/issues)
* Mailing lists
* [ack-announce](https://groups.google.com/d/forum/ack-announce), announcements-only
* [ack-users](https://groups.google.com/d/forum/ack-users), for users of ack
* [ack-dev](https://groups.google.com/d/forum/ack-dev), for ack development
* [Build status ![Build Status](https://github.com/beyondgrep/ack3/workflows/testsuite/badge.svg?branch=dev)](https://github.com/beyondgrep/ack3/actions?query=workflow%3Atestsuite+branch%3Adev)
* [CPAN Testers](https://cpantesters.org/distro/A/ack.html)

# Building

ack requires Perl 5.10.1 or higher, and it requires the
[File::Next](https://metacpan.org/pod/File::Next) module to be installed.

## Checking prerequisites

To check ack's dependencies, run this command in the shell:

perl -MFile::Next -E'say "ack is ready to build!"'

If everything is OK, you'll see:

ack is ready to build!

If your installation of Perl is outdated, you'll see an error like this:

Unrecognized switch: -Esay "ack is ready to build!" (-h will show valid options).

If you don't have File::Next installed, you'll see an error like this:

Can't locate File/Next.pm in @INC (@INC contains: /home/andy/...
BEGIN failed--compilation aborted.

and you'll need to install File::Next yourself:

# Install File::Next dependency
perl -MCPAN -e install File::Next

## Building ack

If you've got a recent enough version of Perl and you have File::Next
installed, you can build ack.

# Required
perl Makefile.PL
make
make test
sudo make install # For a system-wide installation
# - or -
make ack-standalone
cp ack-standalone ~/bin/ack3 # For a personal installation

# Development

* [How to contribute](CONTRIBUTING.md)
* [Developer's Guide](DEVELOPERS.md)
* [Design Guide](DESIGN.md)

# Community

See the [Community](https://beyondgrep.com/community/) page.

Please follow the [Code of Conduct](CODE_OF_CONDUCT.md) in all your interactions with our project.

# License

Copyright 2005-2023 Andy Lester.

This program is free software; you can redistribute it and/or modify
it under the terms of the
[Artistic License v2.0](https://www.perlfoundation.org/artistic_license_2_0).
See also the LICENSE.md file that comes with the ack distribution.

# Support

[ack](https://github.com/beyondgrep/ack3) and [beyondgrep.com](https://beyondgrep.com) are supported by [DigitalOcean](https://m.do.co/c/6a437192f552).