Metadata-Version: 2.4
Name: entscheidomat-decision-kit
Version: 1.0.0
Summary: The ultimate Python library for decision-making algorithms, spinner wheels, weighted sampling, dice notation, and team generators.
Author-email: Entscheidomat <info@entscheidomat.com>
License: MIT
Project-URL: Homepage, https://entscheidomat.com
Project-URL: Documentation, https://entscheidomat.com
Project-URL: Repository, https://github.com/knuthtimo-lab/decision-kit-py
Project-URL: Glücksrad / Wheel, https://entscheidomat.com/gluecksrad
Project-URL: Münzwurf / Coin Flip, https://entscheidomat.com/muenzwurf
Project-URL: Würfel / Dice Roller, https://entscheidomat.com/wuerfel
Project-URL: Ja/Nein Generator, https://entscheidomat.com/ja-nein-generator
Keywords: decision-maker,random-picker,wheel-of-fortune,spinner-wheel,weighted-random,dice-roller,team-generator,entscheidomat
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

<div align="center">

# 🎲 decision-kit (Python)

**The ultimate zero-dependency Python library for decision-making algorithms, spinner wheels, weighted sampling, dice notation, and team generators.**

[![PyPI version](https://img.shields.io/pypi/v/decision-kit.svg?style=for-the-badge&color=blue)](https://pypi.org/project/decision-kit/)
[![Python versions](https://img.shields.io/pypi/pyversions/decision-kit.svg?style=for-the-badge)](https://pypi.org/project/decision-kit/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![Powered by](https://img.shields.io/badge/Powered%20by-Entscheidomat.com-ec4899?style=for-the-badge)](https://entscheidomat.com)

[Interactive Web Tools](https://entscheidomat.com) • [Documentation](#usage) • [CLI Usage](#cli-tool)

</div>

---

## 🚀 Overview

`decision-kit` provides fast, battle-tested algorithms and data structures to build decision-making applications, tabletop RPG tools, and random selection systems in Python.

Maintained and sponsored by **[Entscheidomat.com](https://entscheidomat.com)** — the free online decision suite.

---

## 🌐 Interactive Web Demos

Try these online decision tools powered by **[Entscheidomat.com](https://entscheidomat.com)**:

- 🎡 **[Glücksrad / Wheel of Fortune](https://entscheidomat.com/gluecksrad)**
- ❓ **[Ja / Nein Generator](https://entscheidomat.com/ja-nein-generator)**
- 🎲 **[3D Würfel Simulator](https://entscheidomat.com/wuerfel)**
- 🪙 **[Münzwurf Simulation](https://entscheidomat.com/muenzwurf)**
- 🎱 **[Magic 8-Ball Orakel](https://entscheidomat.com/magic-8-ball)**
- 🏷️ **[Namen Auslosung & Team Generator](https://entscheidomat.com/namen-auslosung)**
- 🔢 **[Zufallszahl Generator](https://entscheidomat.com/zufallszahl-generator)**

---

## 📦 Installation

```bash
pip install decision-kit
```

---

## 💡 Usage

```python
from decision_kit import AliasMethod, DiceEngine, TeamBalancer, CoinFlipEngine

# 1. Weighted Random Selection (O(1) Alias Algorithm)
items = [
    {"id": "A", "label": "Common Item", "weight": 70},
    {"id": "B", "label": "Rare Item", "weight": 25},
    {"id": "C", "label": "Legendary Item", "weight": 5},
]
alias = AliasMethod(items)
winner = alias.next()
print("Won:", winner["label"])

# 2. Tabletop RPG Dice Parser
roll = DiceEngine.roll("3d6+2")
print(roll["total"], roll["breakdown"])

# 3. Fair Team Generator
teams = TeamBalancer.divide_teams(["Anna", "Ben", "Clara", "Dan"], team_count=2)
print(teams)

# 4. Coin Flip
coin = CoinFlipEngine.flip("de")
print(coin["side"])
```

---

## 🖥️ CLI Tool

```bash
# Pick random winner
decision-kit pick "Pizza" "Sushi" "Burger"

# Roll dice
decision-kit roll 2d6+3

# Flip coin
decision-kit flip
```

---

## 📄 License

MIT © **[Entscheidomat](https://entscheidomat.com)**
