Merge branch 'main' into more_ruff_fixes

Author: oscarbenjamin

.github/workflows/buildwheel.yml

@@ -42,7 +42,7 @@ jobs:
         if: ${{ matrix.os == 'windows-2019' }}
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.20.0
+        uses: pypa/cibuildwheel@v2.22.0
         env:
           # override setting in pyproject.toml to use msys2 instead of msys64 bash
           CIBW_BEFORE_ALL_WINDOWS: msys2 -c bin/cibw_before_all_windows.sh
@@ -67,11 +67,7 @@ jobs:
         with:
           python-version: '3.12'
 
-      - run: sudo apt-get update
-      - run: sudo apt-get install libgmp-dev libmpfr-dev xz-utils ninja-build
-      - run: curl -O -L https://www.flintlib.org/flint-3.1.0.tar.gz
-      - run: tar -xzf flint-3.1.0.tar.gz
-      - run: cd flint-3.1.0 && ./configure --disable-static && make -j4 && sudo make install
+      - run: bin/install_latest_flint_ubuntu.sh
       - run: pip install build
       - run: python -m build --sdist
 
@@ -129,9 +125,7 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: '3.12'
-      - run: sudo apt-get update
-      - run: sudo apt-get install libflint-dev
-
+      - run: bin/install_latest_flint_ubuntu.sh
       - run: pip install --upgrade pip
       - run: pip install -r requirements-dev.txt
       - run: spin run -- pytest --doctest-glob='*.rst' doc/source
@@ -222,7 +216,7 @@ jobs:
       # Can't use actions/setup-python
       # https://github.com/actions/setup-python/issues/771
       # deadsnakes only works for Ubuntu...
-      - uses: deadsnakes/action@v3.1.0
+      - uses: deadsnakes/action@v3.2.0
         with:
           python-version: ${{ matrix.python-version }}
           nogil: true
@@ -259,6 +253,37 @@ jobs:
       - run: pip install sympy==${{ matrix.sympy-version }}
       - run: python -c 'import sympy; sympy.test(parallel=True)'
 
+  # Push nightly wheels to Anaconda scientific-python nightly channel
+  # https://scientific-python.org/specs/spec-0004/
+  # https://anaconda.org/scientific-python-nightly-wheels/python-flint
+  # https://github.com/scientific-python/upload-nightly-action/issues/111
+
+  nightly-wheels-upload:
+    name: Upload Anaconda Scientific Python nightly wheels
+    needs: [build_wheels]
+    # Run on push/merge to main
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+
+    steps:
+        # Downloads all artifacts
+      - name: Download release artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: wheelhouse
+          merge-multiple: true
+
+      - name: Copy the wheels into dist
+        run: mkdir dist && cp wheelhouse/*.whl dist
+
+      - name: Upload wheels
+        uses: scientific-python/upload-nightly-action@82396a2ed4269ba06c6b2988bb4fd568ef3c3d6b # 0.6.1
+        with:
+          artifacts_path: dist
+          # This token is generated from anaconda.org
+          # https://github.com/scientific-python/upload-nightly-action/issues/111
+          anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
+
   # Deploy wheels and sdist to PyPI
 
   pypi_release:
@@ -288,7 +313,7 @@ jobs:
         # It is recommended to pin a commit hash here for security but it
         # should be kept up to date. Possibly all actions and dependencies used
         # by the build script should be pinned...
-        uses: pypa/gh-action-pypi-publish@8a08d616893759ef8e1aa1f2785787c0b97e20d6  # v1.10.0
+        uses: pypa/gh-action-pypi-publish@fb13cb306901256ace3dab689990e13a5550ffaa  # v1.11.0
 
   # Make a GitHub release
 
@@ -300,6 +325,8 @@ jobs:
       contents: write
 
     steps:
+      - uses: actions/checkout@v4
+
       - name: Download sdist
         uses: actions/download-artifact@v4
         with:

.readthedocs.yaml

@@ -10,16 +10,24 @@ build:
   os: ubuntu-24.04
   tools:
     python: "3.12"
-    # You can also specify other tool versions:
-    # nodejs: "19"
-    # rust: "1.64"
-    # golang: "1.19"
+
   apt_packages:
     - libflint-dev
   jobs:
     pre_build:
       - pip install .
 
+  # Tried to use this to build latest version of FLINT but FLINT does not build
+  # in rtd for some reason. FLINT's configure seems to fail in all sorts of ways
+  # even though GMP and MPFR build fine.
+  #
+  #  commands:
+  #   - pip install -r requirements-dev.txt
+  #   - bin/build_dependencies_unix.sh --use-gmp-github-mirror
+  #   - spin build -- --pkg-config-path=.local/lib/pkgconfig -Dadd_flint_rpath=true
+  #   - spin docs
+  #   - mv doc/build/html $READTHEDOCS_OUTPUT/html
+
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
   configuration: doc/source/conf.py

README.md

@@ -164,6 +164,7 @@ Contributors (0.7.0):
 - Giacomo Pope (GP)
 - Joris Roos (JR)
 - Edgar Costa (EC)
+- Frédéric Chapoton (FC)
 - Oscar Benjamin (OB)
 
 Highlights (0.7.0):
@@ -175,18 +176,34 @@ Highlights (0.7.0):
 - [gh-132](https://github.com/flintlib/python-flint/pull/132),
   [gh-164](https://github.com/flintlib/python-flint/pull/164),
   [gh-190](https://github.com/flintlib/python-flint/pull/190),
+  [gh-191](https://github.com/flintlib/python-flint/pull/191):
   [gh-192](https://github.com/flintlib/python-flint/pull/192):
+  [gh-216](https://github.com/flintlib/python-flint/pull/216):
+  [gh-225](https://github.com/flintlib/python-flint/pull/225):
   Add `fmpz_mpoly`, `fmpq_mpoly`, `nmod_poly` and `fmpz_mod_poly`
   types for multivariate polynomials with integer, rational or
-  integers mod n coefficients. (JM)
+  integers mod `n` coefficients. (JM)
 - [gh-142](https://github.com/flintlib/python-flint/pull/142)
   Add `acb_theta` module for the numerical evaluation of [theta
   functions](https://flintlib.org/doc/acb_theta.html) (only
   available for `Flint >= 3.1`). (EC)
+- [gh-218](https://github.com/flintlib/python-flint/pull/218)
+  An experimental interface for FLINT's generic rings has been
+  added. This provides access to many of FLINT's types that
+  are not yet wrapped by python-flint such as Gaussian integer,
+  number fields, qqbar, calcium, as well as both univariate and
+  multivariate polynomials and series over these rings (no
+  matrices yet though). (OB)
 - [gh-129](https://github.com/flintlib/python-flint/pull/129)
+  [gh-208](https://github.com/flintlib/python-flint/pull/208)
   Use meson/meson-python instead of setuptools as the build system
   for parallel builds and better detection of build and dependency
   requirements. (OB)
+- [gh-201](https://github.com/flintlib/python-flint/pull/201)
+  [gh-202](https://github.com/flintlib/python-flint/pull/202)
+  The documentation has been updated and is now at
+  [readthedocs](https://python-flint.readthedocs.io/en/latest/).
+  (OB)
 
 Compatibility break (0.7.0):
 
@@ -198,11 +215,23 @@ Compatibility break (0.7.0):
 
 Other changes (0.7.0):
 
+- [gh-215](https://github.com/flintlib/python-flint/pull/215)
+  [gh-219](https://github.com/flintlib/python-flint/pull/219)
+  The FLINT binding declarations are now fully generated
+  automatically from the FLINT docs. (OB)
+- [gh-203](https://github.com/flintlib/python-flint/pull/203)
+  [gh-204](https://github.com/flintlib/python-flint/pull/204)
+  [gh-205](https://github.com/flintlib/python-flint/pull/205)
+  [gh-206](https://github.com/flintlib/python-flint/pull/206)
+  [gh-207](https://github.com/flintlib/python-flint/pull/207)
+  [gh-211](https://github.com/flintlib/python-flint/pull/211)
+  [gh-212](https://github.com/flintlib/python-flint/pull/212)
+  Various linting fixes and codebase improvements (FC and GP).
 - [gh-189](https://github.com/flintlib/python-flint/pull/189)
   All scalar and poly types now have `sqrt`. All poly types now
   have `factor_squarefree` and `leading_coefficient` methods.
   Exception types raised in a number of places were changed to
-  `DomainError` for better consistency.
+  `DomainError` for better consistency. (OB)
 - [gh-196](https://github.com/flintlib/python-flint/pull/196)
   Supported Python versions are 3.10-3.13 (3.9 dropped). CI
   Testing added for 3.13 free-threaded CPython.

bin/all_rst_to_pxd.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [ $# -eq 0 ]
+  then
+    echo "Usage: bin/all_rst_to_pxd.sh /path/to/flint/doc/source"
+    exit 1
+fi
+
+FLINT_DOC_DIR=$1
+
+modules=(
+    # "flint"
+    "mpoly"
+    # "thread_pool"
+    # "machine_vectors"
+    "gr"
+    "gr_domains"
+    "gr_generic"
+    "gr_implementing"
+    "gr_mat"
+    "gr_mpoly"
+    "gr_poly"
+    "gr_special"
+    "gr_vec"
+    "ulong_extras"
+    "fmpz"
+    # "fmpz_extras"
+    "fmpz_factor"
+    "fmpz_lll"
+    "fmpz_mat"
+    "fmpz_mpoly"
+    "fmpz_mpoly_factor"
+    "fmpz_mpoly_q"
+    "fmpz_poly"
+    "fmpz_poly_factor"
+    # "fmpz_poly_mat"
+    # "fmpz_poly_q"
+    "fmpz_vec"
+    # "long_extras"
+    # "longlong"
+    # "mpn_extras"
+    # "aprcl"
+    "arith"
+    # "fft"
+    # "fft_small"
+    # "qsieve"
+    "fmpq"
+    "fmpq_mat"
+    "fmpq_mpoly"
+    "fmpq_mpoly_factor"
+    "fmpq_poly"
+    "fmpq_vec"
+    "nmod"
+    "nmod_mat"
+    "nmod_mpoly"
+    "nmod_mpoly_factor"
+    "nmod_poly"
+    "nmod_poly_factor"
+    # "nmod_poly_mat"
+    "nmod_vec"
+    # "mpn_mod"
+    "fmpz_mod"
+    "fmpz_mod_mat"
+    "fmpz_mod_mpoly"
+    "fmpz_mod_mpoly_factor"
+    "fmpz_mod_poly"
+    "fmpz_mod_poly_factor"
+    "fmpz_mod_vec"
+    "dirichlet"
+    # "dlog"
+    # "bool_mat"
+    # "perm"
+    # "qfb"
+    # "nf"
+    # "nf_elem"
+    # "fmpzi"
+    # "qqbar"
+    "mag"
+    # "nfloat"
+    "arf"
+    # "acf"
+    "arb"
+    # "arb_calc"
+    "arb_fmpz_poly"
+    # "arb_fpwrap"
+    "arb_hypgeom"
+    "arb_mat"
+    "arb_poly"
+    "acb"
+    "acb_calc"
+    "acb_dft"
+    "acb_dirichlet"
+    "acb_elliptic"
+    "acb_hypgeom"
+    "acb_mat"
+    "acb_modular"
+    "acb_poly"
+    "acb_theta"
+    "bernoulli"
+    # "hypgeom"
+    "partitions"
+    # "ca"
+    # "ca_ext"
+    # "ca_field"
+    # "ca_mat"
+    # "ca_poly"
+    # "ca_vec"
+    # "calcium"
+    # "fexpr"
+    # "fexpr_builtin"
+    "fq"
+    # "fq_embed"
+    "fq_mat"
+    "fq_poly"
+    "fq_poly_factor"
+    # "fq_vec"
+    "fq_nmod"
+    # "fq_nmod_embed"
+    "fq_nmod_mat"
+    # "fq_nmod_mpoly"
+    # "fq_nmod_mpoly_factor"
+    "fq_nmod_poly"
+    "fq_nmod_poly_factor"
+    # "fq_nmod_vec"
+    "fq_zech"
+    # "fq_zech_embed"
+    "fq_zech_mat"
+    "fq_zech_poly"
+    "fq_zech_poly_factor"
+    # "fq_zech_vec"
+    "fq_default"
+    "fq_default_mat"
+    "fq_default_poly"
+    "fq_default_poly_factor"
+    # "padic"
+    # "padic_mat"
+    # "padic_poly"
+    # "qadic"
+    # "double_extras"
+    # "double_interval"
+    # "d_mat"
+    # "d_vec"
+    # "mpfr_mat"
+    # "mpfr_vec"
+)
+
+for module in ${modules[@]}; do
+    echo "Processing $module"
+    bin/rst_to_pxd.py flint/$module \
+        --flint-doc-dir=$FLINT_DOC_DIR \
+        > src/flint/flintlib/functions/$module.pxd
+done

bin/install_latest_flint_ubuntu.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+set -e
+
+source bin/build_variables.sh
+
+sudo apt-get update
+sudo apt-get install libgmp-dev libmpfr-dev xz-utils ninja-build
+
+curl -O -L https://github.com/flintlib/flint/releases/download/v$FLINTVER/flint-$FLINTVER.tar.gz
+tar -xzf flint-$FLINTVER.tar.gz
+cd flint-$FLINTVER && ./configure --disable-static && make -j$(expr $(nproc) + 1) && sudo make install
+
+ls -l /usr/local/lib
+sudo ldconfig /usr/local/lib