algebraic-range 0.8.0__tar.gz

algebraic_range-0.8.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniele Gregori
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

algebraic_range-0.8.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: algebraic-range
+Version: 0.8.0
+Summary: Generate ranges of algebraic numbers — a Python port of the Wolfram Language AlgebraicRange resource function.
+Author-email: Daniele Gregori <dangregori@gmail.com>
+Maintainer-email: Daniele Gregori <dangregori@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Daniele-Gregori/PyPI-packages/tree/main/packages/algebraic-range
+Project-URL: Documentation, https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/
+Project-URL: Repository, https://github.com/Daniele-Gregori/PyPI-packages/tree/main/packages/algebraic-range
+Project-URL: Issues, https://github.com/Daniele-Gregori/PyPI-packages/issues
+Keywords: algebra,algebraic-numbers,range,roots,symbolic-computation,number-theory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sympy>=1.12
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# algebraic-range
+
+
+[![Tests](https://github.com/Daniele-Gregori/PyPI-packages/actions/workflows/algebraic-range.yml/badge.svg)](https://github.com/Daniele-Gregori/PyPI-packages/actions/workflows/algebraic-range.yml)
+[![PyPI version](https://img.shields.io/pypi/v/algebraic-range.svg)](https://pypi.org/project/algebraic-range/)
+[![Python](https://img.shields.io/pypi/pyversions/algebraic-range.svg)](https://pypi.org/project/algebraic-range/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Generate ranges of algebraic numbers.
+
+Python port of the **Wolfram** [resource function "AlgebraicRange"](https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/) resource function.
+
+Requires [SymPy](https://www.sympy.org/) ≥ 1.12.
+
+## Overview
+
+`algebraic_range` creates ranges made of [algebraic numbers](https://en.wikipedia.org/wiki/Algebraic_number). This extends the basic concept of `range()` to include, besides rational numbers, also roots — always restricted to the real domain.
+
+The first two arguments represent the bounds of the range (minimum and maximum values), while the optional third and fourth arguments (by default equal to 1 and 0) regulate the upper and lower bounds of the steps (differences between successive elements).
+
+
+
+## Usage
+
+```python
+algebraic_range(x)                # Sqrt[Range[1, x²]]  for x ≥ 1
+algebraic_range(x, y)             # Sqrt[Range[x², y²]]  for 0 ≤ x ≤ y
+algebraic_range(x, y, s)          # step upper bound s,  0 < s ≤ y
+algebraic_range(x, y, s, d)       # step lower bound d,  0 ≤ d ≤ s
+```
+
+### Parameters
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `r1` | *(required)* | Start of range (or single argument) |
+| `r2` | `None` | End of range |
+| `s` | `None` | Step upper bound (negative → descending) |
+| `d` | `0` | Step lower bound |
+| `root_order` | `2` | `int r` → orders 2..r; `[r]` → only order r; `[r1,r2,…]` → listed orders |
+| `step_method` | `"Outer"` | `"Outer"` or `"Root"` |
+| `farey_range` | `False` | Use Farey-sequence–based rational multipliers |
+| `formula_complexity_threshold` | `inf` | Discard elements above this complexity |
+| `algebraics_only` | `True` | Reject transcendental inputs |
+
+### Options
+
+#### `root_order`
+
+```python
+# Include square and cubic roots
+algebraic_range(2, root_order=3)
+
+# Only cubic roots
+algebraic_range(2, root_order=[3])
+
+# Cubic and fifth roots
+algebraic_range(1, Rational(3, 2), root_order=[3, 5])
+```
+
+#### `step_method`
+
+```python
+# "Root" method: Sqrt[Range[x², y², s²]]
+algebraic_range(0, 3, Rational(1, 3), step_method="Root")
+```
+
+The default `"Outer"` method uses the outer product construction. The `"Root"` method is generally a superset.
+
+#### `farey_range`
+
+```python
+algebraic_range(0, 3, Rational(1, 3), farey_range=True)
+```
+
+Generalises `FareyRange` by combining algebraic ranges over all Farey-sequence steps.
+
+#### `formula_complexity_threshold`
+
+```python
+# Only keep simple expressions
+algebraic_range(4, root_order=4, formula_complexity_threshold=8)
+```
+
+#### `algebraics_only`
+
+```python
+from sympy import sqrt, E
+
+# This raises NotAlgebraicError:
+# algebraic_range(0, 5, sqrt(E))
+
+# Allow transcendental step:
+algebraic_range(0, 5, sqrt(E), algebraics_only=False)
+```
+
+## Properties
+
+- **Extends `range()`**: `set(range(x, y+1))` ⊆ `set(algebraic_range(x, y))`
+- **Negative reflection**: `algebraic_range(-y, -x)` = `list(reversed([-v for v in algebraic_range(x, y)]))`
+- **All outputs are algebraic** (when `algebraics_only=True`) and real
+- **Sorted** in ascending order (or descending for negative step)
+- **No duplicates**
+
+
+## See also
+
+More details and examples can be found in the documentation for the original Wolfram Language resource function [`AlgebraicRange`](https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/), contributed by the same author and vetted by the Wolfram Review Team. 
+

algebraic_range-0.8.0/README.md

@@ -0,0 +1,109 @@
+# algebraic-range
+
+
+[![Tests](https://github.com/Daniele-Gregori/PyPI-packages/actions/workflows/algebraic-range.yml/badge.svg)](https://github.com/Daniele-Gregori/PyPI-packages/actions/workflows/algebraic-range.yml)
+[![PyPI version](https://img.shields.io/pypi/v/algebraic-range.svg)](https://pypi.org/project/algebraic-range/)
+[![Python](https://img.shields.io/pypi/pyversions/algebraic-range.svg)](https://pypi.org/project/algebraic-range/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Generate ranges of algebraic numbers.
+
+Python port of the **Wolfram** [resource function "AlgebraicRange"](https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/) resource function.
+
+Requires [SymPy](https://www.sympy.org/) ≥ 1.12.
+
+## Overview
+
+`algebraic_range` creates ranges made of [algebraic numbers](https://en.wikipedia.org/wiki/Algebraic_number). This extends the basic concept of `range()` to include, besides rational numbers, also roots — always restricted to the real domain.
+
+The first two arguments represent the bounds of the range (minimum and maximum values), while the optional third and fourth arguments (by default equal to 1 and 0) regulate the upper and lower bounds of the steps (differences between successive elements).
+
+
+
+## Usage
+
+```python
+algebraic_range(x)                # Sqrt[Range[1, x²]]  for x ≥ 1
+algebraic_range(x, y)             # Sqrt[Range[x², y²]]  for 0 ≤ x ≤ y
+algebraic_range(x, y, s)          # step upper bound s,  0 < s ≤ y
+algebraic_range(x, y, s, d)       # step lower bound d,  0 ≤ d ≤ s
+```
+
+### Parameters
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `r1` | *(required)* | Start of range (or single argument) |
+| `r2` | `None` | End of range |
+| `s` | `None` | Step upper bound (negative → descending) |
+| `d` | `0` | Step lower bound |
+| `root_order` | `2` | `int r` → orders 2..r; `[r]` → only order r; `[r1,r2,…]` → listed orders |
+| `step_method` | `"Outer"` | `"Outer"` or `"Root"` |
+| `farey_range` | `False` | Use Farey-sequence–based rational multipliers |
+| `formula_complexity_threshold` | `inf` | Discard elements above this complexity |
+| `algebraics_only` | `True` | Reject transcendental inputs |
+
+### Options
+
+#### `root_order`
+
+```python
+# Include square and cubic roots
+algebraic_range(2, root_order=3)
+
+# Only cubic roots
+algebraic_range(2, root_order=[3])
+
+# Cubic and fifth roots
+algebraic_range(1, Rational(3, 2), root_order=[3, 5])
+```
+
+#### `step_method`
+
+```python
+# "Root" method: Sqrt[Range[x², y², s²]]
+algebraic_range(0, 3, Rational(1, 3), step_method="Root")
+```
+
+The default `"Outer"` method uses the outer product construction. The `"Root"` method is generally a superset.
+
+#### `farey_range`
+
+```python
+algebraic_range(0, 3, Rational(1, 3), farey_range=True)
+```
+
+Generalises `FareyRange` by combining algebraic ranges over all Farey-sequence steps.
+
+#### `formula_complexity_threshold`
+
+```python
+# Only keep simple expressions
+algebraic_range(4, root_order=4, formula_complexity_threshold=8)
+```
+
+#### `algebraics_only`
+
+```python
+from sympy import sqrt, E
+
+# This raises NotAlgebraicError:
+# algebraic_range(0, 5, sqrt(E))
+
+# Allow transcendental step:
+algebraic_range(0, 5, sqrt(E), algebraics_only=False)
+```
+
+## Properties
+
+- **Extends `range()`**: `set(range(x, y+1))` ⊆ `set(algebraic_range(x, y))`
+- **Negative reflection**: `algebraic_range(-y, -x)` = `list(reversed([-v for v in algebraic_range(x, y)]))`
+- **All outputs are algebraic** (when `algebraics_only=True`) and real
+- **Sorted** in ascending order (or descending for negative step)
+- **No duplicates**
+
+
+## See also
+
+More details and examples can be found in the documentation for the original Wolfram Language resource function [`AlgebraicRange`](https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/), contributed by the same author and vetted by the Wolfram Review Team. 
+

algebraic_range-0.8.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "algebraic-range"
+version = "0.8.0"
+description = "Generate ranges of algebraic numbers — a Python port of the Wolfram Language AlgebraicRange resource function."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Daniele Gregori", email = "dangregori@gmail.com" },
+]
+maintainers = [
+    { name = "Daniele Gregori", email = "dangregori@gmail.com" },
+]
+keywords = [
+    "algebra",
+    "algebraic-numbers",
+    "range",
+    "roots",
+    "symbolic-computation",
+    "number-theory",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Education",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Mathematics",
+]
+dependencies = [
+    "sympy>=1.12",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Daniele-Gregori/PyPI-packages/tree/main/packages/algebraic-range"
+Documentation = "https://resources.wolframcloud.com/FunctionRepository/resources/AlgebraicRange/"
+Repository = "https://github.com/Daniele-Gregori/PyPI-packages/tree/main/packages/algebraic-range"
+Issues = "https://github.com/Daniele-Gregori/PyPI-packages/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

algebraic_range-0.8.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

algebraic_range-0.8.0/src/algebraic_range/__init__.py

@@ -0,0 +1,24 @@
+"""
+algebraic-range — Generate ranges of algebraic numbers.
+
+A Python port of the Wolfram Language ResourceFunction ``AlgebraicRange``.
+"""
+
+from algebraic_range.core import (
+    algebraic_range,
+    formula_complexity,
+    AlgebraicRangeError,
+    NotRealError,
+    NotAlgebraicError,
+    StepBoundError,
+    __version__,
+)
+
+__all__ = [
+    "algebraic_range",
+    "formula_complexity",
+    "AlgebraicRangeError",
+    "NotRealError",
+    "NotAlgebraicError",
+    "StepBoundError",
+]