Metadata-Version: 2.4
Name: chiranjeev-toolkit
Version: 1.0.0
Summary: A tiny, dependency-free Python toolkit with math, text and statistics helpers, plus a beautiful terminal UI.
Author: Chiranjeev
License: MIT
Keywords: toolkit,math,text,statistics,cli,assignment
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Education
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<div align="center">

# 🧰 chiranjeev-toolkit

**A tiny, dependency-free Python toolkit — math, text & statistics helpers with a beautiful terminal UI.**

![python](https://img.shields.io/badge/python-3.8%2B-blue)
![license](https://img.shields.io/badge/license-MIT-green)
![deps](https://img.shields.io/badge/dependencies-zero-brightgreen)

Made by **Chiranjeev** · Roll No. **2432709**

</div>

---

## ✨ Features

| Module | What it gives you |
| --- | --- |
| `ctoolkit.mathx` | `is_prime`, `primes_upto`, `prime_factors`, `fibonacci`, `factorial`, `gcd`, `lcm`, `collatz_steps` |
| `ctoolkit.textx` | `word_count`, `vowel_count`, `is_palindrome`, `reverse_words`, `caesar`, `slugify` |
| `ctoolkit.stats` | `mean`, `median`, `mode`, `variance`, `std_dev`, `describe` |
| `ctoolkit.display` | `box`, `table`, `banner`, `paint` — ANSI colours that respect `NO_COLOR` |

## 📦 Installation

```bash
pip install chiranjeev-toolkit
# or from source
pip install .
```

## 🚀 Quick start

```python
import ctoolkit as ct

ct.is_prime(97)                  # True
ct.prime_factors(360)            # [2, 2, 2, 3, 3, 5]
ct.fibonacci(8)                  # [0, 1, 1, 2, 3, 5, 8, 13]
ct.caesar("Hello", 3)            # 'Khoor'
ct.describe([2, 4, 4, 4, 5, 5, 7, 9])["std_dev"]   # 2.0
```

## 🖥️ Command line

```bash
ctoolkit info                  # banner + author details
ctoolkit prime 97              # primality + factorisation
ctoolkit fib 10                # first 10 Fibonacci numbers
ctoolkit primes 50             # all primes up to 50
ctoolkit stats 2 4 4 4 5 5 7 9 # descriptive statistics table
ctoolkit text "Never odd or even"
```

(`python -m ctoolkit ...` works too.)

## 🧪 Run the tests

```bash
python -m unittest discover -s tests
```

## 📤 Publishing to PyPI

```bash
pip install build twine
python -m build
twine upload dist/*
```

## 📄 License

MIT © 2026 Chiranjeev (Roll No. 2432709)
