Metadata-Version: 2.4
Name: ttenary
Version: 0.1.0
Summary: Ten-thousandary numeric system — base-10000 number notation with 4-digit grouping
Author: ttenary contributors
License: MIT
Project-URL: Homepage, https://github.com/your-username/ttenary
Project-URL: Source, https://github.com/your-username/ttenary
Keywords: number,base10000,notation,numeric-system
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# ttenary — десятитысячно-единичная система счисления

**TTA (Ten-Thousandary)** — компактная запись больших чисел с группировкой по 4 десятичных разряда. Каждая группа из 4 цифр — один разряд в системе с основанием 10 000.

## Формула

```
TTA(L₁.L₂.L₃:R₁.R₂.R₃) =
  (L₁×10000+R₁) × 100 000 000² +
  (L₂×10000+R₂) × 100 000 000  +
  (L₃×10000+R₃)
```

- `:` разделяет левую и правую половины
- `.` разделяет 4-значные группы внутри половины
- Группы дополняются нулями слева, если их количество не совпадает
- Каждая пара (левый × 10000 + правый) даёт 8-значный разряд

## Примеры

| TTA | Десятичное |
|-----|-----------|
| `0:0005` | 5 |
| `1:0000` | 10 000 |
| `0:0012` | 12 |
| `0.6744.0955:1844.0737.1616` | 2⁶⁴ = 18 446 744 073 709 551 616 |
| `0023.4790.8754:2472.1000.4731` | 2 347 908 754 247 210 004 731 |

## Установка

```bash
pip install ttenary
```

## Использование (Python)

```python
from ttenary import TTA

# Парсинг TTA-строки
n = TTA("0:0005")
print(n.to_int())          # 5

# Форматирование числа в TTA
print(TTA(2**64))          # 0.6744.0955:1844.0737.1616

# Арифметика
a = TTA("0:0003")
b = TTA("0:0007")
print(a + b)               # 0:0010

# Сравнение с int
print(TTA("0:0005") == 5)  # True
print(TTA("1:0000") > 99)  # True

# Большие числа
print(TTA(2**128 - 1))
# 340.6692.4634.4607.6821:2823.0938.6337.4317.1455
```

## Использование (CLI)

```bash
# TTA → десятичное
tta "0:0005"
# → 5

# Десятичное → TTA
tta 10000
# → 1:0000

# 2^64
tta 18446744073709551616
# → 0.6744.0955:1844.0737.1616

# С разбором групп (--explain)
tta --explain "0.6744.0955:1844.0737.1616"
```

## Use-cases

- **Коды и артикулы** — читаемая альтернатива hex-нотации для IMEI, UUID, серийных номеров
- **Большие числа** — наглядная запись 64/128-битных значений без потери точности (нет float)
- **Финтех** — хранение и передача больших десятичных чисел с фиксированной точностью
- **Нотация для документов** — договоры, ИНН, счета с визуальной группировкой

## Совместимость

- Python ≥ 3.10
- Нет зависимостей — только стандартная библиотека

## Лицензия

MIT
