.. _spkg_gmpy2:

gmpy2: Python interface to GMP/MPIR, MPFR, and MPC
==================================================

Description
-----------

GMP/MPIR, MPFR, and MPC interface to Python 2.6+ and 3.x

gmpy2 is a C-coded Python extension module that supports
multiple-precision arithmetic. In addition to supporting GMP or MPIR for
multiple-precision integer and rational arithmetic, gmpy2 adds support
for the MPFR (correctly rounded real floating-point arithmetic) and MPC
(correctly rounded complex floating-point arithmetic) libraries.

Type
----

standard


Dependencies
------------

- $(PYTHON)
- $(MP_LIBRARY)
- :ref:`spkg_mpfr`
- :ref:`spkg_mpc`
- $(PYTHON_TOOLCHAIN)

Version Information
-------------------

package-version.txt::

    2.1.1

install-requires.txt::

    gmpy2 >=2.1.0


Equivalent System Packages
--------------------------

conda:

.. CODE-BLOCK:: bash

    $ conda install  gmpy2


macports:
install the following packages: py-gmpy2

void:

.. CODE-BLOCK:: bash

    $ sudo xbps-install  python3-gmpy2


See https://repology.org/project/python:gmpy2/versions, https://repology.org/project/python:gmpy2-devel/versions


However, these system packages will not be used for building Sage
because using Python site-packages is not supported by the Sage distribution;
see :trac:`29023`

