pythagix 0.1.4__tar.gz → 0.1.7__tar.gz

pythagix-0.1.7/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: pythagix
+Version: 0.1.7
+Summary: A mathy Python package with utilities like LCM, triangle numbers, etc.
+Author: UltraQuantumScriptor
+License: MIT
+Keywords: math,prime,LCM,triangle numbers,gcd,utilities
+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 lightweight and dependency-free Python library designed for number theory operations.
+It provides a clean, efficient interface to common mathematical utilities such as prime number checks, greatest common divisor computation, triangular numbers, and more.
+
+---
+
+## 📥 Installation
+
+Install Pythagix using pip:
+
+```bash
+pip install pythagix
+```
+
+---
+
+## Features
+
+* `is_prime(number: int) -> bool`
+  Determine whether a number is a prime number.
+
+* `filter_primes(numbers: List[int]) -> List[int]`
+  Return all prime numbers from a list of integers.
+
+* `nth_prime(position: int) -> int`
+  Retrieve the *n*-th prime number (1-based indexing).
+
+* `gcd(values: List[int]) -> int`
+  Compute the greatest common divisor (GCD) of a list of integers.
+
+* `is_perfect_square(number: int) -> bool`
+  Check whether a number is a perfect square.
+
+* `count_factors(number: int) -> List[int]`
+  Return a sorted list of all positive factors of a number.
+
+* `triangle_number(index: int) -> int`
+  Compute the *n*-th triangular number.
+
+---
+
+## Example Usage
+
+```python
+from pythagix import is_prime, nth_prime, gcd, triangle_number
+
+print(is_prime(13))         # Output: True
+
+print(nth_prime(10))        # Output: 29
+
+print(gcd([12, 18, 24]))    # Output: 6
+
+print(triangle_number(7))   # Output: 28
+```
+
+---
+
+## Use Cases
+
+Pythagix is ideal for:
+
+* Educational platforms and math-related tools
+
+* Prototyping algorithms and number-theoretic computations
+
+* Teaching foundational concepts in discrete mathematics and number theory
+
+* Lightweight CLI utilities and academic scripting
+
+---
+
+## License
+
+Pythagix is released under the [MIT License](LICENSE), making it free to use, modify, and distribute.
+
+---
+
+## Contributing
+
+Contributions are welcome!
+If you'd like to add features, report bugs, or improve documentation, please open an issue or submit a pull request on the [GitHub repository](https://github.com/your-username/pythagix).
+
+---
+
+If you want me to tailor this even more (e.g. add badges, GitHub Actions, versioning, or PyPI metadata snippets), I can assist with that too.

pythagix-0.1.7/README.md

@@ -0,0 +1,88 @@
+---
+
+# 📦 Pythagix
+
+**Pythagix** is a lightweight and dependency-free Python library designed for number theory operations.
+It provides a clean, efficient interface to common mathematical utilities such as prime number checks, greatest common divisor computation, triangular numbers, and more.
+
+---
+
+## 📥 Installation
+
+Install Pythagix using pip:
+
+```bash
+pip install pythagix
+```
+
+---
+
+## Features
+
+* `is_prime(number: int) -> bool`
+  Determine whether a number is a prime number.
+
+* `filter_primes(numbers: List[int]) -> List[int]`
+  Return all prime numbers from a list of integers.
+
+* `nth_prime(position: int) -> int`
+  Retrieve the *n*-th prime number (1-based indexing).
+
+* `gcd(values: List[int]) -> int`
+  Compute the greatest common divisor (GCD) of a list of integers.
+
+* `is_perfect_square(number: int) -> bool`
+  Check whether a number is a perfect square.
+
+* `count_factors(number: int) -> List[int]`
+  Return a sorted list of all positive factors of a number.
+
+* `triangle_number(index: int) -> int`
+  Compute the *n*-th triangular number.
+
+---
+
+## Example Usage
+
+```python
+from pythagix import is_prime, nth_prime, gcd, triangle_number
+
+print(is_prime(13))         # Output: True
+
+print(nth_prime(10))        # Output: 29
+
+print(gcd([12, 18, 24]))    # Output: 6
+
+print(triangle_number(7))   # Output: 28
+```
+
+---
+
+## Use Cases
+
+Pythagix is ideal for:
+
+* Educational platforms and math-related tools
+
+* Prototyping algorithms and number-theoretic computations
+
+* Teaching foundational concepts in discrete mathematics and number theory
+
+* Lightweight CLI utilities and academic scripting
+
+---
+
+## License
+
+Pythagix is released under the [MIT License](LICENSE), making it free to use, modify, and distribute.
+
+---
+
+## Contributing
+
+Contributions are welcome!
+If you'd like to add features, report bugs, or improve documentation, please open an issue or submit a pull request on the [GitHub repository](https://github.com/your-username/pythagix).
+
+---
+
+If you want me to tailor this even more (e.g. add badges, GitHub Actions, versioning, or PyPI metadata snippets), I can assist with that too.

{pythagix-0.1.4 → pythagix-0.1.7}/pyproject.toml

@@ -1,10 +1,6 @@
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
 [project]
 name = "pythagix"
-version = "0.1.4"
+version = "0.1.7"
 description = "A mathy Python package with utilities like LCM, triangle numbers, etc."
 readme = "README.md"
 requires-python = ">=3.6"
@@ -17,3 +13,4 @@ classifiers = [
     "License :: OSI Approved :: MIT License"
 ]
 dependencies = []
+keywords = ["math", "prime", "LCM", "triangle numbers", "gcd", "utilities"]

{pythagix-0.1.4 → pythagix-0.1.7}/pythagix/__init__.py

@@ -1,6 +1,6 @@
 # pythagix/__init__.py
 from .core import (
-    prime_list,
+    filter_primes,
     is_prime,
     nth_prime,
     gcd,

pythagix-0.1.7/pythagix/core.py

@@ -0,0 +1,160 @@
+from math import isqrt
+from functools import reduce
+from typing import List
+import math
+
+__all__ = [
+    "is_prime",
+    "filter_primes",
+    "nth_prime",
+    "gcd",
+    "is_perfect_square",
+    "count_factors",
+    "triangle_number",
+]
+
+
+def is_prime(number: int) -> bool:
+    """
+    Check whether a given integer is a prime number.
+
+    Args:
+        number (int): The number to check.
+
+    Returns:
+        bool: True if number is prime, False otherwise.
+    """
+    if number <= 1:
+        return False
+    if number == 2:
+        return True
+    if number % 2 == 0:
+        return False
+    for i in range(3, isqrt(number) + 1, 2):
+        if number % i == 0:
+            return False
+    return True
+
+
+def filter_primes(values: List[int]) -> List[int]:
+    """
+    Filter and return the prime numbers from a list.
+
+    Args:
+        values (List[int]): A list of integers.
+
+    Returns:
+        List[int]: A list containing only the prime numbers.
+    """
+    return [num for num in values if is_prime(num)]
+
+
+def nth_prime(position: int) -> int:
+    """
+    Get the N-th prime number (1-based index).
+
+    Args:
+        position (int): The index (1-based) of the prime number to find.
+
+    Returns:
+        int: The N-th prime number.
+
+    Raises:
+        ValueError: If position < 1.
+    """
+    if position < 1:
+        raise ValueError("Position must be >= 1")
+
+    count = 0
+    candidate = 2
+    while True:
+        if is_prime(candidate):
+            count += 1
+            if count == position:
+                return candidate
+        candidate += 1
+
+
+def gcd(values: List[int]) -> int:
+    """
+    Compute the greatest common divisor (GCD) of a list of integers.
+
+    Args:
+        values (List[int]): A list of integers.
+
+    Returns:
+        int: The GCD of the numbers.
+
+    Raises:
+        ValueError: If the list is empty.
+    """
+    if not values:
+        raise ValueError("Input list must not be empty")
+    return reduce(math.gcd, values)
+
+
+def is_perfect_square(number: int) -> bool:
+    """
+    Check whether a number is a perfect square.
+
+    Args:
+        number (int): The number to check.
+
+    Returns:
+        bool: True if the number is a perfect square, False otherwise.
+    """
+    if number < 0:
+        return False
+    root = isqrt(number)
+    return root * root == number
+
+
+def count_factors(number: int) -> List[int]:
+    """
+    Return all positive factors of a number.
+
+    Args:
+        number (int): The number whose factors are to be found.
+
+    Returns:
+        List[int]: A sorted list of factors.
+
+    Raises:
+        ValueError: If number is not positive.
+    """
+    if number <= 0:
+        raise ValueError("Number must be positive")
+
+    factors = set()
+    for i in range(1, isqrt(number) + 1):
+        if number % i == 0:
+            factors.add(i)
+            factors.add(number // i)
+    return sorted(factors)
+
+
+def triangle_number(index: int) -> int:
+    """
+    Calculate the N-th triangular number.
+
+    Args:
+        index (int): The position (starting from 0) in the triangular number sequence.
+
+    Returns:
+        int: The N-th triangular number.
+
+    Raises:
+        ValueError: If index is negative.
+    """
+    if index < 0:
+        raise ValueError("Index must be >= 0")
+    return index * (index + 1) // 2
+
+
+def main() -> None:
+    """Tester Function."""
+    ...
+
+
+if __name__ == "__main__":
+    main()

pythagix-0.1.7/pythagix.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: pythagix
+Version: 0.1.7
+Summary: A mathy Python package with utilities like LCM, triangle numbers, etc.
+Author: UltraQuantumScriptor
+License: MIT
+Keywords: math,prime,LCM,triangle numbers,gcd,utilities
+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 lightweight and dependency-free Python library designed for number theory operations.
+It provides a clean, efficient interface to common mathematical utilities such as prime number checks, greatest common divisor computation, triangular numbers, and more.
+
+---
+
+## 📥 Installation
+
+Install Pythagix using pip:
+
+```bash
+pip install pythagix
+```
+
+---
+
+## Features
+
+* `is_prime(number: int) -> bool`
+  Determine whether a number is a prime number.
+
+* `filter_primes(numbers: List[int]) -> List[int]`
+  Return all prime numbers from a list of integers.
+
+* `nth_prime(position: int) -> int`
+  Retrieve the *n*-th prime number (1-based indexing).
+
+* `gcd(values: List[int]) -> int`
+  Compute the greatest common divisor (GCD) of a list of integers.
+
+* `is_perfect_square(number: int) -> bool`
+  Check whether a number is a perfect square.
+
+* `count_factors(number: int) -> List[int]`
+  Return a sorted list of all positive factors of a number.
+
+* `triangle_number(index: int) -> int`
+  Compute the *n*-th triangular number.
+
+---
+
+## Example Usage
+
+```python
+from pythagix import is_prime, nth_prime, gcd, triangle_number
+
+print(is_prime(13))         # Output: True
+
+print(nth_prime(10))        # Output: 29
+
+print(gcd([12, 18, 24]))    # Output: 6
+
+print(triangle_number(7))   # Output: 28
+```
+
+---
+
+## Use Cases
+
+Pythagix is ideal for:
+
+* Educational platforms and math-related tools
+
+* Prototyping algorithms and number-theoretic computations
+
+* Teaching foundational concepts in discrete mathematics and number theory
+
+* Lightweight CLI utilities and academic scripting
+
+---
+
+## License
+
+Pythagix is released under the [MIT License](LICENSE), making it free to use, modify, and distribute.
+
+---
+
+## Contributing
+
+Contributions are welcome!
+If you'd like to add features, report bugs, or improve documentation, please open an issue or submit a pull request on the [GitHub repository](https://github.com/your-username/pythagix).
+
+---
+
+If you want me to tailor this even more (e.g. add badges, GitHub Actions, versioning, or PyPI metadata snippets), I can assist with that too.

{pythagix-0.1.4 → pythagix-0.1.7}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="pythagix",
-    version="0.1.4",
+    version="0.1.7",
     author="UltraQuantumScriptor",
     description="A mathy Python package with utilities like LCM, triangle numbers, etc.",
     long_description=long_description,

pythagix-0.1.4/PKG-INFO

@@ -1,56 +0,0 @@
-Metadata-Version: 2.4
-Name: pythagix
-Version: 0.1.4
-Summary: A mathy Python package with utilities like LCM, triangle numbers, etc.
-Author: UltraQuantumScriptor
-License: MIT
-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
-
-Math utilities for number nerds.  
-Check primes, compute triangle numbers, find GCDs — all in one lightweight package.  
-Because math shouldn't be a pain 🧮✨
-
----
-
-## 📦 Installation
-
-```bash
-pip install pythagix
-```
-
-⚙️ Features
-
-🔢 is_prime(number) — Check if a number is prime
-
-📜 prime_list([list]) — Return all primes in a list
-
-🔎 nth_prime(n) — Get the n-th prime number
-
-🤝 gcd([list]) — Greatest common divisor of a list
-
-📏 is_perfect_square(n) — Check if n is a perfect square
-
-🧱 count_factors(n) — Get all factors of a number
-
-🔺 triangle_number(n) — Get the n-th triangle number
-
-🧪 Examples
-```python
-from pythagix import is_prime, nth_prime, gcd, triangle_number
-
-print(is_prime(13))        # True
-print(nth_prime(10))       # 29
-print(gcd([12, 18, 24]))   # 6
-print(triangle_number(7))  # 28
-```
-
-📚 Why?
-pythagix was built to give math students, coders, and tinkerers a fast and fun way to explore number theory in Python. No heavy dependencies. Just pure mathy goodness.

pythagix-0.1.4/README.md

@@ -1,42 +0,0 @@
-# 🧠 pythagix
-
-Math utilities for number nerds.  
-Check primes, compute triangle numbers, find GCDs — all in one lightweight package.  
-Because math shouldn't be a pain 🧮✨
-
----
-
-## 📦 Installation
-
-```bash
-pip install pythagix
-```
-
-⚙️ Features
-
-🔢 is_prime(number) — Check if a number is prime
-
-📜 prime_list([list]) — Return all primes in a list
-
-🔎 nth_prime(n) — Get the n-th prime number
-
-🤝 gcd([list]) — Greatest common divisor of a list
-
-📏 is_perfect_square(n) — Check if n is a perfect square
-
-🧱 count_factors(n) — Get all factors of a number
-
-🔺 triangle_number(n) — Get the n-th triangle number
-
-🧪 Examples
-```python
-from pythagix import is_prime, nth_prime, gcd, triangle_number
-
-print(is_prime(13))        # True
-print(nth_prime(10))       # 29
-print(gcd([12, 18, 24]))   # 6
-print(triangle_number(7))  # 28
-```
-
-📚 Why?
-pythagix was built to give math students, coders, and tinkerers a fast and fun way to explore number theory in Python. No heavy dependencies. Just pure mathy goodness.

pythagix-0.1.4/pythagix/core.py

@@ -1,144 +0,0 @@
-def filter_prime(number_list: list[int]) -> list[int]:
-    """
-    Returns a list of all prime numbers from a given list.
-
-    Args:
-        number_list (list[int]): The list of integers to check.
-
-    Returns:
-        list[int]: A list containing only the prime numbers from the input.
-    """
-    prime_number: list[int] = []
-    for x in number_list:
-        if x == 1:
-            continue
-        for y in range(2, int(x * 1 / 2 + 1)):
-            if x % y == 0:
-                break
-        else:
-            prime_number.append(x)
-    return prime_number
-
-
-def is_prime(number: int) -> bool:
-    """
-    Checks whether a number is a prime number.
-
-    Args:
-        number (int): The number to check.
-
-    Returns:
-        bool: True if the number is prime, False otherwise.
-    """
-    for y in range(2, int(number * 1 / 2)):
-        if number % y == 0:
-            return False
-    else:
-        return True
-
-
-def nth_prime(index: int) -> int:
-    """
-    Returns the n-th prime number (1-indexed).
-
-    Args:
-        index (int): The position of the prime to find.
-
-    Returns:
-        int: The n-th prime number.
-
-    Raises:
-        ValueError: If index is less than 1.
-    """
-    if index < 1:
-        raise ValueError("Index must be >= 1")
-
-    count: int = 0
-    prime_number: int = 2
-    while True:
-        if is_prime(prime_number):
-            count += 1
-            if count == index:
-                return prime_number
-        prime_number += 1
-
-
-def gcd(number_list: list[int]) -> int:
-    """
-    Returns the greatest common divisor (GCD) of a list of integers.
-
-    Args:
-        number_list (list[int]): The list of integers.
-
-    Returns:
-        int: The greatest number that divides all elements in the list.
-    """
-    num: int = 2
-    highest: int = 0
-    while num <= min(number_list):
-        for number in number_list:
-            if number % num != 0:
-                break
-        else:
-            highest = num
-        num += 1
-    return highest
-
-
-def is_perfect_square(number: int) -> bool:
-    """
-    Checks whether a number is a perfect square.
-
-    Args:
-        number (int): The number to check.
-
-    Returns:
-        bool: True if the number is a perfect square, False otherwise.
-    """
-    num: int = 0
-    while num <= number:
-        if num**2 == number:
-            return True
-        num += 1
-    return False
-
-
-def count_factors(number: int) -> list[int]:
-    """
-    Returns a list of all factors (divisors) of a number.
-
-    Args:
-        number (int): The number to find factors of.
-
-    Returns:
-        list[int]: A list of all positive integers that divide the number evenly.
-    """
-    num: int = 1
-    factors: list[int] = []
-    while num <= number:
-        if number % num == 0:
-            factors.append(num)
-        num += 1
-    return factors
-
-
-def triangle_number(number: int) -> int:
-    """
-    Returns the n-th triangle number.
-
-    Args:
-        number (int): The term (n) of the triangle number sequence.
-
-    Returns:
-        int: The n-th triangle number, calculated as n(n+1)//2.
-    """
-    return number * (number + 1) // 2
-
-
-if __name__ == "__main__":
-
-    def main():
-        """Runs a quick test of any function."""
-        print(triangle_number(10))
-
-    main()

pythagix-0.1.4/pythagix.egg-info/PKG-INFO

@@ -1,56 +0,0 @@
-Metadata-Version: 2.4
-Name: pythagix
-Version: 0.1.4
-Summary: A mathy Python package with utilities like LCM, triangle numbers, etc.
-Author: UltraQuantumScriptor
-License: MIT
-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
-
-Math utilities for number nerds.  
-Check primes, compute triangle numbers, find GCDs — all in one lightweight package.  
-Because math shouldn't be a pain 🧮✨
-
----
-
-## 📦 Installation
-
-```bash
-pip install pythagix
-```
-
-⚙️ Features
-
-🔢 is_prime(number) — Check if a number is prime
-
-📜 prime_list([list]) — Return all primes in a list
-
-🔎 nth_prime(n) — Get the n-th prime number
-
-🤝 gcd([list]) — Greatest common divisor of a list
-
-📏 is_perfect_square(n) — Check if n is a perfect square
-
-🧱 count_factors(n) — Get all factors of a number
-
-🔺 triangle_number(n) — Get the n-th triangle number
-
-🧪 Examples
-```python
-from pythagix import is_prime, nth_prime, gcd, triangle_number
-
-print(is_prime(13))        # True
-print(nth_prime(10))       # 29
-print(gcd([12, 18, 24]))   # 6
-print(triangle_number(7))  # 28
-```
-
-📚 Why?
-pythagix was built to give math students, coders, and tinkerers a fast and fun way to explore number theory in Python. No heavy dependencies. Just pure mathy goodness.