Metadata-Version: 2.4
Name: k-temp_convert
Version: 0.1.0
Summary: A simple CLI temperature converter (C, F, K)
Author-email: Kamalesh <you@example.com>
License-Expression: MIT
Keywords: temperature,converter,celsius,fahrenheit,kelvin,cli
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# k-temp_convert 🌡️

A simple, fast, and user-friendly CLI tool and Python package to convert temperatures between Celsius (°C), Fahrenheit (°F), and Kelvin (K).

---

## 📦 Installation

### From PyPI (once published):
```bash
pip install k-temp_convert
```

### From Source (Local Development):
```bash
git clone https://github.com/yourusername/k-temp_convert.git
cd k-temp_convert
pip install .
```

---

## 🚀 CLI Usage

After installation, the CLI tool is available via `k-temp_convert`, `k-temp-convert`, or `tempconvert`:

```bash
k-temp_convert <value> <from_unit> <to_unit>
```

### Examples

```bash
# Celsius to Fahrenheit
k-temp_convert 100 C F
# Output:   100.0° C  →  212.0° F

# Fahrenheit to Celsius
k-temp_convert 32 F C
# Output:   32.0° F  →  0.0° C

# Celsius to Kelvin
k-temp_convert 0 C K
# Output:   0.0° C  →  273.15° K

# Kelvin to Celsius
k-temp_convert 300 K C
# Output:   300.0° K  →  26.85° C

# Fahrenheit to Kelvin
k-temp_convert 98.6 F K
# Output:   98.6° F  →  310.15° K
```

---

## 🐍 Python API Usage

You can also import and use `k_temp_convert` inside your Python applications:

```python
from k_temp_convert import convert, celsius_to_fahrenheit, fahrenheit_to_celsius

# Using the generic convert function
result = convert(100, "C", "F")
print(result)  # 212.0

# Using direct helper functions
f = celsius_to_fahrenheit(25)
print(f)       # 77.0
```

---

## 🔁 Conversion Formulas

| From | To | Formula |
|:---:|:---:|:---|
| **C** | **F** | `(C × 9/5) + 32` |
| **F** | **C** | `(F − 32) × 5/9` |
| **C** | **K** | `C + 273.15` |
| **K** | **C** | `K − 273.15` |
| **F** | **K** | `(F − 32) × 5/9 + 273.15` |
| **K** | **F** | `((K − 273.15) × 9/5) + 32` |

---

## 🛠️ Development & Publishing

### 1. Install Build Tools
```bash
pip install build twine
```

### 2. Build the Package
```bash
python -m build
```
This generates `.whl` and `.tar.gz` distribution files inside the `dist/` directory.

### 3. Upload to PyPI
```bash
twine upload dist/*
```

---

## 📄 License

This project is licensed under the [MIT License](LICENSE).
