This tool is a port of Debian's apt-file to ALT.
It is in active development so constructive feedback is always welcome.

Notable differences (compared to Debian variant):
* As a consequence of ALT having a simpler content index format:
 * More efficient
 * Gives info on directories and not only other files
 * Supports user-provided regular expressions
* Does not (yet?) integrate with ALT's apt, but we're looking into it

# Notes on APT integration

Currently this apt-file does not use nor set any APT config variables, and in no way does it alter any APT config files.
ALT's apt, unlike Debian's, does not download contents_index to disk by default. At the time of writing this, there is no known way to ask ALT's apt to provide contents_index (to download a matching version of it to disk). 
Debian's apt-file is tightly integrated with their version of APT:
* it stores its configuration through APT config variables and a custom file in /etc/apt/apt.conf.d/
* it sets APT up to download the contents index and store it locally through /usr/lib/apt/apt-helper (missing in ALT)
 * as a result, Debian's apt-file does not need to figure out currently active repositories in the system
 * as a result, it also does not need to handle external non-Debian (non-ALT in our case) repositories (custom site-local repos, tasks, ...) and does not need to manage mirrors by itself.
So for now it's unclear if we want to reuse APT (or any existing) functionality or to NIH-reimplement all that here once again.


# TODO
* A test suite
* APT integration
 * Automatically get information 
 * What is more efficient: rsyncing contents or asking APT to provide them?
* Debian feature parity
 * `show' subcommand to dump package contents (like `rpm -ql`, but no need to fetch the package)
 * `--arch=ARCH' or `-a ARCH' to get info on a different architecture
 * a possibility to query different branches (in Debian: --filter-suites)
 * a possibility to query different origins (in Debian: --filter-origins)
 * `-l' to only show package names
 * `-i' for case insensitivity
 * `-D' (or `-p' ?) to take search patterns from RPM package list
 * `-f' or `--from-file=FILE' to take a list of LF-separated patterns from a file, '-' for stdin