passagemath-eclib 10.6.40__cp314-cp314t-macosx_13_0_x86_64.whl

passagemath_eclib/__init__.py

@@ -0,0 +1,3 @@
+# sage_setup: distribution = sagemath-eclib
+
+from sage.all__sagemath_eclib import *

passagemath_eclib-10.6.40.dist-info/METADATA

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: passagemath-eclib
+Version: 10.6.40
+Summary: passagemath: Elliptic curves over the rationals with eclib/mwrank
+Author-email: The Sage Developers <sage-support@googlegroups.com>
+Maintainer: Matthias Köppe, passagemath contributors
+License-Expression: GPL-2.0-or-later
+Project-URL: release notes, https://github.com/passagemath/passagemath/releases
+Project-URL: repo (upstream), https://github.com/sagemath/sage
+Project-URL: repo, https://github.com/passagemath/passagemath
+Project-URL: documentation, https://passagemath.org/docs/latest
+Project-URL: homepage (upstream), https://www.sagemath.org
+Project-URL: discourse, https://passagemath.discourse.group
+Project-URL: tracker (upstream), https://github.com/sagemath/sage/issues
+Project-URL: tracker, https://github.com/passagemath/passagemath/issues
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/x-rst
+Requires-Dist: passagemath-linbox~=10.6.40.0
+Requires-Dist: passagemath-modules~=10.6.40.0
+Requires-Dist: passagemath-ntl~=10.6.40.0
+Requires-Dist: memory_allocator
+Requires-Dist: cysignals!=1.12.4; sys_platform == "win32"
+Requires-Dist: cysignals!=1.12.0,>=1.11.2
+Provides-Extra: test
+Requires-Dist: passagemath-repl; extra == "test"
+Requires-Dist: passagemath-schemes; extra == "test"
+
+==============================================================================================
+ passagemath: Elliptic curves over the rationals with eclib/mwrank
+==============================================================================================
+
+`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 uses the motto "Creating a Free Passage Between the
+Scientific Python Ecosystem and Mathematical Software Communities."
+It was created in October 2024 with the following goals:
+
+-  providing modularized installation with pip,
+-  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,
+-  offering `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>`__,
+-  `empowering Sage users to participate in the scientific Python ecosystem
+   <https://github.com/passagemath/passagemath/issues/248>`__ by publishing packages,
+-  developing a port to `Pyodide <https://pyodide.org/en/stable/>`__ for
+   serverless deployment with Javascript,
+-  developing a native Windows port.
+
+`Full documentation <https://passagemath.org/docs/latest/html/en/index.html>`__ is
+available online.
+
+passagemath attempts to support and provides binary wheels suitable for
+all major Linux distributions and recent versions of macOS.
+
+Binary wheels for native Windows (x86_64) are are available for a subset of
+the passagemath distributions. Use of the full functionality of passagemath
+on Windows currently requires the use of Windows Subsystem for Linux (WSL)
+or virtualization.
+
+The supported Python versions in the passagemath 10.6.x series are 3.10.x-3.13.x.
+
+
+About this pip-installable distribution package
+-----------------------------------------------
+
+This pip-installable distribution ``passagemath-eclib`` provides the
+Cython interface to John Cremona's programs for enumerating and computing
+with elliptic curves defined over the rational numbers.
+
+
+What is included
+----------------
+
+- `Sage interface to Cremona’s eclib library (also known as mwrank) <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/interface.html>`_
+
+- `Cython interface to Cremona’s eclib library (also known as mwrank) <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/mwrank.html>`_
+
+- `Cremona matrices <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/mat.html>`_
+
+- `Modular symbols using eclib newforms <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/newforms.html>`_
+
+- `Cremona modular symbols <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/homspace.html>`_
+
+- `Cremona modular symbols (constructor) <https://passagemath.org/docs/latest/html/en/reference/libs/sage/libs/eclib/constructor.html>`_
+
+- `Interface to the mwrank program <https://passagemath.org/docs/latest/html/en/reference/interfaces/sage/interfaces/mwrank.html#module-sage.interfaces.mwrank>`_
+
+
+Examples
+--------
+
+A quick way to try it out interactively::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-eclib[test]" ipython
+
+    In [1]: from passagemath_eclib import *
+
+    In [2]: M = CremonaModularSymbols(43, cuspidal=True); M
+    Out[2]: Cremona Cuspidal Modular Symbols space of dimension 6 for Gamma_0(43) of weight 2 with sign 0
+
+Finding the installation location of the mwrank program::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-eclib" python
+    >>> from sage.features.eclib import Mwrank
+    >>> Mwrank().absolute_filename()
+    '.../bin/mwrank'
+
+Use with `sage.schemes.elliptic_curves <https://passagemath.org/docs/latest/html/en/reference/arithmetic_curves/index.html#elliptic-curves>`_::
+
+    $ pipx run --pip-args="--prefer-binary" --spec "passagemath-eclib[test]" ipython
+
+    In [1]: from passagemath_eclib import *
+
+    In [2]: x = polygen(ZZ, 'x')
+
+    In [3]: K = NumberField(x**2 + 23, 'a'); a = K.gen()
+
+    In [4]: E = EllipticCurve(K, [0,0,0,101,0])
+
+    In [5]: E.gens()
+
+
+Development
+-----------
+
+::
+
+    $ git clone --origin passagemath https://github.com/passagemath/passagemath.git
+    $ cd passagemath
+    passagemath $ ./bootstrap
+    passagemath $ python3 -m venv eclib-venv
+    passagemath $ source eclib-venv/bin/activate
+    (eclib-venv) passagemath $ pip install -v -e pkgs/sagemath-eclib

passagemath_eclib-10.6.40.dist-info/RECORD

@@ -0,0 +1,33 @@
+passagemath_eclib-10.6.40.dist-info/RECORD,,
+passagemath_eclib-10.6.40.dist-info/WHEEL,sha256=RVsjh5yijuLhpAeoj1rcJ6CnX6JK7wyaBksB-qUN_2E,155
+passagemath_eclib-10.6.40.dist-info/top_level.txt,sha256=0XP-a724JYuL7lNTHSaQ05dyR3Jxz-IUzAWaASLTSHE,24
+passagemath_eclib-10.6.40.dist-info/METADATA,sha256=OSO77mog7huY4mQRNli_gSsOPjtKVONRLdkx5g7iCes,7056
+passagemath_eclib/__init__.py,sha256=zMD8y2IByHS2O6bJW-aznIYrFHjoZtYxoYoqUos3YZ0,84
+passagemath_eclib/.dylibs/libntl.45.dylib,sha256=IIzBQ4o1SOL91ntdeLaFjmUWpc30AUdsUx0e1oPNNOY,2295376
+passagemath_eclib/.dylibs/libec.14.dylib,sha256=0DVG3lhHtfYejqlLL2Skzo5HRvAUM5zi5mu882fm7eU,3581040
+passagemath_eclib/.dylibs/libgf2x.3.dylib,sha256=Mum3EH7fP9F88Kg1vNVlev7kvPgeGq2rag2CxK0UN0Y,97424
+passagemath_eclib/.dylibs/libflint.22.0.dylib,sha256=RnifOX28gUA6YBA8poP_VWR-r38uiG6bTxsVKsAOSyM,10494912
+passagemath_eclib/.dylibs/libpari-gmp-tls.dylib,sha256=BRTkP35SDPGpceN64xTkPgguF-LHXakdoT4FXRT4I7U,10108944
+passagemath_eclib/.dylibs/libgmp.10.dylib,sha256=2xC1Z40d_Ifjv-41VxTFo65oGBuEuwCIkSDZMiyCjEA,488712
+passagemath_eclib/.dylibs/libmpfr.6.dylib,sha256=qNKLox_p8m4x4tpTtHSLTVnOlpMN9MH-gxcibf5W6Uk,465224
+sage_wheels/bin/mwrank,sha256=nJYk3Z9eiXW5f9nZ0U8EbHQVnOD83rIA4XrIskV0hjk,35544
+sage/all__sagemath_eclib.py,sha256=PnPfHmKUTc7cMx6GOd0BupMBdOugvB3CDOKnfLdfzFY,348
+sage/libs/all__sagemath_eclib.py,sha256=H84MU_RUF7AFi4kYwqjD7qf-5Ubp8p1JM0CQ3zQPEbM,497
+sage/libs/eclib/homspace.pyx,sha256=uzmWG8kKgH9NNAEx-Ym1JaW7UVUwoJ-jwsWdwh7jfw4,9653
+sage/libs/eclib/constructor.py,sha256=k4ug-84zOdPsVkcc0fQECuaXcxdWuK34j76U4n0k80Y,2962
+sage/libs/eclib/__init__.pxd,sha256=J-IK32oq6HIKmFTHYGbr4Q6EJ33Vcsv5YVeaD-9vyIo,4784
+sage/libs/eclib/newforms.pxd,sha256=7OmyBO8Tj8hncCdPAPHNLIS4axhZRM-rRYoyLjZ7-Mc,186
+sage/libs/eclib/mat.pyx,sha256=m1iEfSMrBFqBOZScc0LLbim3GgNJz5OTiEpDSmiyeG4,7316
+sage/libs/eclib/interface.py,sha256=bNn_mVlAJU9OxOQ_SvUfIlscFepNDIAf4qLi0YqTfac,50561
+sage/libs/eclib/__init__.py,sha256=VjiZlK64wgH3SQYvGUcepeTUQngHlgGRH90Uyv5LnSE,44
+sage/libs/eclib/newforms.cpython-314t-darwin.so,sha256=nas_5RzUS9pIGWi3HyK3b2w9E22s77SL9Lw94SQr2_U,104760
+sage/libs/eclib/all.py,sha256=Nwq0p-bytJLGjPQi9SA0ej_gnjDmhUYHsqr6owIimss,316
+sage/libs/eclib/homspace.cpython-314t-darwin.so,sha256=zgvUKXAJnYoGchYw5Cq7pj9VdGeDpaYkRusgD9X-6QI,94112
+sage/libs/eclib/newforms.pyx,sha256=sqx0yta_mul8McABIBlzK0Xj9COo-HFDM_zFCWtbKMc,15483
+sage/libs/eclib/mat.pxd,sha256=JXuI8yzgKxxGkVWfM5hNvr3I8bIu-HKzmNuddrV0Hf8,173
+sage/libs/eclib/mwrank.pyx,sha256=39FNEm22seSBoepMAUdf-aUT5DGVkErzqzFfun8BkqQ,43700
+sage/libs/eclib/homspace.pxd,sha256=snYcG_sEmIHuV1zAlVjXgYfCyJ_BIBRKplJ8dOVisMw,131
+sage/libs/eclib/mwrank.cpython-314t-darwin.so,sha256=Dm2pDTmTPQARN6joIUT--9bpxPGQCFJgHXfdkiqzp40,231960
+sage/libs/eclib/mat.cpython-314t-darwin.so,sha256=whZi0lLXVSHOloPB_Wwmzz-Vux7On5ijXDgtS2WU280,99264
+sage/interfaces/mwrank.py,sha256=y6lal269BI5a2Uvf35qN8ovvYikn3MRJ7_L_a2KU0a8,12478
+sage/interfaces/all__sagemath_eclib.py,sha256=VjiZlK64wgH3SQYvGUcepeTUQngHlgGRH90Uyv5LnSE,44

passagemath_eclib-10.6.40.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp314-cp314t-macosx_13_0_x86_64
+Generator: delocate 0.13.1.dev42+ga0af70b54
+

passagemath_eclib-10.6.40.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+
+passagemath_eclib
+sage

sage/all__sagemath_eclib.py

@@ -0,0 +1,17 @@
+# sage_setup: distribution = sagemath-eclib
+# delvewheel: patch
+
+try:
+    from sage.all__sagemath_repl import *
+except ImportError:
+    pass
+
+from sage.all__sagemath_modules import *
+from sage.all__sagemath_linbox import *
+
+try:
+    from sage.all__sagemath_schemes import *
+except ImportError:
+    pass
+
+from sage.libs.all__sagemath_eclib import *

sage/interfaces/all__sagemath_eclib.py

@@ -0,0 +1 @@
+# sage_setup: distribution = sagemath-eclib

sage/interfaces/mwrank.py

@@ -0,0 +1,370 @@
+# sage_setup: distribution = sagemath-eclib
+r"""
+Interface to mwrank
+"""
+
+# ****************************************************************************
+#       Copyright (C) 2005 William Stein <wstein@gmail.com>
+#
+#  Distributed under the terms of the GNU General Public License (GPL)
+#
+#    This code is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+#    General Public License for more details.
+#
+#  The full text of the GPL is available at:
+#
+#                  https://www.gnu.org/licenses/
+# ****************************************************************************
+
+import os
+import shlex
+import weakref
+
+from sage.features.eclib import Mwrank as mwrank_executable
+
+from .expect import Expect
+
+instances = {}
+
+
+def Mwrank(options='', server=None, server_tmpdir=None):
+    """
+    Create and return an mwrank interpreter, with given options.
+
+    INPUT:
+
+    - ``options`` -- string; passed when starting mwrank.
+      The format is::
+
+       -h       help            prints this info and quits
+       -q       quiet           turns OFF banner display and prompt
+       -v n     verbosity       sets verbosity to n (default=1)
+       -o       PARI/GP output  turns ON extra PARI/GP short output (default: OFF)
+       -p n     precision       sets precision to n decimals (default=15)
+       -b n     quartic bound   bound on quartic point search (default=10)
+       -x n     n aux           number of aux primes used for sieving (default=6)
+       -l       list            turns ON listing of points (default: ON, unless v=0)
+       -s       selmer_only     if set, computes Selmer rank only (default: not set)
+       -d       skip_2nd_descent        if set, skips the second descent for curves with 2-torsion (default: not set)
+       -S n     sat_bd          upper bound on saturation primes (default=100, -1 for automatic)
+
+    .. WARNING::
+
+       Do not use the option "-q" which turns off the prompt.
+
+    EXAMPLES::
+
+        sage: M = Mwrank('-v 0 -l')
+        sage: print(M('0 0 1 -1 0'))
+        Curve [0,0,1,-1,0] :    Rank = 1
+        Generator 1 is [0:-1:1]; height 0.051...
+        Regulator = 0.051...
+    """
+    global instances
+    try:
+        X = instances[options]()
+        if X:
+            return X
+    except KeyError:
+        pass
+    X = Mwrank_class(options, server=server, server_tmpdir=server_tmpdir)
+    instances[options] = weakref.ref(X)
+    return X
+
+
+import re
+# regex matching '[a1,a2,a3,a4,a6]', no spaces, each ai a possibly signed integer
+AINVS_LIST_RE = re.compile(r'\[[+-]?(\d+)(,[+-]?\d+){4}]')
+# regex matching ' a1 a2 a3 a4 a6 ', any whitespace, each ai a possibly signed integer
+AINVS_PLAIN_RE = re.compile(r'^(\s*)([+-]?(\d+)(\s+)){4}([+-]?(\d+))(\s*)$')
+
+
+def validate_mwrank_input(s):
+    r"""
+    Return a string suitable for mwrank input, or raises an error.
+
+    INPUT:
+
+    - ``s`` -- one of the following:
+
+        - a list or tuple of 5 integers [a1,a2,a3,a4,a6] or (a1,a2,a3,a4,a6)
+        - a string of the form '[a1,a2,a3,a4,a6]' or 'a1 a2 a3 a4 a6' where a1, a2, a3, a4, a6 are integers
+
+    OUTPUT:
+
+    For valid input, a string of the form '[a1,a2,a3,a4,a6]'.
+    For invalid input a :exc:`ValueError` is raised.
+
+    EXAMPLES:
+
+    A list or tuple of 5 integers::
+
+        sage: from sage.interfaces.mwrank import validate_mwrank_input
+        sage: validate_mwrank_input([1,2,3,4,5])
+        '[1, 2, 3, 4, 5]'
+        sage: validate_mwrank_input((-1,2,-3,4,-55))
+        '[-1, 2, -3, 4, -55]'
+        sage: validate_mwrank_input([1,2,3,4])
+        Traceback (most recent call last):
+        ...
+        ValueError: [1, 2, 3, 4] is not valid input to mwrank (should have 5 entries)
+        sage: validate_mwrank_input([1,2,3,4,i])
+        Traceback (most recent call last):
+        ...
+        ValueError: [1, 2, 3, 4, I] is not valid input to mwrank (entries should be integers)
+
+
+    A string of the form '[a1,a2,a3,a4,a6]' with any whitespace and integers ai::
+
+        sage: validate_mwrank_input('0 -1 1 -7 6')
+        '[0,-1,1,-7,6]'
+        sage: validate_mwrank_input("[0,-1,1,0,0]\n")
+        '[0,-1,1,0,0]'
+        sage: validate_mwrank_input('0\t -1\t 1\t 0\t 0\n')
+        '[0,-1,1,0,0]'
+        sage: validate_mwrank_input('0 -1 1 -7 ')
+        Traceback (most recent call last):
+        ...
+        ValueError: 0 -1 1 -7  is not valid input to mwrank
+    """
+    if isinstance(s, (list, tuple)):
+        from sage.rings.integer_ring import ZZ
+        if len(s) != 5:
+            raise ValueError("%s is not valid input to mwrank (should have 5 entries)" % s)
+        try:
+            ai = [ZZ(a) for a in s]
+            return str(ai)
+        except (TypeError, ValueError):
+            raise ValueError("%s is not valid input to mwrank (entries should be integers)" % s)
+
+    if isinstance(s, str):
+        if AINVS_PLAIN_RE.match(s):
+            ai = s.split()
+            return "[" + ",".join(ai) + "]"
+        ss = s.replace(' ', '').replace('\n', '').replace('\t', '')
+        if AINVS_LIST_RE.match(ss):
+            return ss
+    raise ValueError("%s is not valid input to mwrank" % s)
+
+
+class Mwrank_class(Expect):
+    """
+    Interface to the Mwrank interpreter.
+    """
+    def __init__(self, options='', server=None, server_tmpdir=None):
+        """
+        INPUT:
+
+        - ``options`` -- string; passed when starting mwrank.
+          The format is::
+
+           -h       help            prints this info and quits
+           -q       quiet           turns OFF banner display and prompt
+           -v n     verbosity       sets verbosity to n (default=1)
+           -o       PARI/GP output  turns ON extra PARI/GP short output (default: OFF)
+           -p n     precision       sets precision to n decimals (default=15)
+           -b n     quartic bound   bound on quartic point search (default=10)
+           -x n     n aux           number of aux primes used for sieving (default=6)
+           -l       list            turns ON listing of points (default: ON, unless v=0)
+           -s       selmer_only     if set, computes Selmer rank only (default: not set)
+           -d       skip_2nd_descent        if set, skips the second descent for curves with 2-torsion (default: not set)
+           -S n     sat_bd          upper bound on saturation primes (default=100, -1 for automatic)
+
+        .. WARNING::
+
+            Do not use the option "-q" which turns off the prompt.
+
+        .. NOTE::
+
+           Normally instances of this class would be created by
+           calling the global function :meth:`Mwrank`.
+
+        EXAMPLES::
+
+            sage: from sage.interfaces.mwrank import Mwrank_class
+            sage: M = Mwrank_class('-v 0 -l')
+            sage: M('0 -1 1 0 0')
+            'Curve [0,-1,1,0,0] :...Rank = 0...Regulator = 1...'
+
+            sage: from sage.interfaces.mwrank import Mwrank_class
+            sage: TestSuite(Mwrank_class).run()
+        """
+        Expect.__init__(self,
+                        name='mwrank',
+                        prompt='Enter curve: ',
+                        command=f"{shlex.quote(mwrank_executable().absolute_filename())} {options}",
+                        server=server,
+                        server_tmpdir=server_tmpdir,
+                        restart_on_ctrlc=True,
+                        verbose_start=False)
+
+    def __getattr__(self, attrname):
+        """
+        Standard function to return an attribute.
+
+        EXAMPLES::
+
+            sage: mwrank.zzz
+            Traceback (most recent call last):
+            ...
+            AttributeError
+        """
+        raise AttributeError
+
+    def __reduce__(self):
+        """
+        EXAMPLES::
+
+            sage: Mwrank().__reduce__()
+            (<function _reduce_load_mwrank at 0x...>, ())
+        """
+
+        return _reduce_load_mwrank, tuple([])
+
+    def __call__(self, cmd):
+        """
+        Interface to eval method.
+
+        INPUT:
+
+        - ``cmd`` A string, or Sage object which when converted to a
+          string gives valid input to ``mwrank``.  The conversion is
+          done by :meth:`validate_mwrank_input`.
+
+        EXAMPLES:
+
+        The input can be five integers separated by whitespace::
+
+            sage: mwrank('0 -1 1 0 0')
+            'Curve [0,-1,1,0,0] :...Basic pair: I=16, J=-304...'
+
+        Or a list or tuple of exactly five integers::
+
+            sage: s = mwrank([0,-1,1,0,0])
+            sage: "Rank = 0" in s and "been determined unconditionally" in s
+            True
+
+        TESTS:
+
+        Invalid input raises an :exc:`ValueError` (see :issue:`10108`); this
+        includes syntactically valid input which defines a singular curve::
+
+            sage: mwrank(10)
+            Traceback (most recent call last):
+            ...
+            ValueError: Invalid input: 10 is not valid input to mwrank
+
+            sage: mwrank('0 0 0 0 0')
+            Traceback (most recent call last):
+            ...
+            ValueError: Invalid input ([0,0,0,0,0]) to mwrank (singular curve)
+
+            sage: mwrank('0 0 0 -3 2')
+            Traceback (most recent call last):
+            ...
+            ValueError: Invalid input ([0,0,0,-3,2]) to mwrank (singular curve)
+        """
+        try:
+            s = validate_mwrank_input(cmd)
+        except ValueError as err:
+            raise ValueError("Invalid input: %s" % err)
+        try:
+            return self.eval(s)
+        except ValueError as err:
+            raise ValueError(err)
+        except RuntimeError:
+            raise ValueError(cmd)
+
+    def eval(self, s, **kwds):
+        """
+        Return mwrank's output for the given input.
+
+        INPUT:
+
+        - ``s`` -- string; a Sage object which when converted to a string
+          gives valid input to ``mwrank``.  The conversion is done by
+          :meth:`validate_mwrank_input`.  Possible formats are:
+
+          - a string representing exactly five integers separated by
+            whitespace, for example '1 2 3 4 5'
+
+          - a string representing exactly five integers separated by
+            commas, preceded by '[' and followed by ']' (with
+            arbitrary whitespace), for example '[1 2 3 4 5]'
+
+          - a list or tuple of exactly 5 integers.
+
+        .. NOTE::
+
+           If a :exc:`RuntimeError` exception is raised, then the mwrank
+           interface is restarted and the command is retried once.
+
+        EXAMPLES::
+
+            sage: mwrank.eval('12 3 4 5 6')
+            'Curve [12,3,4,5,6] :...'
+            sage: mwrank.eval('[12, 3, 4, 5, 6]')
+            'Curve [12,3,4,5,6] :...'
+            sage: mwrank.eval([12, 3, 4, 5, 6])
+            'Curve [12,3,4,5,6] :...'
+            sage: mwrank.eval((12, 3, 4, 5, 6))
+            'Curve [12,3,4,5,6] :...'
+        """
+        if self._expect is not None and not self._expect.isalive():
+            # if mwrank is interrupted twice in rapid succession,
+            # then it doesn't restart correctly, and we're left with:
+            #   "RuntimeError: [Errno 9] Bad file descriptor"
+            # Doing _start again fixes that always. See trac #5157.
+            self._start()
+        try:
+            ss = validate_mwrank_input(s)
+            return Expect.eval(self, ss, **kwds)
+        except ValueError as err:
+            raise ValueError('Invalid input: %s' % err)
+        except RuntimeError:
+            raise ValueError('Invalid input (%s) to mwrank (singular curve)' % s)
+
+    def console(self):
+        """
+        Start the mwrank console.
+
+        EXAMPLES::
+
+            sage: mwrank.console() # not tested: expects console input
+            Program mwrank: ...
+        """
+        mwrank_console()
+
+
+# An instance
+mwrank = Mwrank()
+
+
+def _reduce_load_mwrank():
+    """
+    Return the standard mwrank instance.
+
+    EXAMPLES::
+
+        sage: from sage.interfaces.mwrank import _reduce_load_mwrank
+        sage: _reduce_load_mwrank()
+        Mwrank
+    """
+    return mwrank
+
+
+def mwrank_console():
+    """
+    Start the mwrank console.
+
+    EXAMPLES::
+
+        sage: mwrank_console() # not tested: expects console input
+        Program mwrank: ...
+    """
+    from sage.repl.rich_output.display_manager import get_display_manager
+    if not get_display_manager().is_in_terminal():
+        raise RuntimeError('Can use the console only in the terminal. Try %%mwrank magics instead.')
+    os.system(f'{shlex.quote(mwrank_executable().absolute_filename())}')

sage/libs/all__sagemath_eclib.py

@@ -0,0 +1,11 @@
+# sage_setup: distribution = sagemath-eclib
+
+from sage.misc.lazy_import import lazy_import
+
+lazy_import('sage.libs.eclib.constructor', 'CremonaModularSymbols')
+lazy_import('sage.libs.eclib.interface', ['mwrank_EllipticCurve', 'mwrank_MordellWeil'])
+lazy_import('sage.libs.eclib.mwrank', 'get_precision', 'mwrank_get_precision')
+lazy_import('sage.libs.eclib.mwrank', 'set_precision', 'mwrank_set_precision')
+lazy_import('sage.libs.eclib.mwrank', 'initprimes', 'mwrank_initprimes')
+
+del lazy_import