Metadata-Version: 2.4
Name: finnbar
Version: 0.1.0
Summary: FINNBAR – a TUI for checking IKEA product availability in your local store, straight from your terminal.
License: MIT
License-File: LICENSE
Author: fabieu
Author-email: 43068791+fabieu@users.noreply.github.com
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: textual (>=8.0.0,<9.0.0)
Description-Content-Type: text/markdown

# FINNBAR

**FINNBAR** – a TUI for checking IKEA product availability in your local store, straight from your terminal.

Built with [Textual](https://github.com/Textualize/textual) and powered by
the [ikea-availability-checker](https://github.com/Ephigenia/ikea-availability-checker) data.

## Features

- 🏪 **Browse stores** – list all IKEA stores for any supported country (40+ countries, 400+ stores)
- 📦 **Check stock** – look up real-time availability for one or more product IDs across all stores in a country
- ⌨️ **Keyboard-driven** – full keyboard navigation with shortcut bindings shown in the footer

## Requirements

- Python 3.11+
- [Poetry](https://python-poetry.org/) package manager

## Installation

```bash
# Clone the repository
git clone https://github.com/fabieu/FINNBAR.git
cd FINNBAR

# Install dependencies and the runnable script
poetry install
```

## Usage

```bash
# Launch the TUI
poetry run finnbar
```

| Keyboard shortcut | Action                                    |
|-------------------|-------------------------------------------|
| `Ctrl+S`          | Search stores for the selected country    |
| `Ctrl+K`          | Check stock for the entered product ID(s) |
| `Ctrl+X`          | Clear results                             |
| `Ctrl+Q`          | Quit                                      |

### Checking stock

1. Select a **country** from the dropdown
2. Enter one or more **product IDs** in the input field (comma-separated, e.g. `40299687, S69022537`)
3. Press **Check Stock** or `Ctrl+K`

### Browsing stores

1. Select a **country** from the dropdown
2. Press **Search Stores** or `Ctrl+S`

