fex 0.2.1

# fex

A universal interactive package search TUI.

![screenshot](./screenshot.png)

## Supported Providers

- **apk** - Alpine Linux
- **apt** - Debian/Ubuntu
- **brew** - Homebrew (macOS/Linux)
- **dnf** - Fedora/RHEL
- **nix** - Nix/NixOS
- **pacman** - Arch Linux (official repos)
- **paru** - Arch AUR helper (official repos + AUR)
- **xbps** - Void Linux
- **yay** - Arch AUR helper (official repos + AUR)
- **zypper** - openSUSE

> On some systems the first search may be slow if the package manager cache needs updating.

## Installation

Install `rust` following official instructions [here](https://rust-lang.org/tools/install/).

Then simply run:

```bash
cargo install fex
```

## Building

With `cargo`:

```bash
cargo build --release
```

The binary ends up at `target/release/fex`.

## Usage

```bash
fex                 # Auto-detect best available provider
fex -p pacman       # Use a specific provider
fex -l              # List available providers
fex -h              # Show help
```

## Controls

| Key | Action |
|-----|--------|
| Type | Search for packages |
| Up / Down | Navigate results |
| PgUp / PgDn | Navigate by page |
| Home / End | Jump to first / last result |
| Enter | Install selected package |
| Escape | Clear search |
| Ctrl+X | Quit |

## Testing with Docker

Install Docker (example for Arch):

```bash
sudo pacman -S docker
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
newgrp docker  # or logout/login
```

Then run a distro container with `fex` already built:

```bash
./testing/test.sh alpine    # Alpine (apk)
./testing/test.sh arch      # Arch Linux (pacman, yay)
./testing/test.sh fedora    # Fedora (dnf)
./testing/test.sh homebrew  # Linuxbrew (brew)
./testing/test.sh nixos     # NixOS (nix)
./testing/test.sh opensuse  # openSUSE (zypper)
./testing/test.sh ubuntu    # Ubuntu (apt)
./testing/test.sh void      # Void Linux (xbps)
```

Podman works as a drop-in replacement — the script detects it automatically.

## Adding a New Provider

1. Create `src/providers/yourprovider.rs` and implement the `Provider` trait:
   - `name()` — provider name string
   - `is_available()` — check if the tool exists (`command_exists("tool")`)
   - `search(query)` — run the search command and return a `SearchResult`
   - `install_command(pkg)` — return the install command string
   - Optionally override `source_color(source)` for colored source badges
2. Declare the module in `src/providers/mod.rs` and add it to `create_provider()`, `auto_detect_provider()`, and `get_available_providers()`

## Inspiration

Based on my prior work on the C++26 version of this [paclook](https://github.com/krisfur/paclook).