python-gmp 0.5.0b1__tar.gz → 0.5.0b2__tar.gz

python_gmp-0.5.0b2/.backportrc.json

@@ -0,0 +1,16 @@
+// .backportrc.json -- for https://github.com/sorenlouv/backport
+{
+  // Required
+  "repoOwner": "diofant",
+  "repoName": "python-gmp",
+  // the branches available to backport to
+  "targetBranchChoices": ["gmp-0.4.x"],
+  // Automatically detect which branches a pull request should be
+  // backported to based on the pull request labels.
+  "branchLabelMapping": {
+    "^backport-to-(.+)$": "gmp-$1"
+  },
+  "targetPRLabels": ["backport"],
+  "sourcePRLabels": ["backport-pr-created"],
+  "commitConflicts": true
+}

python_gmp-0.5.0b2/.github/workflows/backport.yml

@@ -0,0 +1,37 @@
+name: Automatic backport action
+
+on:
+  pull_request_target:
+    types: ["labeled", "closed"]
+
+permissions:
+  contents: write # so it can comment
+  pull-requests: write # so it can create pull requests
+
+jobs:
+  backport:
+    name: Backport PR
+    if: github.event.pull_request.merged == true && !(contains(github.event.pull_request.labels.*.name, 'backport')) && !(contains(github.event.pull_request.labels.*.name, 'backport-pr-created'))
+    runs-on: ubuntu-24.04
+    steps:
+      # Workaround not to fail the workflow if the PR does not need a backport
+      # https://github.com/sorenlouv/backport-github-action/issues/127#issuecomment-2277248320
+      - name: Check for backport labels
+        id: check_labels
+        run: |-
+          labels='${{ toJSON(github.event.pull_request.labels.*.name) }}'
+          matched=$(echo "${labels}" | jq '. | map(select(startswith("backport-to-"))) | length')
+          echo "matched=$matched"
+          echo "matched=$matched" >> $GITHUB_OUTPUT
+      - name: Backport Action
+        if: fromJSON(steps.check_labels.outputs.matched) > 0
+        uses: sorenlouv/backport-github-action@v10.2.0
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          auto_backport_label_prefix: backport-to-
+      - name: Info log
+        if: ${{ success() && fromJSON(steps.check_labels.outputs.matched) > 0 }}
+        run: cat ~/.backport/backport.info.log
+      - name: Debug log
+        if: ${{ failure() && fromJSON(steps.check_labels.outputs.matched) > 0 }}
+        run: cat ~/.backport/backport.debug.log

python_gmp-0.5.0b2/.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: Run CI tests
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    - cron: '0 0 * * 2'
+jobs:
+  linter:
+    uses: ./.github/workflows/linter.yml
+  coverage:
+    uses: ./.github/workflows/coverage.yml
+    needs:
+      - linter
+  os:
+    uses: ./.github/workflows/wheels.yml
+    if: startsWith(github.ref, 'refs/tags/') != true
+    needs:
+      - coverage

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/.github/workflows/coverage.yml

@@ -2,17 +2,16 @@ name: Run coverage tests
 on: [workflow_dispatch, workflow_call]
 jobs:
   coverage:
+    timeout-minutes: 20
     runs-on: ${{ matrix.os }}
     env:
-      PYTEST_ADDOPTS: --verbose
       CFLAGS: -Wall -Wpedantic -Werror -std=c17 -Wconversion
     strategy:
-      fail-fast: true
       matrix:
         os: [ubuntu-24.04]
-        python-version: [pypy3.11, "3.x", 3.14]
+        python-version: [pypy3.11, "graalpy-25.0", "3.x"]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - uses: actions/setup-python@v6
@@ -20,14 +19,14 @@ jobs:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true
       - run: sudo apt-get update
-      - run: sudo apt-get install lcov
+      - run: sudo apt-get install autoconf-archive lcov
       - name: Setup locales
         run: |
           sudo locale-gen ru_RU.UTF-8
           sudo locale-gen ps_AF.UTF-8
       - name: Cache GNU GMP builds
         id: cache-gmp
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: .local
           key: ${{ matrix.os }}-${{ hashFiles('scripts/*') }}
@@ -35,12 +34,12 @@ jobs:
         if: steps.cache-gmp.outputs.cache-hit != 'true'
       - run: python -m pip install --upgrade pip
       - run: |
-          pip install --verbose .[tests] -Cbuild-dir=build \
-                                         -Csetup-args=-Dbuildtype=debug \
-                                         -Csetup-args=-Db_coverage=true
+          pip install --verbose .[ci] -Cbuild-dir=build \
+                                      -Csetup-args=-Dbuildtype=debug \
+                                      -Csetup-args=-Db_coverage=true
         env:
           PKG_CONFIG_PATH: ${{ github.workspace }}/.local/lib/pkgconfig
-      - run: pytest --hypothesis-profile=default
+      - run: pytest
         env:
           LD_LIBRARY_PATH: ${{ github.workspace }}/.local/lib
       - name: Get coverage data
@@ -49,7 +48,7 @@ jobs:
           lcov --remove coverage.info "*.h" --ignore-errors unused \
                --output-file coverage.info
           cp coverage.info build/coverage-${{ matrix.python-version }}.info
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v6
         with:
           name: coverage-${{ matrix.python-version }}
           path: |
@@ -60,12 +59,12 @@ jobs:
     needs:
       - coverage
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - run: sudo apt-get update
       - run: sudo apt-get install lcov diff-cover
-      - uses: actions/download-artifact@v6
+      - uses: actions/download-artifact@v7
         with:
           pattern: coverage-*
           path: build/
@@ -76,7 +75,7 @@ jobs:
       - run: |
           diff-cover build/coverage*.info --fail-under=100 \
             --compare-branch=origin/master
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v6
         with:
           name: coverage
           path: |

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/.github/workflows/linter.yml

@@ -4,7 +4,7 @@ jobs:
   linter:
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - uses: actions/setup-python@v6

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/.github/workflows/publish.yml

@@ -6,16 +6,18 @@ jobs:
     if: startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-24.04
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         fetch-depth: 0
     - uses: actions/setup-python@v6
       with:
         python-version: "3.x"
+    - run: sudo apt-get update
+    - run: sudo apt-get install autoconf-archive
     - run: pip install build
     - name: Cache GNU GMP builds
       id: cache-gmp
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       with:
         path: .local
         key: ${{ matrix.os }}-${{ hashFiles('scripts/*') }}
@@ -24,7 +26,7 @@ jobs:
     - run: python -m build -s
       env:
         PKG_CONFIG_PATH: ${{ github.workspace }}/.local/lib/pkgconfig
-    - uses: actions/upload-artifact@v5
+    - uses: actions/upload-artifact@v6
       with:
         name: python-gmp-sdist
         path: dist/
@@ -43,7 +45,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-    - uses: actions/download-artifact@v6
+    - uses: actions/download-artifact@v7
       with:
         pattern: python-gmp-*
         path: dist/
@@ -60,12 +62,12 @@ jobs:
       contents: write
       id-token: write
     steps:
-    - uses: actions/download-artifact@v6
+    - uses: actions/download-artifact@v7
       with:
         pattern: python-gmp-*
         path: dist/
         merge-multiple: true
-    - uses: sigstore/gh-action-sigstore-python@v3.1.0
+    - uses: sigstore/gh-action-sigstore-python@v3.2.0
       with:
         inputs: >-
           ./dist/*.tar.gz

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/.github/workflows/wheels.yml

@@ -8,20 +8,30 @@ jobs:
       matrix:
         os: [ubuntu-24.04, ubuntu-24.04-arm, macos-15-intel, macos-15,
              windows-2022]
+        msystem: [ucrt64]
+        menv: [ucrt-x86_64]
+        include:
+          - os: windows-11-arm
+            msystem: clangarm64
+            menv: clang-aarch64
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-      - uses: msys2/setup-msys2@v2.29.0
+      - uses: msys2/setup-msys2@v2.30.0
         name: Setup msys2
         with:
           install: >-
-            mingw-w64-ucrt-x86_64-gcc
+            mingw-w64-${{ matrix.menv }}-binutils
+            mingw-w64-${{ matrix.menv }}-gcc
+            mingw-w64-${{ matrix.menv }}-tools
             diffutils
             m4
             make
             patch
-          msystem: ucrt64
+            autotools
+            autoconf-archive
+          msystem: ${{ matrix.msystem }}
         if: ${{ startsWith(matrix.os, 'windows') }}
       # Install pkgconfig on Windows from choco rather than from msys and
       # avoid using the Strawberry one.
@@ -30,10 +40,10 @@ jobs:
       # We have to set this here rather than in the cibuildwheel config
       # This is probably something to do with \ vs / in paths...
       - run: echo "PKG_CONFIG_PATH=${{ github.workspace }}/.local/lib/pkgconfig" >> $env:GITHUB_ENV
-        if: ${{ startsWith( matrix.os , 'windows' ) }}
+        if: ${{ startsWith(matrix.os, 'windows') }}
       - name: Build wheels
-        uses: pypa/cibuildwheel@v3.2.1
-      - uses: actions/upload-artifact@v5
+        uses: pypa/cibuildwheel@v3.3.1
+      - uses: actions/upload-artifact@v6
         with:
           name: wheels-${{ matrix.os }}
           path: ./wheelhouse/
@@ -42,7 +52,7 @@ jobs:
     needs: build_wheels
     steps:
       - name: Merge Wheels
-        uses: actions/upload-artifact/merge@v5
+        uses: actions/upload-artifact/merge@v6
         with:
           name: python-gmp-wheels
           pattern: wheels-*

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/.pre-commit-config.yaml

@@ -8,6 +8,7 @@ repos:
     - id: trailing-whitespace
     - id: name-tests-test
       args: [--pytest-test-first]
+      exclude: ^tests/utils.py$
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.8.3
     hooks:

python_gmp-0.5.0b2/.readthedocs.yaml

@@ -0,0 +1,34 @@
+version: 2
+formats:
+    - htmlzip
+    - pdf
+build:
+    os: ubuntu-24.04
+    apt_packages:
+        - libgmp-dev
+        - build-essential
+        - pkg-config
+    jobs:
+      pre_create_environment:
+        - |
+          PREFIX=$(pwd)/.local
+          ZZ_VERSION=0.8.0b0
+          ZZ_DIR=zz-${ZZ_VERSION}
+          GITHUB_URL=https://github.com/diofant/zz/releases/download/
+          ZZ_URL=${GITHUB_URL}v${ZZ_VERSION}/${ZZ_DIR}.tar.gz
+          wget ${ZZ_URL}
+          tar xzf ${ZZ_DIR}.tar.gz
+          cd ${ZZ_DIR}
+          ./configure -q --prefix=$PREFIX
+          make -s
+          make -s install
+    tools:
+        python: "3"
+python:
+    install:
+        - path: .
+          extra_requirements:
+              - docs
+sphinx:
+    fail_on_warning: true
+    configuration: docs/conf.py

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-2025 Sergey B Kirpichev
+Copyright (c) 2024-2026 Sergey B Kirpichev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-gmp
-Version: 0.5.0b1
+Version: 0.5.0b2
 Summary: Safe bindings to the GNU GMP library
 Keywords: gmp,multiple-precision,arbitrary-precision,bignum
 Author-Email: Sergey B Kirpichev <skirpichev@gmail.com>
@@ -15,8 +15,6 @@ Classifier: Operating System :: POSIX
 Classifier: Programming Language :: C
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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
@@ -35,11 +33,14 @@ Project-URL: Homepage, https://github.com/diofant/python-gmp
 Project-URL: Source Code, https://github.com/diofant/python-gmp
 Project-URL: Bug Tracker, https://github.com/diofant/python-gmp/issues
 Project-URL: Documentation, https://python-gmp.readthedocs.io/en/latest/
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Requires-Dist: hypothesis; extra == "tests"
-Requires-Dist: mpmath>=1.4.0a7; extra == "tests"
+Requires-Dist: mpmath; extra == "tests"
+Provides-Extra: ci
+Requires-Dist: python-gmp[tests]; extra == "ci"
+Requires-Dist: pytest-xdist; extra == "ci"
 Provides-Extra: docs
 Requires-Dist: sphinx>=8.2; extra == "docs"
 Provides-Extra: develop
@@ -51,17 +52,16 @@ Description-Content-Type: text/x-rst
 Python-GMP
 ==========
 
-Python extension module, gmp, providing safe bindings to the GNU GMP (version
-6.3.0 or later required) via the `ZZ library <https://github.com/diofant/zz>`_.
-This module shouldn't crash the interpreter.
+Python extension module, providing bindings to the GNU GMP via the `ZZ library
+<https://github.com/diofant/zz>`_.  This module shouldn't crash the interpreter.
 
 The gmp can be used as a `gmpy2`_/`python-flint`_ replacement to provide
-integer type (`mpz`_), compatible with Python's `int`_.  It includes few
-functions (`comb`_, `factorial`_, `gcd`_, `isqrt`_, `lcm`_ and `perm`_),
-compatible with the Python stdlib's module `math`_.
+integer type (`mpz`_), compatible with Python's `int`_.  It also includes
+functions, compatible with the Python stdlib's submodule `math.integer
+<https://docs.python.org/3.15/library/math.integer.html>`_.
 
-This module requires Python 3.9 or later versions and has been tested with
-CPython 3.9 through 3.14, with PyPy3.11 7.3.20 and with GraalPy 25.0.
+This module requires Python 3.11 or later versions and has been tested with
+CPython 3.11 through 3.14, with PyPy3.11 7.3.20 and with GraalPy 25.0.
 Free-threading builds of the CPython are supported.
 
 Releases are available in the Python Package Index (PyPI) at
@@ -72,17 +72,16 @@ Motivation
 ----------
 
 The CPython (and most other Python implementations, like PyPy) is optimized to
-work with small integers.  Algorithms used here for "big enough" integers
-usually aren't best known in the field.  Fortunately, it's possible to use
-bindings (for example, the `gmpy2`_ package) to the GNU Multiple Precision
-Arithmetic Library (GMP), which aims to be faster than any other bignum library
-for all operand sizes.
-
-But such extension modules usually rely on default GMP's memory allocation
-functions and can't recover from errors such as out of memory.  So, it's easy
-to crash the Python interpreter during the interactive session.  Following
-example with the gmpy2 will work if you set address space limit for the Python
-interpreter (e.g. by ``prlimit`` command on Linux):
+work with small (machine-sized) integers.  Algorithms used here for big
+integers usually aren't best known in the field.  Fortunately, it's possible to
+use bindings (for example, the `gmpy2`_ package) to the GNU GMP, which aims to
+be faster than any other bignum library for all operand sizes.
+
+But such extension modules usually rely on default GMP's memory management and
+can't recover from allocation failure.  So, it's easy to crash the Python
+interpreter during the interactive session.  Following example with the gmpy2
+will work if you set address space limit for the Python interpreter (e.g. by
+``prlimit`` command on Linux):
 
 .. code:: pycon
 
@@ -120,19 +119,11 @@ Warning on --disable-alloca configure option
 --------------------------------------------
 
 You should use the GNU GMP library, compiled with the '--disable-alloca'
-configure option to prevent using alloca() for temporary workspace allocation
-(and use the heap instead), or this module can't prevent a crash in case of a
-stack overflow.
+configure option to prevent using alloca() for temporary workspace allocation,
+or this module may crash the interpreter in case of a stack overflow.
 
 
 .. _gmpy2: https://pypi.org/project/gmpy2/
 .. _python-flint: https://pypi.org/project/python-flint/
 .. _mpz: https://python-gmp.readthedocs.io/en/latest/#gmp.mpz
 .. _int: https://docs.python.org/3/library/functions.html#int
-.. _factorial: https://python-gmp.readthedocs.io/en/latest/#gmp.factorial
-.. _gcd: https://python-gmp.readthedocs.io/en/latest/#gmp.gcd
-.. _isqrt: https://python-gmp.readthedocs.io/en/latest/#gmp.isqrt
-.. _lcm: https://python-gmp.readthedocs.io/en/latest/#gmp.lcm
-.. _comb: https://python-gmp.readthedocs.io/en/latest/#gmp.comb
-.. _perm: https://python-gmp.readthedocs.io/en/latest/#gmp.perm
-.. _math: https://docs.python.org/3/library/math.html#number-theoretic-functions

python_gmp-0.5.0b2/README.rst

@@ -0,0 +1,78 @@
+Python-GMP
+==========
+
+Python extension module, providing bindings to the GNU GMP via the `ZZ library
+<https://github.com/diofant/zz>`_.  This module shouldn't crash the interpreter.
+
+The gmp can be used as a `gmpy2`_/`python-flint`_ replacement to provide
+integer type (`mpz`_), compatible with Python's `int`_.  It also includes
+functions, compatible with the Python stdlib's submodule `math.integer
+<https://docs.python.org/3.15/library/math.integer.html>`_.
+
+This module requires Python 3.11 or later versions and has been tested with
+CPython 3.11 through 3.14, with PyPy3.11 7.3.20 and with GraalPy 25.0.
+Free-threading builds of the CPython are supported.
+
+Releases are available in the Python Package Index (PyPI) at
+https://pypi.org/project/python-gmp/.
+
+
+Motivation
+----------
+
+The CPython (and most other Python implementations, like PyPy) is optimized to
+work with small (machine-sized) integers.  Algorithms used here for big
+integers usually aren't best known in the field.  Fortunately, it's possible to
+use bindings (for example, the `gmpy2`_ package) to the GNU GMP, which aims to
+be faster than any other bignum library for all operand sizes.
+
+But such extension modules usually rely on default GMP's memory management and
+can't recover from allocation failure.  So, it's easy to crash the Python
+interpreter during the interactive session.  Following example with the gmpy2
+will work if you set address space limit for the Python interpreter (e.g. by
+``prlimit`` command on Linux):
+
+.. code:: pycon
+
+   >>> import gmpy2
+   >>> gmpy2.__version__
+   '2.2.1'
+   >>> z = gmpy2.mpz(29925959575501)
+   >>> while True:  # this loop will crash interpter
+   ...     z = z*z
+   ...
+   GNU MP: Cannot allocate memory (size=46956584)
+   Aborted
+
+The gmp module handles such errors correctly:
+
+.. code:: pycon
+
+   >>> import gmp
+   >>> z = gmp.mpz(29925959575501)
+   >>> while True:
+   ...     z = z*z
+   ...
+   Traceback (most recent call last):
+     File "<python-input-3>", line 2, in <module>
+       z = z*z
+           ~^~
+   MemoryError
+   >>> # interpreter still works, all variables in
+   >>> # the current scope are available,
+   >>> z.bit_length()  # including pre-failure value of z
+   93882077
+
+
+Warning on --disable-alloca configure option
+--------------------------------------------
+
+You should use the GNU GMP library, compiled with the '--disable-alloca'
+configure option to prevent using alloca() for temporary workspace allocation,
+or this module may crash the interpreter in case of a stack overflow.
+
+
+.. _gmpy2: https://pypi.org/project/gmpy2/
+.. _python-flint: https://pypi.org/project/python-flint/
+.. _mpz: https://python-gmp.readthedocs.io/en/latest/#gmp.mpz
+.. _int: https://docs.python.org/3/library/functions.html#int

python_gmp-0.5.0b2/bench/README.rst

@@ -0,0 +1,11 @@
+This directory holds some basic benchmarks for the gmp extension.
+
+It's possible to run them also with gmpy2's and flint's integer types:
+
+.. code:: sh
+
+    ( export T="gmpy2.mpz"; \
+      python bench/mul.py -q --copy-env --rigorous -o $T.json )
+
+Beware, that the gmp prefers clang over gcc and extensions might
+use different compiler options per default.

python_gmp-0.5.0b2/bench/collatz.py

@@ -0,0 +1,42 @@
+# collatz.py
+
+import os
+
+import pyperf
+
+if os.getenv("T") == "gmpy2.mpz":
+    from gmpy2 import mpz
+elif os.getenv("T") == "flint.fmpz":
+    from flint import fmpz as mpz
+else:
+    from gmp import mpz
+
+zero = mpz(0)
+one = mpz(1)
+two = mpz(2)
+three = mpz(3)
+
+# https://en.wikipedia.org/wiki/Collatz_conjecture
+
+def collatz0(n):
+    total = 0
+    n = mpz(n)
+    while n > one:
+        n = n*three + one if n & one else n//two
+        total += 1
+    return total
+
+def collatz1(n):
+    total = 0
+    n = mpz(n)
+    while n > 1:
+        n = n*3 + 1 if n & 1 else n//2
+        total += 1
+    return total
+
+runner = pyperf.Runner()
+for f in [collatz0, collatz1]:
+    for v in ["97", "871", "(1<<128)+31"]:
+        h = f"{f.__name__}({v})"
+        i = eval(v)
+        runner.bench_func(h, f, i)

python_gmp-0.5.0b2/bench/mul.py

@@ -0,0 +1,24 @@
+# mul.py
+
+import os
+from operator import mul
+
+import pyperf
+
+if os.getenv("T") == "gmpy2.mpz":
+    from gmpy2 import mpz
+elif os.getenv("T") == "flint.fmpz":
+    from flint import fmpz as mpz
+else:
+    from gmp import mpz
+
+values = ["1<<7", "1<<38", "1<<300", "1<<3000"]
+
+runner = pyperf.Runner()
+for v in values:
+    i = eval(v)
+    bn = '("'+v+'")**2'
+    x = mpz(i)
+    # make y != x to avoid a quick mpn_sqr() path on gmp/flint
+    y = mpz(i + 1)
+    runner.bench_func(bn, mul, x, y)

{python_gmp-0.5.0b1 → python_gmp-0.5.0b2}/docs/conf.py

@@ -36,7 +36,7 @@ autodoc_default_options = {"members": True}
 
 # General information about the project.
 project = gmp.__package__
-copyright = "2024-2025, Sergey B Kirpichev"
+copyright = "2024-2026, Sergey B Kirpichev"
 gmp_version = packaging.version.parse(gmp.__version__)
 
 # The version info for the project you're documenting, acts as