Merge sagemath#29865

.gitignore

@@ -157,6 +157,14 @@ build/bin/sage-build-env-config
 /pkgs/*/*.egg-info
 /pkgs/*/.tox
 
+/pkgs/sagemath-objects/setup.cfg
+/pkgs/sagemath-categories/setup.cfg
+/pkgs/sagemath-objects/pyproject.toml
+/pkgs/sagemath-categories/pyproject.toml
+/pkgs/sagemath-objects/requirements.txt
+/pkgs/sagemath-categories/requirements.txt
+/pkgs/sagemath-categories/MANIFEST.in
+
 # same for old locations - before Trac #31577
 /build/pkgs/*/src/build
 /build/pkgs/*/src/dist

Makefile

@@ -79,6 +79,16 @@ download:
 dist: build/make/Makefile
 	./sage --sdist
 
+pypi-sdists: sage_setup
+	./sage --sh build/pkgs/sage_conf/spkg-src
+	./sage --sh build/pkgs/sage_setup/spkg-src
+	./sage --sh build/pkgs/sage_sws2rst/spkg-src
+	./sage --sh build/pkgs/sage_docbuild/spkg-src
+	./sage --sh build/pkgs/sagelib/spkg-src
+	./sage --sh build/pkgs/sagemath_objects/spkg-src
+	./sage --sh build/pkgs/sagemath_categories/spkg-src
+	@echo "Built sdists are in upstream/"
+
 # ssl: build Sage, and also install pyOpenSSL. This is necessary for
 # running the secure notebook. This make target requires internet
 # access. Note that this requires that your system have OpenSSL

build/bin/write-dockerfile.sh

@@ -187,7 +187,7 @@ FROM with-system-packages as bootstrapped
 #:bootstrapping:
 RUN mkdir -p /sage
 WORKDIR /sage
-ADD Makefile VERSION.txt README.md bootstrap configure.ac sage ./
+ADD Makefile VERSION.txt COPYING.txt condarc.yml README.md bootstrap configure.ac sage .homebrew-build-env tox.ini Pipfile.m4 ./
 ADD src/doc/bootstrap src/doc/bootstrap
 ADD src/bin src/bin
 ADD m4 ./m4

build/make/Makefile.in

@@ -230,7 +230,6 @@ base-toolchain: _clean-broken-gcc base
 
 # All targets except for the base packages
 all-sage: \
-		sagelib \
 		$(INSTALLED_PACKAGE_INSTS) \
                 $(UNINSTALLED_PACKAGES_CLEANS)
 

build/pkgs/sage_conf/spkg-src

@@ -15,7 +15,5 @@ fi
 # Exit on failure
 set -e
 
-cd build/pkgs/sage_conf
-
-cd src
+cd pkgs/sage-conf_pypi
 python3 -u setup.py --no-user-cfg sdist --dist-dir "$SAGE_DISTFILES"

build/pkgs/sagelib/bootstrap

@@ -4,7 +4,7 @@ for infile in src/*.m4; do
     if [ -f "$infile" ]; then
         outfile="src/$(basename $infile .m4)"
         if [ "${BOOTSTRAP_QUIET}" = "no" ]; then
-            echo "$0: installing build/pkgs/sagelib/$outfile"
+            echo "$0: installing $(pwd)/$outfile"
         fi
         m4 "$infile" > "$outfile"
     fi

build/pkgs/sagemath_categories/SPKG.rst

@@ -0,0 +1 @@
+src/README.rst

build/pkgs/sagemath_categories/bootstrap

@@ -0,0 +1 @@
+../sagelib/bootstrap

build/pkgs/sagemath_categories/dependencies

@@ -0,0 +1 @@
+../sagemath_objects/dependencies

build/pkgs/sagemath_categories/package-version.txt

@@ -0,0 +1 @@
+../sagelib/package-version.txt

build/pkgs/sagemath_categories/spkg-install

@@ -0,0 +1 @@
+../sagemath_objects/spkg-install

build/pkgs/sagemath_categories/spkg-src

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+#
+# Script to prepare an sdist tarball for sagemath-categories
+# This script is not used during build.
+#
+# HOW TO MAKE THE TARBALL:
+# ./sage --sh build/pkgs/sagemath_categories/spkg-src
+
+if [ -z "$SAGE_ROOT" ] ; then
+    echo >&2 "Error - SAGE_ROOT undefined ... exiting"
+    echo >&2 "Maybe run 'sage -sh'?"
+    exit 1
+fi
+
+# Exit on failure
+set -e
+
+cd build/pkgs/sagemath_categories
+
+cd src
+python3 -u setup.py --no-user-cfg sdist --dist-dir "$SAGE_DISTFILES"

build/pkgs/sagemath_categories/src

@@ -0,0 +1 @@
+../../../pkgs/sagemath-categories

build/pkgs/sagemath_categories/type

@@ -0,0 +1 @@
+experimental

build/pkgs/sagemath_objects/SPKG.rst

@@ -0,0 +1 @@
+src/README.rst

build/pkgs/sagemath_objects/bootstrap

@@ -0,0 +1 @@
+../sagelib/bootstrap

build/pkgs/sagemath_objects/dependencies

@@ -0,0 +1,4 @@
+FORCE $(PYTHON) cysignals gmpy2 ipython | $(PYTHON_TOOLCHAIN) cython pkgconfig $(and $(filter-out no,$(SAGE_CHECK)), tox)
+
+# FORCE: Always run the spkg-install script
+# ipython - for the doctester

build/pkgs/sagemath_objects/package-version.txt

@@ -0,0 +1 @@
+../sagelib/package-version.txt

build/pkgs/sagemath_objects/spkg-install

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+cd src
+
+if [ "$SAGE_CHECK" != no ]; then
+    tox
+fi
+# We skip the install for now.
+exit 0

build/pkgs/sagemath_objects/spkg-src

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+#
+# Script to prepare an sdist tarball for sagemath-objects
+# This script is not used during build.
+#
+# HOW TO MAKE THE TARBALL:
+# 1) ./sage --sh build/pkgs/sagemath_objects/spkg-src
+
+if [ -z "$SAGE_ROOT" ] ; then
+    echo >&2 "Error - SAGE_ROOT undefined ... exiting"
+    echo >&2 "Maybe run 'sage -sh'?"
+    exit 1
+fi
+
+# Exit on failure
+set -e
+
+cd build/pkgs/sagemath_objects
+
+cd src
+python3 -u setup.py --no-user-cfg sdist --dist-dir "$SAGE_DISTFILES"

build/pkgs/sagemath_objects/src

@@ -0,0 +1 @@
+../../../pkgs/sagemath-objects

build/pkgs/sagemath_objects/type

@@ -0,0 +1 @@
+experimental

configure.ac

@@ -452,6 +452,14 @@ AC_ARG_ENABLE([r],
     done
   ])
 
+AC_ARG_ENABLE([sagelib],
+  AS_HELP_STRING([--disable-sagelib],
+                 [disable build of the Sage library and packages depending on it]), [
+    for pkg in sagelib sage_docbuild; do
+      AS_VAR_SET([SAGE_ENABLE_$pkg], [$enableval])
+    done
+  ])
+
 SAGE_SPKG_COLLECT()
 
 dnl AC_CONFIG_HEADERS([config.h])

pkgs/sage-conf/.gitignore

@@ -1,2 +1,4 @@
 /sage_conf.py
 /setup.cfg
+/build
+/*.egg-info

pkgs/sage-conf/README.rst

@@ -1,10 +1,10 @@
-sage_conf: Configuration module for the SageMath library
-========================================================
+sage_conf: Configuration module for the SageMath library (distributable version)
+================================================================================
 
 Description
 -----------
 
-This package provides:
+This distribution package provides:
 
 - a single Python module, ``sage_conf``, providing configuration information
   to the SageMath library at the time of its installation and at its runtime
@@ -15,10 +15,77 @@ This package provides:
 - a sourcable shell script ``sage-env-config``, providing additional configuration
   information in the form of environment variables
 
-This version of the package is generated by the Sage distribution's ``configure``
-script.  Downstream packagers and advanced developers and users may want to provide
-their own implementation of the package to support the intended deployment of
-the SageMath library.
+The ``sage_conf`` distribution package is polymorphic:  It has several implementations.
+
+
+sage_conf sdist on PyPI
+-----------------------
+
+This implementation of the ``sage_conf`` distribution package comes from
+https://trac.sagemath.org/ticket/29039, which adds the directory
+``src/pkgs/sage_conf-pypi/``.
+
+On installation (or building a wheel), it invokes ``sage_bootstrap`` to establish
+a build tree (``SAGE_ROOT``) and installation tree (``SAGE_LOCAL``) for
+the SageMath distribution.  By default, it uses a subdirectory of ``$HOME/.sage``
+that is specific to the version of the distribution and the version of Python in
+use.  If several virtual environments over the same version of Python install
+``sage_conf``, they will share these trees.
+
+After installation of ``sage_conf``, a wheelhouse containing wheels of
+various libraries is available; type ``ls $(sage-config
+SAGE_SPKG_WHEELS)`` to list them and ``pip install $(sage-config
+SAGE_SPKG_WHEELS)/*.whl`` to install them.  After this, you can install the Sage
+library, for example, using ``pip install sagemath-standard``.
+
+
+sage_conf wheels
+----------------
+
+Prebuilt binary wheels of the ``sage_conf`` distribution package are available
+at https://github.com/sagemath/sage-wheels/releases/
+
+This implementation of ``sage_conf`` comes from https://trac.sagemath.org/ticket/31396,
+which adds the directory ``src/pkgs/sage_conf-relocatable/``.
+
+On building a wheel, it invokes ``sage_bootstrap`` to establish a
+build and installation tree (``SAGE_ROOT``, ``SAGE_LOCAL``) in a
+subdirectory of the directory ``/var/tmp/``, whose name is specific to
+the version of the distribution and the version of Python in use.
+
+The wheel distributes a copy of the prebuilt ``SAGE_ROOT`` and
+``SAGE_LOCAL``.  Importing ``sage_conf`` (or using the installed
+``sage-config`` script), makes sure that a symlink from the
+``/var/tmp`` location to the actual persistent installation location
+is created.  As the relocated libraries and programs contain the
+hardcoded path ``SAGE_LOCAL`` in various ways (including as rpaths),
+this symlink is necessary for the prebuilt libraries and programs to
+work.
+
+``/var/tmp`` is a sticky directory on all Linux distributions
+following the Filesystem Hierarchy Standard, as well as on macOS and
+on Cygwin.  On multi-user systems, only one user can use a given
+version of the distribution; other installation schemes are recommended
+for systems with multiple Sage users.
+
+
+sage_conf in the SageMath distribution
+--------------------------------------
+
+The original version of the distribution package ``sage_conf`` is used
+internally in the SageMath distribution.  It is provided in the directory
+``build/pkgs/sage_conf/src``.  This version of the package is generated
+by the Sage distribution's ``configure``
+script.
+
+
+sage_conf in downstream distributions
+-------------------------------------
+
+Downstream packagers and advanced developers and users may want to provide
+their own implementation of the distribution package to support the intended
+deployment of the SageMath library.
+
 
 License
 -------
@@ -31,4 +98,4 @@ Upstream Contact
 https://www.sagemath.org
 
 This package is included in the source code of the Sage distribution,
-in ``/sage_conf``.
+in ``pkgs/sage-conf``.

pkgs/sage-conf/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

pkgs/sage-conf/sage_conf.py.in

@@ -44,6 +44,8 @@ THREEJS_DIR = SAGE_LOCAL + "/share/threejs-sage"
 OPENMP_CFLAGS = "@OPENMP_CFLAGS@"
 OPENMP_CXXFLAGS = "@OPENMP_CXXFLAGS@"
 
+SAGE_SPKG_WHEELS = "@prefix@/var/lib/sage/wheels"
+
 # Entry point 'sage-config'.  It does not depend on any packages.
 
 def _main():

pkgs/sage-conf_pypi/.gitignore

@@ -0,0 +1,5 @@
+/sage_conf.py
+/build
+/dist
+/*.egg-info
+/.tox

pkgs/sage-conf_pypi/MANIFEST.in

@@ -0,0 +1,18 @@
+include VERSION.txt
+graft bin
+graft sage_root
+# These sources are not needed because individual distributions of these are made.
+prune sage_root/build/pkgs/*/src*
+# Except for this one because config.status writes there
+graft sage_root/build/pkgs/sage_conf/src
+prune sage_root/build/pkgs/sage_conf/src/build
+# And this one because of declared dependencies on source files in Makefile.in
+graft sage_root/build/pkgs/sage_docbuild/src
+prune sage_root/build/pkgs/sage_docbuild/src/build
+prune sage_root/build/pkgs/sage_docbuild/src/sage_docbuild.egg-info
+#
+global-exclude .tox
+global-exclude *~*
+global-exclude *.bak
+global-exclude __pycache__
+global-exclude *.pyc

pkgs/sage-conf_pypi/README.rst

@@ -0,0 +1 @@
+../sage-conf/README.rst

pkgs/sage-conf_pypi/VERSION.txt

@@ -0,0 +1 @@
+../../src/VERSION.txt

pkgs/sage-conf_pypi/bin/sage-env-config.in

@@ -0,0 +1 @@
+../../sage-conf/bin/sage-env-config.in

pkgs/sage-conf_pypi/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

pkgs/sage-conf_pypi/sage_conf.py.in

@@ -0,0 +1 @@
+../sage-conf/sage_conf.py.in

pkgs/sage-conf_pypi/sage_root/.homebrew-build-env

@@ -0,0 +1 @@
+../../../.homebrew-build-env

pkgs/sage-conf_pypi/sage_root/Makefile

@@ -0,0 +1 @@
+../../../Makefile

pkgs/sage-conf_pypi/sage_root/README.md

@@ -0,0 +1 @@
+../../../README.md

pkgs/sage-conf_pypi/sage_root/VERSION.txt

@@ -0,0 +1 @@
+../../../VERSION.txt

pkgs/sage-conf_pypi/sage_root/bootstrap

@@ -0,0 +1,3 @@
+#! /usr/bin/env bash
+# This version of the bootstrap script does nothing.
+exit 0

pkgs/sage-conf_pypi/sage_root/build

@@ -0,0 +1 @@
+../../../build

pkgs/sage-conf_pypi/sage_root/config

@@ -0,0 +1 @@
+../../../config

pkgs/sage-conf_pypi/sage_root/configure

@@ -0,0 +1 @@
+../../../configure

pkgs/sage-conf_pypi/sage_root/configure.ac

@@ -0,0 +1 @@
+../../../configure.ac

pkgs/sage-conf_pypi/sage_root/m4

@@ -0,0 +1 @@
+../../../m4

pkgs/sage-conf_pypi/sage_root/pkgs/sage-conf

@@ -0,0 +1 @@
+../../../sage-conf

pkgs/sage-conf_pypi/sage_root/src/bin

@@ -0,0 +1 @@
+../../../../src/bin

pkgs/sage-conf_pypi/sage_root/src/doc/bootstrap

@@ -0,0 +1,3 @@
+#! /usr/bin/env bash
+# This version of the src/doc/bootstrap script does nothing.
+exit 0

pkgs/sage-conf_pypi/setup.cfg

@@ -0,0 +1,16 @@
+[metadata]
+name = sage-conf
+version = file: VERSION.txt
+description = Sage: Open Source Mathematics Software: Configuration module for the SageMath library
+long_description = file: README.rst
+license = GNU General Public License (GPL) v3 or later
+author = The Sage Developers
+author_email = [email protected]
+url = https://www.sagemath.org
+
+[options]
+py_modules =
+    sage_conf
+
+scripts =
+    bin/sage-env-config