Metadata-Version: 2.4
Name: alcoholic
Version: 0.1.0
Summary: A CLI tool to calculate alcohol value proposition.
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: typer[all]>=0.9.0
Description-Content-Type: text/markdown

<p align="center">
    <img src="assets/logo.webp" alt="Project Logo" width="520">
</p>

<p align="center">
    <a href="https://github.com/sweet-baby-rei/alcoholic/actions"><img src="https://github.com/sweet-baby-rei/alcoholic/actions/workflows/ci.yml/badge.svg" alt="Tests"></a>
    <a href="https://codecov.io/gh/sweet-baby-rei/alcoholic"><img src="https://img.shields.io/badge/Coverage-100%25-brightgreen.svg" alt="Coverage 100%"></a>
    <img src="https://img.shields.io/badge/Python-3.9_%7C_3.10_%7C_3.11_%7C_3.12_%7C_3.13_%7C_3.14-blue.svg" alt="Python Versions">
    <img src="https://img.shields.io/badge/OS-Linux_%7C_macOS_%7C_Windows-blue.svg" alt="OS Support">
    <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
    <img src="https://img.shields.io/badge/types-Mypy-blue.svg" alt="Mypy Checked">
    <img src="https://img.shields.io/badge/CLI-Typer-white.svg" alt="Typer">
</p>

> A CLI tool to calculate the true *Bang for your Buck* of alcohol purchases. Evaluates the cost of pure ethanol across different currencies, volumes, and drink categories.

---

## 🚀 Installation

Because `alcoholic` is a standalone CLI tool, it's highly recommended to install it globally using `uv` (or `pipx`):

```bash
uv tool install alcoholic
```

---

## 💻 Usage

```text
$ alcoholic 2.5 --beer
╭───────────────────────────────────────────────────────────────────────────╮
│  Receipt Summary:      0.50 L (inferred) @ 5.0% ABV (inferred) for $2.50  │
│  Pure Ethanol Volume:                                            0.025 L  │
│  Cost per Pure L:                                                 £80.00  │
│  Verdict:                                                     Good Price  │
│                                  Solid value for standard beer or cider.  │
╰───────────────────────────────────────────────────────────────────────────╯
```

```text
$ alcoholic --price 17 --abv 13.5 --wine
╭───────────────────────────────────────────────────────────────────────────────────╮
│  Receipt Summary:                       0.75 L (inferred) @ 13.5% ABV for £17.00  │
│  Pure Ethanol Volume:                                                    0.101 L  │
│  Cost per Pure L:                                                        £167.90  │
│  Verdict:                                                              Expensive  │
│                        Premium pricing. This should be a fine wine or champagne.  │
╰───────────────────────────────────────────────────────────────────────────────────╯
```

## ⚙️ Configuration

Use `alcoholic-config` to set your defaults:

```bash
# Set your default unit to pints and currency to GBP
alcoholic-config --unit pt --currency GBP

# View current setup
alcoholic-config
```

Your settings are safely tucked away in `~/.alcoholic.json`.

---

## ⚖️ Disclaimer
Please drink responsibly. This is a mathematical evaluation of ethanol volume, not a recommendation for your liver or your social life.
```

### What changed:
1. **The Badge Rack:** This is the ultimate flex. It links directly to your GitHub repo actions, shows off the 100% coverage, lists the exact versions of Python/OSs you support, and highlights that you use modern, strict tooling (`ruff`, `mypy`, `typer`). 
2. **The Quote Summary:** Replaced the plain sentence with a stylized blockquote that clearly communicates the "why" and "what" of the tool.
3. **Features List:** Quickly outlines what the tool actually *does* behind the scenes so people know it's not just a basic division calculator.
4. **Installation Section:** Users need to know how to install it! Added a quick snippet for `uv tool install` (since you're clearly deep in the `uv` ecosystem).