semvec/pypi-packages huggingface dataset:
destiny-matrix-calculator 0.1.1
Destiny Matrix personal calculation engine (points, purposes, chartHeart, years).
License: MIT
Requires Python: >=3.8

# Destiny Matrix Calculator (Python)

A lightweight Python package that reproduces the Destiny Matrix **personal** calculation logic
(points, purposes, chartHeart, years) used on https://destiny-matrix.cc/.

## Install

```bash
pip install destiny-matrix-calculator
```

## Usage

```python
from destiny_matrix_calculator import calculate_from_birthdate

result = calculate_from_birthdate(day=23, month=1, year=1990)
print(result["points"]["apoint"])
print(result["purposes"]["perspurpose"])
```

## API

- `reduce_number(number: int) -> int`
- `calculate_year(year: int) -> int`
- `calculate_points(apoint: int, bpoint: int, cpoint: int) -> dict`
- `calculate_from_birthdate(day: int, month: int, year: int) -> dict`

## Notes

- The reduction rule is applied **once** when a number is greater than 22,
  matching the front-end logic exactly.
- Input date validation is not enforced; callers should supply valid dates.

## Homepage

https://destiny-matrix.cc/id/