passagemath-doc-pdf 10.5.26__tar.gz → 10.5.28__tar.gz

passagemath_doc_pdf-10.5.28/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: passagemath-doc-pdf
+Version: 10.5.28
+Summary: passagemath: Documentation in PDF format
+Author-Email: The Sage Developers <sage-support@googlegroups.com>
+License: GNU General Public License (GPL) v2 or later; Creative Commons Attribution-ShareAlike 3.0 Unported
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Project-URL: Homepage, https://www.sagemath.org
+Description-Content-Type: text/x-rst
+
+=====================================================================
+ passagemath: Documentation in PDF format
+=====================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <https://github.com/sagemath/sage/issues/29705>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+When installed from source, the distribution `sagemath-doc-pdf` uses Sphinx
+and LuaLaTeX to build the SageMath documentation in PDF format.

passagemath_doc_pdf-10.5.28/README.rst

@@ -0,0 +1,51 @@
+=====================================================================
+ passagemath: Documentation in PDF format
+=====================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <https://github.com/sagemath/sage/issues/29705>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+When installed from source, the distribution `sagemath-doc-pdf` uses Sphinx
+and LuaLaTeX to build the SageMath documentation in PDF format.

passagemath_doc_pdf-10.5.28/VERSION.txt

@@ -0,0 +1 @@
+10.5.28

{passagemath_doc_pdf-10.5.26 → passagemath_doc_pdf-10.5.28}/doc/en/reference/spkg/python3.rst

@@ -55,7 +55,7 @@ Version Information
 
 package-version.txt::
 
-    3.12.5
+    3.12.10
 
 
 Equivalent System Packages

passagemath_doc_pdf-10.5.28/doc/en/reference/spkg/sage_conf.rst

@@ -0,0 +1,186 @@
+.. _spkg_sage_conf:
+
+sage_conf: Configuration module for the SageMath library
+====================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <:issue:`29705`>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This distribution package ``passagemath-conf`` provides:
+
+- a single Python module, ``sage_conf``, providing configuration information
+  to the SageMath library at the time of its installation and at its runtime
+
+- a console script ``sage-config``, for querying the variables of ``sage_conf``
+  from the shell
+
+- a sourcable shell script ``sage-env-config``, providing additional configuration
+  information in the form of environment variables
+
+The modularized distribution packages of the Sage library
+may declare ``passagemath-conf`` both as a PEP 518 build-system requirement and a run-time
+dependency ("install-requires").
+
+The ``passagemath-conf`` distribution package is polymorphic:  It has several implementations.
+
+
+passagemath-conf sdist on PyPI
+------------------------------
+
+This implementation of the package comes from the directory
+`pkgs/sage-conf_pypi <https://github.com/passagemath/passagemath/tree/main/pkgs/sage-conf_pypi/>`_.
+
+To install, use ``pip install -v passagemath-conf``.  Using ``-v`` ensures that diagnostic
+messages are displayed.
+
+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
+``passagemath-conf``, they will share these trees.
+
+After installation of ``passagemath-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``.
+
+Customization with environment variables:
+
+- ``SAGE_CONF_FILE``, ``SAGE_CONF_ENV_FILE``
+
+  To skip creation of a build tree and bring your own configuration instead,
+  use the environment variables ``SAGE_CONF_FILE`` or ``SAGE_CONF_ENV_FILE``
+  at the build time of the package. The files named by these variables
+  are copied as ``_sage_conf.py`` and ``sage-env-config``.
+
+  For example, to skip creation of a build tree and set no configuration
+  variables at all, you can use::
+
+    export SAGE_CONF_FILE=/dev/null
+
+- ``SAGE_CONF_CONFIGURE_ARGS``
+
+  If set, this is appended to the invocation of ``./configure``.
+
+- ``SAGE_CONF_TARGETS``
+
+  The Makefile targets to build. The default is ``build`` (which builds all
+  standard non-Python and Python packages that have not been disabled).
+  To disable building the wheelhouse, you can use::
+
+    export SAGE_CONF_TARGETS=build-local
+
+
+passagemath-conf in the traditional installation as Sage-the-distribution
+-------------------------------------------------------------------------
+
+The original version of the distribution package ``passagemath-conf`` is used
+internally in Sage-the-distribution.  It is provided in the directory
+`pkgs/sage-conf <https://github.com/passagemath/passagemath/tree/main/pkgs/sage-conf/>`_.
+This version of the package is generated by the Sage distribution's ``./configure``
+script.
+
+
+passagemath-conf for conda
+--------------------------
+
+The version of the distribution package in the directory
+`pkgs/sage-conf_conda <https://github.com/passagemath/passagemath/tree/main/pkgs/sage-conf_conda/>`_
+may be used in an installation method of SageMath, where all packages
+are provided by conda.  This method is described in
+https://doc.sagemath.org/html/en/installation/conda.html#using-conda-to-provide-all-dependencies-for-the-sage-library-experimental
+
+
+passagemath-conf in downstream distributions
+--------------------------------------------
+
+If the customization through the environment variables ``SAGE_CONF_...``
+does not give enough flexibility, downstream packagers and advanced developers
+and users can provide their own implementation of the distribution package
+to support the intended deployment of the SageMath library.
+
+
+License
+-------
+
+GNU General Public License (GPL) v3 or later
+
+Upstream Contact
+----------------
+
+This package is included in the main repository of passagemath
+in `pkgs/sage-conf* <https://github.com/passagemath/passagemath/tree/main/pkgs/>`_.
+
+Type
+----
+
+standard
+
+
+Dependencies
+------------
+
+- $(PYTHON)
+- $(PYTHON_TOOLCHAIN)
+
+Version Information
+-------------------
+
+package-version.txt::
+
+    10.5.28
+
+version_requirements.txt::
+
+    passagemath-conf ~= 10.5.28.0
+
+
+Equivalent System Packages
+--------------------------
+
+(none known)
+

passagemath_doc_pdf-10.5.28/doc/en/reference/spkg/sage_docbuild.rst

@@ -0,0 +1,89 @@
+.. _spkg_sage_docbuild:
+
+==========================================================================================
+sage_docbuild: Build system of the Sage documentation
+==========================================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <:issue:`29705`>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This is the build system of the Sage documentation, based on Sphinx.
+
+Type
+----
+
+standard
+
+
+Dependencies
+------------
+
+- $(PYTHON)
+- $(PYTHON_TOOLCHAIN)
+- sagelib
+- :ref:`spkg_sphinx`
+
+Version Information
+-------------------
+
+package-version.txt::
+
+    10.5.28
+
+version_requirements.txt::
+
+    passagemath-docbuild ~= 10.5.28.0
+
+
+Equivalent System Packages
+--------------------------
+
+
+See https://repology.org/project/sage-docbuild/versions, https://repology.org/project/python:sage-docbuild/versions
+
+However, these system packages will not be used for building Sage
+because ``spkg-configure.m4`` has not been written for this package;
+see :issue:`27330` for more information.
+

{passagemath_doc_pdf-10.5.26 → passagemath_doc_pdf-10.5.28}/doc/en/reference/spkg/sage_setup.rst

@@ -25,11 +25,11 @@ Version Information
 
 package-version.txt::
 
-    10.5.26
+    10.5.28
 
 version_requirements.txt::
 
-    passagemath-setup ~= 10.5.26.0
+    passagemath-setup ~= 10.5.28.0
 
 
 Equivalent System Packages

{passagemath_doc_pdf-10.5.26 → passagemath_doc_pdf-10.5.28}/doc/en/reference/spkg/sage_sws2rst.rst

@@ -30,11 +30,11 @@ Version Information
 
 package-version.txt::
 
-    10.5.26
+    10.5.28
 
 version_requirements.txt::
 
-    passagemath-sws2rst ~= 10.5.26.0
+    passagemath-sws2rst ~= 10.5.28.0
 
 
 Equivalent System Packages

passagemath_doc_pdf-10.5.28/doc/en/reference/spkg/sagemath_benzene.rst

@@ -0,0 +1,123 @@
+.. _spkg_sagemath_benzene:
+
+=========================================================================================
+sagemath_benzene: Generate fusene and benzenoid graphs with benzene
+=========================================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <:issue:`29705`>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This pip-installable distribution ``passagemath-benzene`` provides an interface
+to benzene, a program for the efficient generation of all nonisomorphic
+fusenes and benzenoids with a given number of faces.
+
+
+What is included
+----------------
+
+* Binary wheels on PyPI contain prebuilt copies of the benzene executable.
+
+
+Examples
+--------
+
+Using the benzene program on the command line::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-benzene[test]" sage -sh -c benzene
+
+Finding the installation location of the benzene program::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-benzene[test]" ipython
+
+    In [1]: from sage.features.graph_generators import Benzene
+
+    In [2]: Benzene().absolute_filename()
+    Out[2]: '.../bin/benzene'
+
+Using the Python interface::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-benzene[test]" ipython
+
+    In [1]: from sage.all__sagemath_benzene import *
+
+    In [2]: len(list(graphs.fusenes(9, benzenoids=True)))
+    Out[2]: 6505
+
+Type
+----
+
+optional
+
+
+Dependencies
+------------
+
+- $(PYTHON)
+- $(PYTHON_TOOLCHAIN)
+- :ref:`spkg_benzene`
+- :ref:`spkg_cysignals`
+- :ref:`spkg_cython`
+- :ref:`spkg_pkgconfig`
+- :ref:`spkg_sage_conf`
+- :ref:`spkg_sage_setup`
+- :ref:`spkg_sagemath_environment`
+
+Version Information
+-------------------
+
+package-version.txt::
+
+    10.5.28
+
+version_requirements.txt::
+
+    passagemath-benzene ~= 10.5.28.0
+
+
+Equivalent System Packages
+--------------------------
+
+(none known)
+

passagemath_doc_pdf-10.5.28/doc/en/reference/spkg/sagemath_bliss.rst

@@ -0,0 +1,103 @@
+.. _spkg_sagemath_bliss:
+
+========================================================================================
+sagemath_bliss: Graph (iso/auto)morphisms with bliss
+========================================================================================
+
+`passagemath <https://github.com/passagemath/passagemath>`__ is open
+source mathematical software in Python, released under the GNU General
+Public Licence GPLv2+.
+
+It is a fork of `SageMath <https://www.sagemath.org/>`__, which has been
+developed 2005-2025 under the motto “Creating a Viable Open Source
+Alternative to Magma, Maple, Mathematica, and MATLAB”.
+
+The passagemath fork was created in October 2024 with the following
+goals:
+
+-  providing modularized installation with pip, thus completing a `major
+   project started in 2020 in the Sage
+   codebase <:issue:`29705`>`__,
+-  establishing first-class membership in the scientific Python
+   ecosystem,
+-  giving `clear attribution of upstream
+   projects <https://groups.google.com/g/sage-devel/c/6HO1HEtL1Fs/m/G002rPGpAAAJ>`__,
+-  providing independently usable Python interfaces to upstream
+   libraries,
+-  providing `platform portability and integration testing
+   services <https://github.com/passagemath/passagemath/issues/704>`__
+   to upstream projects,
+-  inviting collaborations with upstream projects,
+-  `building a professional, respectful, inclusive
+   community <https://groups.google.com/g/sage-devel/c/xBzaINHWwUQ>`__,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://doc.sagemath.org/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support all major Linux distributions and recent versions of
+macOS. Use on Windows currently requires the use of Windows Subsystem for Linux or
+virtualization.
+
+Complete sets of binary wheels are provided on PyPI for Python versions 3.9.x-3.12.x.
+Python 3.13.x is also supported, but some third-party packages are still missing wheels,
+so compilation from source is triggered for those.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This pip-installable source distribution ``sagemath-bliss`` is a small
+optional distribution for use with ``sagemath-standard``.
+
+It provides a Cython interface to the ``bliss`` library for the purpose
+of computing graph (iso/auto)morphisms.
+
+Type
+----
+
+optional
+
+
+Dependencies
+------------
+
+- $(PYTHON)
+- $(PYTHON_TOOLCHAIN)
+- :ref:`spkg_bliss`
+- :ref:`spkg_cysignals`
+- :ref:`spkg_cython`
+- :ref:`spkg_pkgconfig`
+- :ref:`spkg_sage_conf`
+- :ref:`spkg_sage_setup`
+- :ref:`spkg_sagemath_environment`
+
+Version Information
+-------------------
+
+package-version.txt::
+
+    10.5.28
+
+version_requirements.txt::
+
+    passagemath-bliss ~= 10.5.28.0
+
+
+Equivalent System Packages
+--------------------------
+
+.. tab:: conda-forge
+
+   .. CODE-BLOCK:: bash
+
+       $ conda install sagemath-bliss 
+
+
+
+However, these system packages will not be used for building Sage
+because ``spkg-configure.m4`` has not been written for this package;
+see :issue:`27330` for more information.
+