Como obtener decimal.py si tienes Python 2.3.x

[Batista, Facundo]

Como obtener decimal.py si tengo Python 2.3.x
=============================================

A continuación muestro como instalar el módulo decimal.py en su Python
2.3.x.

Este módulo viene con la distribución estándar de Python 2.4 y superiores;
en estos casos no necesita bajarlo aparte. Note que decimal no está
oficialmente soportado para versiones de Python 2.2 y anteriores.


Bajando los archivos necesarios
-------------------------------

Para este paso, puede tomar dos caminos diferentes: bajar un instalador del
módulo, o bajar los archivos por separado.

En el primer caso, el procedimiento es más sencillo, pero quizás no obtenga
la versión más reciente. En el segundo caso, el procedimiento consta de más
pasos pero se asegurará de bajar la versión más reciente del módulo.


Usando el instalador
^^^^^^^^^^^^^^^^^^^^

Vaya a http://sourceforge.net/projects/sigefi, entre a la parte de File
Releases y elija que tipo de paquete desea bajar:

- ``decimal-x.x.win32.exe``: Solamente para Windows.
- ``decimal-x.x-x.rpm``: Para las distribuciones Linux que soportan
instaladores RPM.
- ``decimal-x.x.tar.gz``: Instalador más simple y general (debería funcionar
en cualquier lado que tenga instalado Python).

En el primer caso, simplemente ejecute el instalador. En el segundo caso,
haga ``rpm -i decimal-x.x-x.rpm`` siendo root. 

En el tercer caso, tambien siendo root, descomprima y desarme el paquete,
vaya al directorio creado y ejecute el instalador::

    gunzip decimal-x.x.tar.gz
    tar -xf decimal-x.x.tar
    cd decimal-x.x
    python setup.py install


Bajando los archivos por separado
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

El módulo decimal consta de un sólo archivo: decimal.py, el cual puede bajar
del CVS de Python:

 
http://cvs.sourceforge.net/viewcvs.py/python/python/dist/src/Lib/decimal.py
    
Este archivo debe ser ubicado en el directorio ``site-packages`` de su
instalación de Python (por ejemplo, en ``C:\Python23\FIXME\site-packages`` o
en ``/usr/lib/python2.3/site-packages``). Note que quizás necesite
privilegios de administrador para poder ubicarlo allí.

Para probar la instalación necesita archivos adicionales: el test_decimal.py
y los archivos de prueba (dentro de un directorio), que puede bajar también
del CVS:

 
http://cvs.sourceforge.net/viewcvs.py/python/python/dist/src/Lib/test/test_d
ecimal.py
 
http://cvs.sourceforge.net/viewcvs.py/python/python/dist/src/Lib/test/decima
ltestdata/
    

Verificando que todo esté correcto
----------------------------------

Si eligió el tercer método de instalación, en el lugar que ejecutó el
instalador tendrá un directorio ``test``. Si bajó los archivos por separado,
deberá tener en un directorio de prueba el archivo ``test_decimal.py`` (el
directorio puede ser cualquiera, el que desee) y ahí mismo un directorio
``decimaltestdata``.

En cualquiera de los dos casos, entre al directorio de prueba y ejecute las
pruebas con::

    python test_decimal.py

Verá un montón de mensajes mientra se prueban las distintas partes del
módulo, terminando con un mensaje similar a::

    OK
    doctest (decimal) ... nn tests with zero failures

Si hay algún problema con las pruebas, por favor contacte a los
desarrolladores.


Documentación
-------------

En el lugar donde ejecutó el instalador tendrá un directorio llamado
``docs``. Dentro del mismo está la documentación en varios formatos:

- HTML: Abra el ``index.html`` con su navegador preferido.
- Tex: En el archivo ``libdecimal.tex`` están las fuentes de la
documentación.

El archivo .tex fue extraído del CVS de Python, y los htmls fueron extraídos
de la documentación on-line de Python (modificados para que todos los
enlaces relativos a Decimal apunten a los archivos bajados).

Puede también consultar la documentación via web en
http://www.python.org/dev/doc/devel/lib/module-decimal.html.