cpython

History

Charlie Zhao fb0d9b9ac1 gh-106078: Convert `_decimal` types to heap types (#106079 ) - Establish global state struct - Convert static types to heap types and add them to global state: * PyDecContextManager_Type * PyDecContext_Type * PyDecSignalDictMixin_Type * PyDec_Type - Add to global state: * PyDecSignalDict_Type * DecimalTuple Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com> Co-authored-by: Erlend E. Aasland <erlend@python.org>		2023-06-29 10:27:20 +00:00
..
libmpdec	gh-77532: Minor tweaks to allow compiling with PlatformToolset=ClangCL on Windows (GH-101352)	2023-01-27 14:45:08 +00:00
tests	gh-92584: test_decimal uses shutil.which() (#92640 )	2022-05-11 01:42:09 +02:00
README.txt	Remove trailing whitespace.	2013-01-16 15:16:10 +01:00
_decimal.c	gh-106078: Convert `_decimal` types to heap types (#106079 )	2023-06-29 10:27:20 +00:00
docstrings.h	gh-91291: Accept attributes as keyword arguments in decimal.localcontext (#32242 )	2022-04-21 21:27:15 -07:00

README.txt


About
=====

_decimal.c is a wrapper for the libmpdec library. libmpdec is a fast C
library for correctly-rounded arbitrary precision decimal floating point
arithmetic. It is a complete implementation of Mike Cowlishaw/IBM's
General Decimal Arithmetic Specification.


Build process for the module
============================

As usual, the build process for _decimal.so is driven by setup.py in the top
level directory. setup.py autodetects the following build configurations:

   1) x64         - 64-bit Python, x86_64 processor (AMD, Intel)

   2) uint128     - 64-bit Python, compiler provides __uint128_t (gcc)

   3) ansi64      - 64-bit Python, ANSI C

   4) ppro        - 32-bit Python, x86 CPU, PentiumPro or later

   5) ansi32      - 32-bit Python, ANSI C

   6) ansi-legacy - 32-bit Python, compiler without uint64_t

   7) universal   - Mac OS only (multi-arch)


It is possible to override autodetection by exporting:

   PYTHON_DECIMAL_WITH_MACHINE=value, where value is one of the above options.


NOTE
====

decimal.so is not built from a static libmpdec.a since doing so led to
failures on AIX (user report) and Windows (mixing static and dynamic CRTs
causes locale problems and more).