Metadata-Version: 2.2
Name: tenkn
Version: 1.0.0
Summary: 10KN: Unicode Hangul-based 10,000-radix numeral system.
Home-page: https://github.com/dzbuit/10KN
Author: blueradiance
Author-email: none@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# 10KN · Hangul-Based Unicode Numeral System
Created by **blueradiance**

**10KN** is a 10,000-radix numeral system based on Korean Hangul characters (U+AC00 to U+D7A3).
It enables ultra-compact, reversible integer encoding using only readable, sortable Unicode characters.

---

## 🔢 Features

- Uses Hangul characters: `'가'` (U+AC00) to `'힣'` (U+D7A3)
- Encodes integers with base-10,000 compression
- Lexicographically sortable
- Reversible with no loss
- Perfect for file names, compact identifiers, or tagging systems

---

## 🚀 Quick Start

```bash
pip install tenkn
```

```python
from tenkn import encode_10kn, decode_10kn

encoded = encode_10kn(123456789)
print(encoded)  # e.g., '각삳엉'

decoded = decode_10kn(encoded)
print(decoded)  # 123456789
```

---

## 📦 Encoding Logic

- `0 → '가'`
- `1 → '각'`
- ...
- `9999 → '힣'`

Each digit is a Hangul character in base-10,000, compressed and reversible.

---

## 📜 License

Custom license. Free to use with attribution. No unauthorized modification or redistribution without credit.

---

## 📅 Version

First release: 2025.04.12  
Author: **blueradiance**
