golden-ration-ns 0.1.3

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 = PhiBase.from_golden_number(GoldenNumber(Fraction(10), Fraction(0)))
b = PhiBase.from_golden_number(GoldenNumber(Fraction(3), Fraction(0)))

print(a)            # фи-запись числа 10
print(b)            # фи-запись числа 3

result_add = a + b
result_sub = a - b
result_mul = a * b

---

API

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

---

Арифметика

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

---

Авторы

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

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