Metadata-Version: 2.4
Name: pythagix
Version: 0.2.23
Summary: Pythagix is a lightweight Python library that provides a collection of mathematical utility functions for number theory
Author: UltraQuantumScriptor
License: MIT
Project-URL: Homepage, https://github.com/UltraQuantumScriptor/pythagix
Project-URL: Source, https://github.com/UltraQuantumScriptor/pythagix
Project-URL: Bug Tracker, https://github.com/UltraQuantumScriptor/pythagix/issues
Keywords: math,prime,LCM,triangle numbers,gcd,statistics,utilities,high-digit math
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file
Dynamic: requires-python

# Pythagix


Pythagix is a **high-performance, battle-tested Python library** for number theory and statistics. 
It delivers **blazing-fast, reliable, and precise implementations** of essential mathematical utilities, including prime checking, GCD/LCM, ratio simplification, triangular numbers, and more. 
Designed for developers, students, and researchers alike, Pythagix makes handling **massive numbers, complex computations, and advanced math operations** simple, efficient, and hassle-free.

Source code: https://github.com/UltraQuantumScriptor/pythagix


## Features

Primes & Factorization: is_prime, nth_prime, prime_factorization, prime_factors

GCD / LCM / Ratios: gcd, lcm, simplify_ratio, is_equivalent

Statistics: mean, median, mode, variance, pvariance, std_dev, pstd_dev

Other utilities: triangle_number, compress_0, product, nCr, get_factors

Each function is fully tested and designed for high performance with arbitrarily large integers.


## Installation

```bash
pip install pythagix
```


## Usage

```python
from pythagix import gcd, is_prime, nth_prime

# Compute GCD of large numbers
print(gcd([12345678901234567890, 98765432109876543210]))

# Check if a number is prime
print(is_prime(101))  # True

# Get the 1000th prime number
print(nth_prime(1000))
```


## Testing

Pythagix uses pytest for automated testing. To run the test suite:

```bash
pytest
```

All core functionality is verified for correctness and performance across large inputs.


## Contributing

Contributions are welcome. To report bugs, suggest improvements, or submit code enhancements:

### Open an issue on GitHub

Submit a pull request

Refer to the repository’s CONTRIBUTING.md for detailed guidelines.


## License

Pythagix is licensed under the MIT License.
