polyany 0.3.0__tar.gz

polyany-0.3.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

polyany-0.3.0/.github/labeler.yml

@@ -0,0 +1,39 @@
+bug:
+  - head-branch:
+      - "^fix"
+
+CI:
+  - changed-files:
+      - any-glob-to-any-file:
+          - .github/**
+          - .pre-commit-config.yaml
+  - head-branch:
+      - "^ci"
+      - "^pre-commit-ci"
+
+dependencies:
+  - changed-files:
+      - any-glob-to-any-file:
+          - uv.lock
+  - head-branch:
+      - "^build(deps)"
+
+documentation:
+  - changed-files:
+      - any-glob-to-any-file:
+          - docs/**
+          - mkdocs.yml
+          - readme.md
+  - head-branch:
+      - "^docs"
+
+enhancement:
+  - head-branch:
+      - "^feat"
+
+tests:
+  - changed-files:
+      - any-glob-to-any-file:
+          - tests/**
+  - head-branch:
+      - "^test"

polyany-0.3.0/.github/pull_request_template.md

@@ -0,0 +1,19 @@
+# 📄 Description
+
+Implements the `foo` method to support XYZ functionality. Also adds corresponding tests, documentation, and some minor refactors.
+
+Related issue: #123
+
+# 🎯 Objectives
+
+1. Implement the `foo` method
+2. Ensure full test coverage
+3. Document the new method
+4. Refactor existing code
+
+# ✅ Tasks
+
+- [ ] Implementation
+- [ ] Tests
+- [ ] Documentation
+- [ ] Refactoring

polyany-0.3.0/.github/workflows/bumpversion.yml

@@ -0,0 +1,37 @@
+name: Bump and Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  bump-version:
+    if: "!startsWith(github.event.head_commit.message, 'bump:')"
+    runs-on: ubuntu-latest
+    name: "Bump version and create changelog with commitizen"
+    steps:
+      - name: Check out
+        uses: actions/checkout@v4
+        with:
+          token: "${{ secrets.PERSONAL_ACCESS_TOKEN }}"
+          fetch-depth: 0
+      - name: Create bump and changelog
+        uses: commitizen-tools/commitizen-action@master
+        with:
+          github_token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+          changelog_increment_filename: body.md
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - name: Build
+        run: uv build
+      - name: Release
+        uses: softprops/action-gh-release@605f567f95cfaf9465d68c7dbf509f374691fb12
+        with:
+          body_path: "body.md"
+          tag_name: ${{ env.REVISION }}
+          files: |
+            dist/*.tar.gz
+            dist/*.whl
+          overwrite_files: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

polyany-0.3.0/.github/workflows/docs.yml

@@ -0,0 +1,32 @@
+name: Documentation
+on:
+  push:
+    branches: [main]
+    paths:
+      - src/**
+      - docs/**
+      - mkdocs.yml
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.7.17"
+          python-version: "3.13"
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: uv sync --only-group docs
+      - run: uv run mkdocs gh-deploy --force

polyany-0.3.0/.github/workflows/pr_label.yml

@@ -0,0 +1,15 @@
+name: "Pull Request Labeler"
+on:
+  pull_request_target:
+    types: [opened, synchronize]
+
+jobs:
+  labeler:
+    permissions:
+      contents: read
+      pull-requests: write
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/labeler@v5
+        with:
+          sync-labels: true

polyany-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,25 @@
+name: Upload Python Package
+
+on:
+  push:
+    tags:
+      - "*"
+
+jobs:
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi_release
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - name: Smoke test (wheel)
+        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test.py
+      - name: Smoke test (source distribution)
+        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test.py
+      - name: Publish
+        run: uv publish --trusted-publishing always

polyany-0.3.0/.github/workflows/tests.yml

@@ -0,0 +1,53 @@
+name: Tests and Coverage
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  changes:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    # Set job outputs to values from filter step
+    outputs:
+      code: ${{ steps.filter.outputs.code }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            code:
+              - 'src/**'
+              - 'tests/**'
+  test:
+    needs: changes
+    if: ${{ needs.changes.outputs.code == 'true' }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: "0.7.17"
+          python-version: ${{ matrix.python-version }}
+
+      - name: Test with Python ${{ matrix.python-version }}
+        run: uv run --frozen pytest --doctest-modules --cov=src --cov-branch --cov-report=xml
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

polyany-0.3.0/.gitignore

@@ -0,0 +1,235 @@
+# Created by https://www.toptal.com/developers/gitignore/api/windows,linux,visualstudiocode,python
+# Edit at https://www.toptal.com/developers/gitignore?templates=windows,linux,visualstudiocode,python
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+.ionide
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# End of https://www.toptal.com/developers/gitignore/api/windows,linux,visualstudiocode,python

polyany-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,45 @@
+ci:
+  autoupdate_commit_msg: "ci(pre-commit): pre-commit autoupdate"
+  skip: [pyright]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-added-large-files
+      - id: check-yaml
+        args:
+          - --unsafe
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.8
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+        exclude: ^tests/
+      - id: ruff-format
+
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.403
+    hooks:
+      - id: pyright
+
+  - repo: https://github.com/jsh9/pydoclint
+    rev: 0.6.7
+    hooks:
+      - id: pydoclint
+        args:
+          - --style=numpy
+          - --check-return-types=False
+          - --check-class-attributes=False
+          - --skip-checking-raises=True
+
+  - repo: https://github.com/commitizen-tools/commitizen
+    rev: v4.8.3
+    hooks:
+      - id: commitizen
+        stages: [commit-msg]
+      - id: commitizen-branch
+        stages: [pre-push]

polyany-0.3.0/.python-version

@@ -0,0 +1 @@
+3.13

polyany-0.3.0/CHANGELOG.md

@@ -0,0 +1,35 @@
+## 0.3.0 (2025-08-13)
+
+### Feat
+
+- multiplication and division (#40)
+
+## 0.2.0 (2025-08-06)
+
+### Feat
+
+- partial derivatives (#31)
+- zeros polynomial (#29)
+- add method to prune empty monomials (#27)
+- addition/subtraction (#19)
+- **exponents**: sparse representation (#20)
+- add method to shift variables (#8)
+- add comparison and equality operators (#5)
+- add quadratic form creation method (#4)
+- evaluate polynomial at a point using __call__
+- add univariate polynomial method
+
+### Fix
+
+- **prune**: return zeros polynomial when all coefficients are zero (#30)
+- polynomial evaluation without constant terms (#24)
+- get python builtin in degree attribute
+- remove squeeze in coefficients conversion
+
+### Refactor
+
+- simplify internal representation to full polynomial
+
+### Perf
+
+- full_exponents algorithm (#15)

polyany-0.3.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Cristiano Marcos Agulhari and Esdras Battosti da Silva
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

polyany-0.3.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: polyany
+Version: 0.3.0
+Summary: A Python package for algebraic manipulation of multivariate polynomials
+Project-URL: Homepage, https://rolmip.github.io/polyany/
+Project-URL: Documentation, https://rolmip.github.io/polyany/
+Project-URL: Repository, https://github.com/rolmip/polyany
+Project-URL: Issues, https://github.com/rolmip/polyany/issues
+Author-email: Cristiano Agulhari <agulhari@utfpr.edu.br>, Esdras Battosti <esdras.2019@alunos.utfpr.edu.br>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Keywords: algebra,multivariate,polynomials
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.11
+Requires-Dist: numpy>=2.3.1
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+<img src="docs/assets/polyany_logo.png" alt="PolyAny Logo" height="200">
+</h1><br>
+
+<p align="center">
+<img src="https://img.shields.io/badge/status-pre--alpha-orange" alt="Static Badge">
+<a href="https://codecov.io/gh/rolmip/polyany">
+  <img src="https://codecov.io/gh/rolmip/polyany/graph/badge.svg?token=XMNXDY6AZ7" alt="codecov">
+</a>
+<a href="https://github.com/rolmip/polyany/actions/workflows/tests.yml">
+  <img src="https://github.com/rolmip/polyany/actions/workflows/tests.yml/badge.svg" alt="Tests">
+</a>
+<a href="https://github.com/pre-commit/pre-commit">
+  <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit" alt="pre-commit">
+</a>
+<a href="https://results.pre-commit.ci/latest/github/rolmip/polyany/main">
+  <img src="https://results.pre-commit.ci/badge/github/rolmip/polyany/main.svg" alt="pre-commit.ci status">
+</a>
+
+<p align="center">
+  <strong>A Python package for algebraic manipulation of multivariate polynomials.</strong>
+</p>
+
+> 🚧 **This package is under active development.**
+>
+> It is not yet stable or ready for production use. **Expect breaking changes!**
+
+---
+
+## ✨ Overview
+
+PolyAny provides a flexible framework for representing and manipulating multivariate polynomials using structured, non-symbolic representations.
+
+Unlike symbolic engines, PolyAny operates directly on the algebraic structure of polynomials (coefficients and exponents), enabling integration with numerical libraries and efficient structural transformations.
+
+---
+
+## 🔧 Features (planned)
+
+- Polynomial creation from multiple formats (list, tuples, NumPy arrays, quadratic forms, ...)
+- Support for multivariate expressions
+- Algebraic operations: addition, multiplication, truncation, homogenization, ...
+- Polynomial exporting into LaTeX code
+
+---
+
+## 📦 Installation
+
+> ⚠️ Not yet available in PyPI.
+
+For local development, see the [instructions in the documentation](https://rolmip.github.io/polyany/installation/#how-to-contribute)
+
+## 📄 License
+
+This project is open-source and licensed under the BSD-3-Clause.
+
+## 👥 Contributors
+
+PolyAny is maintained by the **ROLMIP** developers:
+
+* [Cristiano Agulhari](mailto:agulhari@utfpr.edu.br)
+* [Esdras Battosti](mailto:esdras.2019@alunos.utfpr.edu.br)
+
+## 🧪 Status
+
+This repository is part of the early foundation of **RolmiPy**, a Python implementation of ROLMIP.