golden-ration-ns 0.1.4

Add your description here

GoldenRatio

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

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

Возможности:

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

---

Установка

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

---

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

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

---

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

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

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

---

Авторы

Яна — [e-mail] https://github.com/Yana5193

Дима — [e-mail] https://github.com/DemiusHTTV