Metadata-Version: 2.4
Name: golden-ration-ns
Version: 0.1.4
Summary: Add your description here
Author-email: Yana <anaermakova948@gmail.com>, Dima <babygreenyoda@yandex.ru>
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: mypy>=2.1.0
Requires-Dist: pytest>=9.1.1
Description-Content-Type: text/markdown

# GoldenRatio

Python-библиотека для точной арифметики в фи-еричной системе счисления (phinary).  
Основание системы — золотое сечение φ = (1+√5)/2 ≈ 1.618...

В отличие от float, все вычисления абсолютно точные — числа хранятся в виде `a + b·√5` через `Fraction`.

**Возможности:**
- Точная арифметика без потери точности (сложение, вычитание, умножение)
- Арифметика напрямую в фи-еричной записи
- Перевод целых чисел в фи-еричную систему счисления
- Вычисление степеней золотого сечения φⁿ для любого n
- Обратный перевод из фи-записи в целое число
- Сравнение чисел (`<`, `<=`, `==`)

---

## Установка

```bash
pip install golden-ratio-ns
# или
uv add golden-ratio-ns
```

---

## Быстрый старт

```python
import goldenratio as gr

a = gr.GoldenNumber(11, 0)
b = gr.GoldenNumber(4, 0)

result = a + b
print(result)          # 15 + 0·√5
print(int(result))     # 15
print(gr.fi_degree(5)) # φ⁵ = 5/2 + 5/2·√5
```

---

## Арифметика в фи-еричной системе

Операции выполняются напрямую над числами в фи-записи — сложение, вычитание и умножение
работают со словарями цифр, результат автоматически нормализуется.

```python
import goldenratio as gr

a = gr.GoldenNumber(11,0)
b = gr.GoldenNumber(15,0)

phi_a = gr.translate_to_fi(a)
phi_b = gr.translate_to_fi(b)

result = phi_a + phi_b
print(int(result))
print(result)
```

---

## API

| Функция | Описание | Пример |
|---|---|---|
| `GoldenNumber(a, b)` | Число вида `a + b·√5` | `GoldenNumber(3, 0)` |
| `normalize(value)` | Нормализация | `normalize(a)` |
| `fi_degree(n)` | Вычислить φⁿ | `fi_degree(5)` |
| `translate_to_fi(a)`|Перевод в систему φ|`translate_to_fi(GoldenNumber(3, 0))`|
---

### Арифметика

| Операция | Пример |
|---|---|
| Сложение | `a + b` |
| Вычитание | `a - b` |
| Умножение | `a * b` |
| Сравнение | `a < b`, `a <= b`, `a == b` |

---

## Авторы

Яна — anaermakova948@gmail.com  https://github.com/Yana5193

Дима — babygreenyoda@yandex.ru  https://github.com/DemiusHTTV