Metadata-Version: 2.4
Name: calctool_cli
Version: 0.1.0
Summary: Calculations tool
License-File: LICENSE.txt
Author: Becool
Requires-Python: >=3.14
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: inquirer (>=3.4.1,<4.0.0)
Requires-Dist: pyfiglet (>=1.0.4,<2.0.0)
Description-Content-Type: text/markdown

# 🧮 Calctool CLI

A feature-rich command-line calculator built with Python. Navigate through tools using intuitive arrow-key menus — no mouse needed.

---

## ✨ Features

| Tool | Description |
|------|-------------|
| **Basic Calculator** | Add, subtract, multiply, and divide two numbers |
| **Power & Square Root** | Raise numbers to a power or calculate their square root |
| **Percentage Calculator** | Convert a percentage to its decimal value |
| **Fraction Calculator** | Divide a numerator by a denominator |
| **Random Number** | Generate a random number between a min and max |
| **Number Compare** | Compare two numbers to see which is larger |

---

## 📦 Installation

Make sure you have Python 3 installed, then run:

```bash
pip install calctool_cli
```

---

## 🚀 Usage

After installation, launch the app from any terminal with:

```bash
calctool
```

You'll be greeted with the main menu:

```
 ██████╗ █████╗ ██╗      ██████╗████████╗ ██████╗  ██████╗ ██╗
██╔════╝██╔══██╗██║     ██╔════╝╚══██╔══╝██╔═══██╗██╔═══██╗██║
██║     ███████║██║     ██║        ██║   ██║   ██║██║   ██║██║
╚██████╗██║  ██║███████╗╚██████╗   ██║   ╚██████╔╝╚██████╔╝███████╗
 ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝   ╚═╝    ╚═════╝  ╚═════╝ ╚══════╝

[?] Choose a tool: (Navigate with arrow keys, enter to submit.):
❯ Basic Calculator (1)
  Pow and sqrt (2)
  Percentage calculator (3)
  Fraction calculator (4)
  Random numb (5)
  Number compare (6)
  Quit
```

Use the **↑ ↓ arrow keys** to navigate and **Enter** to select.

---

## 🛠️ Tool Guide

### 1. Basic Calculator
Select an operator (`+`, `-`, `*`, `/`), then enter two numbers. The result is printed instantly.

### 2. Power & Square Root
Choose between:
- **Pow** — enter a base number and an exponent
- **Sqrt** — enter a number to find its square root

### 3. Percentage Calculator
Enter a percentage value (without the `%` sign) and get its decimal equivalent.  
Example: `25` → `0.25`

### 4. Fraction Calculator
Enter a numerator and a denominator to calculate the fraction's value.  
Example: `3 / 4` → `0.75`

### 5. Random Number
Enter a minimum and maximum value to generate a random integer in that range.

### 6. Number Compare
Enter two numbers to find out which one is greater, or if they're equal.

---

## 🔁 Navigation

After every operation you'll see three options:

- **Again** — repeat the current tool
- **Back** — return to the main menu
- **Quit** — exit the application

---

## 📋 Requirements

- Python **3.7+**
- [`pyfiglet`](https://pypi.org/project/pyfiglet/)
- [`colorama`](https://pypi.org/project/colorama/)
- [`inquirer`](https://pypi.org/project/inquirer/)

These are installed automatically when you use `pip install calctool_cli`.

---

## 🙏 Credits

| Role | Name |
|------|------|
| Developer | <!-- Becool --> |
| Helper | <!-- v011dz  --> |

---

## 📄 License

License — Look at LICENSE.txt in the package files.
