Merge remote-tracking branch 'upstream/main' into pr_generic_rings

Author: oscarbenjamin

.github/workflows/buildwheel.yml

@@ -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

.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

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

bin/rtd_before_all_linux.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+apt-get install xz-utils
+
+bin/build_dependencies_unix.sh\
+  --gmp gmp\
+  --host x86_64-pc-linux-gnu\
+  --use-gmp-github-mirror

doc/source/fmpq_mpoly.rst

@@ -0,0 +1,18 @@
+**fmpq_mpoly** -- multivariate polynomials over the rational numbers
+===============================================================================
+
+.. autoclass :: flint.fmpq_mpoly_ctx
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpq_mpoly
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpq_mpoly_vec
+  :members:
+  :inherited-members:
+  :undoc-members:
+

doc/source/fmpz_mod_mpoly.rst

@@ -0,0 +1,18 @@
+**fmpz_mod_mpoly** -- multivariate polynomials over the integers mod n
+===============================================================================
+
+.. autoclass :: flint.fmpz_mod_mpoly_ctx
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpz_mod_mpoly
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpz_mod_mpoly_vec
+  :members:
+  :inherited-members:
+  :undoc-members:
+

doc/source/fmpz_mpoly.rst

@@ -0,0 +1,18 @@
+**fmpz_mpoly** -- multivariate polynomials over the integers
+===============================================================================
+
+.. autoclass :: flint.fmpz_mpoly_ctx
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpz_mpoly
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.fmpz_mpoly_vec
+  :members:
+  :inherited-members:
+  :undoc-members:
+

doc/source/index.rst

@@ -73,9 +73,13 @@ Polynomial types
    :maxdepth: 1
 
    fmpz_poly.rst
+   fmpz_mpoly.rst
    fmpq_poly.rst
+   fmpq_mpoly.rst
    nmod_poly.rst
+   nmod_mpoly.rst
    fmpz_mod_poly.rst
+   fmpz_mod_mpoly.rst
    fq_default_poly.rst
    arb_poly.rst
    acb_poly.rst

doc/source/nmod_mpoly.rst

@@ -0,0 +1,18 @@
+**nmod_mpoly** -- multivariate polynomials over the integers mod n (word-size n)
+================================================================================
+
+.. autoclass :: flint.nmod_mpoly_ctx
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.nmod_mpoly
+  :members:
+  :inherited-members:
+  :undoc-members:
+
+.. autoclass :: flint.nmod_mpoly_vec
+  :members:
+  :inherited-members:
+  :undoc-members:
+

pyproject.toml

@@ -53,12 +53,8 @@ build-backend = "mesonpy"
 # E741 ambiguous variable name
 # Reasoning: many places it makes sense to use l or other letters as variable
 #            names as it is standard in mathematical notation.
-#
-# E743 ambiguous function definition
-# Reasoning: this is a work in progress and will be enforced after #210 is
-#            resolved.
 max-line-length = 120
-ignore = ['E129','E501','E741','E743']
+ignore = ['E129','E501','E741']
 exclude = 'src/flint/flintlib/functions.*'
 
 [tool.spin]