# Qué hay de nuevo en Python 2.7

Autor:

  A.M. Kuchling (amk en amk.ca)

Este articulo explica las nuevas características en Python 2.7. Python 2.7 fue publicado el 3 de Julio de 2010.

El manejo numérico ha sido mejorado en muchas formas, tanto para los números de punto flotante como para la clase `Decimal`. Hay algunas adiciones útiles a la biblioteca estándar, como una gran mejora al modulo `unittest`, el modulo `argparse` para analizar las opciones de la línea de comandos, adecuando las clases `OrderedDict` y `Counter` en el modulo `collections`, y muchas otras mejoras.

Python 2.7 esta previsto que sea el ultimo lanzamiento de la serie 2.x, así que hemos trabajado para que sea una versión a largo plazo. Para ayudar con la migración a Python 3, se han incluido varias características nuevas de la serie Python 3.x en 2.7.

Este articulo no intenta proporcionar una especificación completa de las nuevas características, sino que proporciona una visión general conveniente. Para obtener mas información, debería consultar la documentación de Python 2.7 en https://docs.python.org. Si desea comprender la justificación para el diseño y la implementación, consultar el PEP para una nueva característica particular o el error en el que se discutió un cambio en https://bugs.python.org. Siempre que sea posible, «Que hay de nuevo en Python» enlaza el elemento error/parche para cada cambio.

## El futuro de Python 2.x

Python 2.7 es el último lanzamiento importante de la serie 2.x, ya que los mantenedores de Python han cambiado el enfoque de sus esfuerzos en el desarrollo de nuevas características para la serie de Python 3.x. Esto significa que mientras Python 2 continúe recibiendo corrección de errores, y sea actualizado para construir correctamente sobre nuevo hardware y versiones de sistemas operativos compatibles, no habrá nuevas versiones completas de funciones para el idioma o la biblioteca estándar.

Sin embargo, si bien existe un gran subconjunto común entre Python 2.7 y Python 3, y muchos de los cambios involucrados en la migración a ese subconjunto común, o directamente a Python 3, se pueden automatizar de manera segura, algunos otros cambios (en particular los asociados con el manejo de Unicode) puede requerir una consideración cuidadosa, y preferiblemente conjuntos de pruebas de regresión automatizada robustos, para migrar de manera efectiva.

Esto significa que Python 2.7 permanecerá en su lugar durante un largo tiempo, proporcionando una plataforma base estable y compatible para sistemas de producción que aún no se han adaptado a Python 3. La expectativa completa del ciclo de vida de la versión de Python 2.7 esta detallada en PEP 373.

Algunas consecuencias clave de la importancia a largo plazo de 2.7 son:

- Como se señalo anteriormente, la versión 2.7 tiene un período de mantenimiento mucho más largo en comparación con las versiones anteriores 2.x. Actualmente se espera que Python 2.7 siga siendo compatible con el equipo de desarrollo central (recibiendo actualizaciones de seguridad y otras correcciones de errores) al menos hasta 2020 (10 años después de su lanzamiento inicial, comparado con el típico periodo de mantenimiento de 18–24 meses).

- A medida que la biblioteca estándar de Python envejece, hacer un uso eficaz del índice de paquetes de Python (ya sea directamente o a través de un distribuidor) se vuelve mas importante para los usuarios de Python 2. Además de una amplia variedad de paquetes de terceros para diversas tareas, los paquetes disponibles incluyen backports de nuevos módulos y características de la biblioteca estándar de Python 3 que son compatibles con Python 2, así como varias herramientas y librerías que pueden hacer mas fácil la migración a Python 3. La Guía de usuario de paquetes de Python proporciona un información sobre como descargar e instalar software desde el índice de paquetes de Python.

- Aunque el enfoque preferido para mejorar Python 2 es ahora la publicación de nuevos paquetes en el índice de paquetes de Python, este enfoque no necesariamente funciona en todos los casos, especialmente aquellos relacionados a la seguridad de la red. En casos excepcionales que no puedan ser manejados adecuadamente mediante la publicación de nuevos paquetes o actualizaciones en PyPI, el proceso de propuestas de mejoras de Python podría ser usado para crear el caso para añadir nuevas funciones a la librería estándar de Python 2. Dichas adiciones, y las versiones de mantenimiento donde fueron agregadas, se observaran en la sección Nuevas funciones añadidas a las versiones de mantenimiento de Python 2.7 mas abajo.

Para los proyectos que deseen migrar de Python 2 a Python 3, o para los desarrolladores de frameworks y libreras que deseen dar soporte a usuarios en Python 2 y Python 3, hay una variedad de herramientas y guías disponibles para ayudarles a decidir sobre un enfoque adecuado y manejar algunos de los detalles técnicos involucrados. El punto de partida recomendado es la guía HOWTO How to port Python 2 Code to Python 3.

## Cambios en el manejo de las advertencias de desuso

Para Python 2.7, se tomo la decisión de silenciar las advertencias solo de interés para los desarrolladores de manera predeterminada. `DeprecationWarning`y sus descendientes son ahora ignoradas a menos que se solicite lo contrario, impidiendo a los usuarios estar viendo las advertencias disparadas por una aplicación. Este cambio se realizo en la rama que se convirtió en Python 3.2. (Discutido en stdlib-sig y llevado a cabo en :issue:`7319`).

En versiones previas, los mensajes `DeprecationWarning` estaban habilitados de manera predeterminada, proporcionando a los desarrolladores de Python una indicación clara de donde podría romperse su código en una futura versión principal de Python.

Sin embargo, cada vez hay más usuarios de aplicaciones basadas en Python que no están directamente involucrados en el desarrollo de esas aplicaciones. Los mensajes `DeprecationWarning` son irrelevantes para estos usuarios, hacen que se preocupen por una aplicación que realmente está funcionando correctamente y sobrecargando a los desarrolladores de aplicaciones con responder a estas preocupaciones.

Puede volver a habilitar la visualización de los mensajes `DeprecationWarning` ejecutando Python con el modificador `-Wdefault` (forma corta: `-Wd`), o estableciendo la variable de entorno `PYTHONWARNINGS` en `"default"` (o `"d"`) antes de ejecutar Python. El código Python también puede volver a habilitarlos llamando a `warnings.simplefilter('default')`.

El módulo `unittest` también vuelve a instalar automáticamente las advertencias de desuso al ejecutar pruebas.

## Características de Python 3.1

Al igual que Python 2.6 incorporó características de Python 3.0, la versión 2.7 incorpora algunas de las nuevas características de Python 3.1. La serie 2.x continúa proporcionando herramientas para migrar a la serie 3.x.

Una lista parcial de características 3.1 que se retro importaron a 2.7:

- La sintaxis para establecer literales (`{1,2,3}` es un conjunto mutable).

- Diccionario y establecimiento de compresiones (`{i: i*2 for i in range(3)}`).

- Múltiples administradores de contexto en una sola declaración `with`.

- Una nueva versión para la librería `io`, rescrito en C para un mejor desempeño.

- El tipo de ordenador de diccionario descrito en PEP 372: Adición de un diccionario ordenado a las colecciones.

- El nuevo especificador de formato `","` descrito en PEP 378: Especificador de formato para separador de miles.

- El objeto `memoryview`.

- Un pequeño subconjunto del modulo `importlib`, descrito abajo.

- La `repr()` de un flotante `x` es más corto en muchos casos: ahora se basa en la cadena decimal más corta que se garantiza que redondea a `x`. Como en versiones anteriores de Python, se garantiza que `float(repr(x))` retorne `x`.

- Las conversiones flotante a cadena y cadena a flotante se redondean correctamente. La función `round()` también ahora se redondea correctamente.

- El tipo `PyCapsule`, utilizado para proporcionar una API de C para módulos de extensión.

- La función de API de C `PyLong_AsLongAndOverflow()`.

Otras nuevas advertencias en modo Python3 incluyen:

- `operator.isCallable()` and `operator.sequenceIncludes()`, which are not supported in 3.x, now trigger warnings.

- El modificador `-3` ahora habilita automáticamente el modificador `-Qwarn` que provoca advertencias sobre el uso de la división clásica con enteros y enteros largos.

## PEP 372: Adición de un diccionario ordenado a las colecciones

Los diccionarios de python normales recorren en iteración los pares clave/valor en un orden arbitrario. A lo largo de los años, varios autores han escrito implementaciones alternativas que recuerdan el orden en que se insertaron originalmente las claves. Basado en las experiencias de esas implementaciones, 2.7 presenta una nueva clase `OrderedDict` en el módulo `collections`.

La API `OrderedDict` proporciona la misma interfaz que los diccionarios normales, pero recorre en iteración las claves y los valores en un orden garantizado en función de cuándo se insertó una clave por primera vez:

    >>> from collections import OrderedDict
    >>> d = OrderedDict([('first', 1),
    ...                  ('second', 2),
    ...                  ('third', 3)])
    >>> d.items()
    [('first', 1), ('second', 2), ('third', 3)]

Si una nueva entrada sobrescribe una entrada existente, la posición de inserción original no se modifica:

    >>> d['second'] = 4
    >>> d.items()
    [('first', 1), ('second', 4), ('third', 3)]

Borrando una entrada y luego reinsertándola, moverá la misma al final:

    >>> del d['second']
    >>> d['second'] = 5
    >>> d.items()
    [('first', 1), ('third', 3), ('second', 5)]

El método `popitem()` tiene un argumento last opcional que por defecto esta en `True` (verdadero). Si last es verdadero, la ultima llave ingresada es regresada y eliminada; si es falso, se selecciona la llave más antigua:

    >>> od = OrderedDict([(x,0) for x in range(20)])
    >>> od.popitem()
    (19, 0)
    >>> od.popitem()
    (18, 0)
    >>> od.popitem(last=False)
    (0, 0)
    >>> od.popitem(last=False)
    (1, 0)

La comparación de dos diccionarios ordenados comprueba tanto las claves como los valores, y requiere que el orden de inserción sea el mismo:

    >>> od1 = OrderedDict([('first', 1),
    ...                    ('second', 2),
    ...                    ('third', 3)])
    >>> od2 = OrderedDict([('third', 3),
    ...                    ('first', 1),
    ...                    ('second', 2)])
    >>> od1 == od2
    False
    >>> # Move 'third' key to the end
    >>> del od2['third']; od2['third'] = 3
    >>> od1 == od2
    True

Comparando a un `OrderedDict` con un diccionario normal ignora el orden de inserción y simplemente compara las llaves y los valores.

How does the `OrderedDict` work? It maintains a doubly linked list of keys, appending new keys to the list as they’re inserted. A secondary dictionary maps keys to their corresponding list node, so deletion doesn’t have to traverse the entire linked list and therefore remains O(1).

La biblioteca estándar ahora admite el uso de diccionarios ordenados en varios módulos.

- The `ConfigParser` module uses them by default, meaning that configuration files can now be read, modified, and then written back in their original order.

- El método `_asdict()` para `collections.namedtuple()` ahora retorna un diccionario ordenado con los valores que aparecen en el mismo orden que los índices de tupla subyacentes.

- El constructor de clase `JSONDecoder` del módulo `json` se amplió con un parámetro object_pairs_hook para permitir que el decodificador construya instancias `OrderedDict`. También se agregó soporte para herramientas de terceros como PyYAML.

Ver también

PEP 372 - Adición de un diccionario ordenado a las collections

  PEP escrito por Armin Ronacher y Raymond Hettinger; implementado por Raymond Hettinger.

## PEP 378: Especificador de formato para separador de miles

Para que la salida del programa sea más legible, puede ser útil agregar separadores a números grandes, representándolos como 18,446,744,073,709,551,616 en lugar de 18446744073709551616.

La solución totalmente general para hacer esto es el módulo `locale`, que puede utilizar diferentes separadores («,» en América del Norte, «.» en Europa) y diferentes tamaños de agrupación, pero `locale` es complicado de usar y no es adecuado para aplicaciones multiproceso donde diferentes hilos están produciendo resultados para diferentes configuraciones regionales.

Por lo tanto, se ha añadido un mecanismo simple de agrupación de comas al mini-lenguaje utilizado por el método `str.format()`. Al dar formato a un número de punto flotante, simplemente incluya una coma entre el ancho y la precisión:

    >>> '{:20,.2f}'.format(18446744073709551616.0)
    '18,446,744,073,709,551,616.00'

Al dar formato a un entero, incluya la coma después del ancho:

    >>> '{:20,d}'.format(18446744073709551616)
    '18,446,744,073,709,551,616'

Este mecanismo no es adaptable en absoluto; Las comas siempre se utilizan como separador y la agrupación siempre está en grupos de tres dígitos. El mecanismo de formato de coma no es tan general como el módulo `locale`, pero es más fácil de usar.

Ver también

PEP 378 - Especificador de formato para separador de miles

  PEP escrito por Raymond Hettinger; implementado por Eric Smith.

## PEP 389: El módulo argparse para el análisis de líneas de comando

El módulo `argparse` para analizar argumentos de línea de comandos se agregó como un reemplazo más potente para el módulo `optparse`.

This means Python now supports three different modules for parsing command-line arguments: `getopt`, `optparse`, and `argparse`. The `getopt` module closely resembles the C library’s `getopt()` function, so it remains useful if you’re writing a Python prototype that will eventually be rewritten in C. `optparse` becomes redundant, but there are no plans to remove it because there are many scripts still using it, and there’s no automated way to update these scripts. (Making the `argparse` API consistent with `optparse`’s interface was discussed but rejected as too messy and difficult.)

En resumen, si estás escribiendo un nuevo script y no necesitas preocuparte por la compatibilidad con versiones anteriores de Python, usa `argparse` en lugar de `optparse`.

Este es un ejemplo:

    import argparse

    parser = argparse.ArgumentParser(description='Command-line example.')

    # Add optional switches
    parser.add_argument('-v', action='store_true', dest='is_verbose',
                        help='produce verbose output')
    parser.add_argument('-o', action='store', dest='output',
                        metavar='FILE',
                        help='direct output to FILE instead of stdout')
    parser.add_argument('-C', action='store', type=int, dest='context',
                        metavar='NUM', default=0,
                        help='display NUM lines of added context')

    # Allow any number of additional arguments.
    parser.add_argument(nargs='*', action='store', dest='inputs',
                        help='input filenames (default is stdin)')

    args = parser.parse_args()
    print args.__dict__

A menos que lo reemplace, los modificadores `-h` y `--help` se agregan automáticamente, y producen una salida con formato ordenado:

    -> ./python.exe argparse-example.py --help
    usage: argparse-example.py [-h] [-v] [-o FILE] [-C NUM] [inputs [inputs ...]]

    Command-line example.

    positional arguments:
      inputs      input filenames (default is stdin)

    optional arguments:
      -h, --help  show this help message and exit
      -v          produce verbose output
      -o FILE     direct output to FILE instead of stdout
      -C NUM      display NUM lines of added context

Al igual que con `optparse`, los modificadores y argumentos de línea de comandos se retornan como un objeto con atributos denominados por los parámetros dest:

    -> ./python.exe argparse-example.py -v
    {'output': None,
     'is_verbose': True,
     'context': 0,
     'inputs': []}

    -> ./python.exe argparse-example.py -v -o /tmp/output -C 4 file1 file2
    {'output': '/tmp/output',
     'is_verbose': True,
     'context': 4,
     'inputs': ['file1', 'file2']}

`argparse` tiene una validación mucho más fantasiosa que `optparse`; puede especificar un número exacto de argumentos como un entero, 0 o más argumentos pasando `'*'`, 1 o más pasando `'+'`, o un argumento opcional con `'?'`. Un analizador de nivel superior puede contener sub analizadores para definir subcomandos que tienen diferentes conjuntos de modificadores, como en `svn commit`, `svn checkout`, etc. Puede especificar el tipo de un argumento como `FileType`, que abrirá automáticamente los archivos y entiende que `'-'` significa entrada o salida estándar.

Ver también

`argparse` documentación

  La página de documentación del módulo argparse.

Actualizar el código de optparse

  Parte de la documentación de Python, que describe cómo convertir código que usa `optparse`.

PEP 389 - argparse - Nuevo módulo de análisis de línea de comandos

  PEP escrito e implementado por Steven Bethard.

## PEP 391: Configuración basada en diccionarios para el registro

El módulo `logging` es muy flexible; las aplicaciones pueden definir un árbol de subsistemas de registro, y cada registrador de este árbol puede filtrar ciertos mensajes, formatearlos de forma diferente y dirigir mensajes a un número variable de controladores.

All this flexibility can require a lot of configuration. You can write Python statements to create objects and set their properties, but a complex set-up requires verbose but boring code. `logging` also supports a `fileConfig()` function that parses a file, but the file format doesn’t support configuring filters, and it’s messier to generate programmatically.

Python 2.7 adds a `dictConfig()` function that uses a dictionary to configure logging. There are many ways to produce a dictionary from different sources: construct one with code; parse a file containing JSON; or use a YAML parsing library if one is installed. For more information see Funciones de configuración.

En el ejemplo siguiente se configuran dos registradores, el registrador raíz y un registrador denominado «network». Los mensajes enviados al registrador raíz se enviarán al registro del sistema mediante el protocolo syslog, y los mensajes al registrador de la «network» se escribirán en un archivo `network.log` que se rotará una vez que el registro alcance 1MB.

    import logging
    import logging.config

    configdict = {
     'version': 1,    # Configuration schema in use; must be 1 for now
     'formatters': {
         'standard': {
             'format': ('%(asctime)s %(name)-15s '
                        '%(levelname)-8s %(message)s')}},

     'handlers': {'netlog': {'backupCount': 10,
                         'class': 'logging.handlers.RotatingFileHandler',
                         'filename': '/logs/network.log',
                         'formatter': 'standard',
                         'level': 'INFO',
                         'maxBytes': 1000000},
                  'syslog': {'class': 'logging.handlers.SysLogHandler',
                             'formatter': 'standard',
                             'level': 'ERROR'}},

     # Specify all the subordinate loggers
     'loggers': {
                 'network': {
                             'handlers': ['netlog']
                 }
     },
     # Specify properties of the root logger
     'root': {
              'handlers': ['syslog']
     },
    }

    # Set up configuration
    logging.config.dictConfig(configdict)

    # As an example, log two error messages
    logger = logging.getLogger('/')
    logger.error('Database not found')

    netlogger = logging.getLogger('network')
    netlogger.error('Connection failed')

Tres mejoras más pequeñas en el módulo `logging`, todas implementadas por Vinay Sajip, son:

- La clase `SysLogHandler` ahora admite syslogging a través de TCP. El constructor tiene un parámetro socktype que proporciona el tipo de socket que se va a usar, ya sea `socket.SOCK_DGRAM` para UDP o `socket.SOCK_STREAM` para TCP. El protocolo predeterminado sigue siendo UDP.

- Las instancias `Logger` ganaron un método `getChild()` que recupera un registrador descendiente mediante una ruta de acceso relativa. Por ejemplo, una vez que se recupera un registrador haciendo `log = getLogger('app')`, llamando `log.getChild('network.listen')` es equivalente a `getLogger('app.network.listen')`.

- The `LoggerAdapter` class gained an `isEnabledFor()` method that takes a level and returns whether the underlying logger would process a message of that level of importance.

Ver también

PEP 391 - Configuración basada en diccionarios para el registro

  PEP escrito e implementado por Vinay Sajip.

## PEP 3106: Vistas de diccionario

Los métodos de diccionarios `keys()`, `values()` y `items()` son diferentes en Python 3.x. Ellos regresan un objeto llamado view en lugar de una lista completamente materializada.

It’s not possible to change the return values of `keys()`, `values()`, and `items()` in Python 2.7 because too much code would break. Instead the 3.x versions were added under the new names `viewkeys()`, `viewvalues()`, and `viewitems()`.

    >>> d = dict((i*10, chr(65+i)) for i in range(26))
    >>> d
    {0: 'A', 130: 'N', 10: 'B', 140: 'O', 20: ..., 250: 'Z'}
    >>> d.viewkeys()
    dict_keys([0, 130, 10, 140, 20, 150, 30, ..., 250])

Las vistas se pueden iterar, pero las vistas de elementos y claves también se comportan como conjuntos. El operador `&` realiza la intersección y `|` realiza una unión:

    >>> d1 = dict((i*10, chr(65+i)) for i in range(26))
    >>> d2 = dict((i**.5, i) for i in range(1000))
    >>> d1.viewkeys() & d2.viewkeys()
    set([0.0, 10.0, 20.0, 30.0])
    >>> d1.viewkeys() | range(0, 30)
    set([0, 1, 130, 3, 4, 5, 6, ..., 120, 250])

La vista realiza un seguimiento del diccionario y su contenido cambia a medida que se modifica el diccionario:

    >>> vk = d.viewkeys()
    >>> vk
    dict_keys([0, 130, 10, ..., 250])
    >>> d[260] = '&'
    >>> vk
    dict_keys([0, 130, 260, 10, ..., 250])

Sin embargo, tenga en cuenta que no puede agregar o eliminar claves mientras está iterando sobre la vista:

    >>> for k in vk:
    ...     d[k*2] = k
    ...
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    RuntimeError: dictionary changed size during iteration

Puede usar los métodos de vista en el código en Python 2.x, y el convertidor 2to3 los cambiará a los métodos estándar `keys()`, `values()` y `items()`.

Ver también

PEP 3106 - Renovación dict.keys(), .values() y .items()

  PEP escrito por Guido van Rossum. Portado a 2.7 por Alexandre Vassalotti; bpo-1967.

## PEP 3137: El objeto memoryview

El objeto `memoryview` proporciona una vista del contenido de la memoria de otro objeto que coincide con la interfaz de tipo `bytes`.

    >>> import string
    >>> m = memoryview(string.letters)
    >>> m
    <memory at 0x37f850>
    >>> len(m)           # Returns length of underlying object
    52
    >>> m[0], m[25], m[26]   # Indexing returns one byte
    ('a', 'z', 'A')
    >>> m2 = m[0:26]         # Slicing returns another memoryview
    >>> m2
    <memory at 0x37f080>

El contenido de la vista se puede convertir en una cadena de bytes o una lista de números enteros:

    >>> m2.tobytes()
    'abcdefghijklmnopqrstuvwxyz'
    >>> m2.tolist()
    [97, 98, 99, 100, 101, 102, 103, ... 121, 122]
    >>>

Los objetos `memoryview` permiten modificar el objeto subyacente si es un objeto mutable.

    >>> m2[0] = 75
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    TypeError: cannot modify read-only memory
    >>> b = bytearray(string.letters)  # Creating a mutable object
    >>> b
    bytearray(b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ')
    >>> mb = memoryview(b)
    >>> mb[0] = '*'         # Assign to view, changing the bytearray.
    >>> b[0:5]              # The bytearray has been changed.
    bytearray(b'*bcde')
    >>>

Ver también

PEP 3137 - Bytes inmutables y búfer mutable

  PEP escrito por Guido van Rossum. Implementado por Travis Oliphant, Antoine Pitrou y otros. Portado a 2.7 por Antoine Pitrou; bpo-2396.

## Otros cambios de lenguaje

Algunos de los cambios mas pequeños hechos al núcleo del lenguaje de Python son:

- La sintaxis para literales de conjuntos se ha actualizado desde Python 3.x. Los corchetes se utilizan para rodear el contenido del conjunto mutable resultante; los literales de conjunto se distinguen de los diccionarios por no contener dos puntos ni valores. `{}` sigue representando un diccionario vacío; use `set()` para un conjunto vacío.

      >>> {1, 2, 3, 4, 5}
      set([1, 2, 3, 4, 5])
      >>> set() # empty set
      set([])
      >>> {}    # empty dict
      {}

  Portado por Alexandre Vassalotti; bpo-2335.

- El diccionario y las comprensiones de conjuntos son otra característica portada desde 3.x, que generaliza las comprensiones de listas / generadores para usar la sintaxis literal para conjuntos y diccionarios.

      >>> {x: x*x for x in range(6)}
      {0: 0, 1: 1, 2: 4, 3: 9, 4: 16, 5: 25}
      >>> {('a'*x) for x in range(6)}
      set(['', 'a', 'aa', 'aaa', 'aaaa', 'aaaaa'])

  Portado por Alexandre Vassalotti; bpo-2333.

- La declaración `with` ahora puede usar múltiples administradores de contexto en una declaración. Los administradores de contexto se procesan de izquierda a derecha y cada uno se trata como si comenzara una nueva declaración `with`. Esto significa que:

      with A() as a, B() as b:
          ... suite of statements ...

  es equivalente a:

      with A() as a:
          with B() as b:
              ... suite of statements ...

  The `contextlib.nested()` function provides a very similar function, so it’s no longer necessary and has been deprecated.

  (Propuesta en https://codereview.appspot.com/53094; implementado por Georg Brandl.)

- Las conversiones entre números de punto flotante y cadenas ahora se redondean correctamente en la mayoría de las plataformas. Estas conversiones ocurren en muchos lugares diferentes: `str()` en flotantes y números complejos; los constructores `float` y `complex`; formato numérico; serializar y deserializar flotantes y números complejos usando los módulos `marshal`, `pickle` y `json`; análisis de literales flotantes e imaginarios en código Python; y conversión `Decimal` a flotante.

  Relacionado con esto, el `repr()` de un número de punto flotante x ahora retorna un resultado basado en la cadena decimal más corta que se garantiza que se redondeará a x con el redondeo correcto (con el modo de redondeo round-half-to-even). Anteriormente, daba una cadena basada en redondear x a 17 dígitos decimales.

  La biblioteca de redondeo responsable de esta mejora funciona en Windows y en plataformas Unix utilizando los compiladores gcc, icc o suncc. Puede haber un pequeño número de plataformas donde no se puede garantizar el correcto funcionamiento de este código, por lo que el código no se utiliza en dichos sistemas. Puede averiguar qué código se está utilizando marcando `sys.float_repr_style`, que será `short` si el nuevo código está en uso y `legacy` si no lo está.

  Implementado por Eric Smith y Mark Dickinson, utilizando la biblioteca de David Gay’s `dtoa.c`; bpo-7117.

- Las conversiones de enteros largos y enteros regulares a punto flotante ahora redondean de forma diferente, retornando el número de punto flotante más cercano al número. Esto no importa para los enteros pequeños que se pueden convertir exactamente, pero para los números grandes que inevitablemente perderán precisión, Python 2.7 ahora se aproxima más. Por ejemplo, Python 2.6 calculaba lo siguiente:

      >>> n = 295147905179352891391
      >>> float(n)
      2.9514790517935283e+20
      >>> n - long(float(n))
      65535L

  El resultado de punto flotante de Python 2.7 es mayor, pero mucho más cerca del valor verdadero:

      >>> n = 295147905179352891391
      >>> float(n)
      2.9514790517935289e+20
      >>> n - long(float(n))
      -1L

  (Implementado por Mark Dickinson; bpo-3166.)

  La división de enteros también es más precisa en su comportamiento de redondeo. (También implementado por Mark Dickinson; bpo-1811.)

- Implicit coercion for complex numbers has been removed; the interpreter will no longer ever attempt to call a `__coerce__()` method on complex objects. (Removed by Meador Inge and Mark Dickinson; bpo-5211.)

- El método `str.format()` soporta ahora la numeración automática de los campos de sustitución. Esto hace que el uso de `str.format()` se asemeje más al uso del formateo `%s`:

      >>> '{}:{}:{}'.format(2009, 04, 'Sunday')
      '2009:4:Sunday'
      >>> '{}:{}:{day}'.format(2009, 4, day='Sunday')
      '2009:4:Sunday'

  La numeración automática toma los campos de izquierda a derecha, por lo que el primer especificador `{...}` utilizará el primer argumento de `str.format()`, el siguiente especificador utilizará el siguiente argumento, y así sucesivamente. No se puede mezclar la numeración automática con la explícita - o se numeran todos los campos del especificador o ninguno - pero se puede mezclar la numeración automática con los campos con nombre, como en el segundo ejemplo anterior. (Contribución de Eric Smith; bpo-5237.)

  Los números complejos ahora soportan correctamente el uso con `format()`, y por defecto están alineados a la derecha. La especificación de una precisión o separación por comas se aplica tanto a la parte real como a la imaginaria del número, pero la anchura de campo y la alineación especificadas se aplican a la totalidad de la salida resultante `1,5+3j`. (Contribución de Eric Smith; bpo-1588 y bpo-7988)

  El código de formato “F” ahora siempre formatea su salida utilizando caracteres en mayúsculas, por lo que ahora producirá “INF” y “NAN”. (Contribución de Eric Smith; bpo-3382.)

  A low-level change: the `object.__format__()` method now triggers a `PendingDeprecationWarning` if it’s passed a format string, because the `__format__()` method for `object` converts the object to a string representation and formats that. Previously the method silently applied the format string to the string representation, but that could hide mistakes in Python code. If you’re supplying formatting information such as an alignment or precision, presumably you’re expecting the formatting to be applied in some object-specific way. (Fixed by Eric Smith; bpo-7994.)

- The `int()` and `long()` types gained a `bit_length` method that returns the number of bits necessary to represent its argument in binary:

      >>> n = 37
      >>> bin(n)
      '0b100101'
      >>> n.bit_length()
      6
      >>> n = 2**123-1
      >>> n.bit_length()
      123
      >>> (n+1).bit_length()
      124

  (Contribución de Fredrik Johansson y Victor Stinner; bpo-3439.)

- La instrucción `import` ya no intentará una importación absoluta si se produce un error en una importación relativa (por ejemplo, `from .os import sep`). Esto corrige un error, pero posiblemente podría romper ciertas instrucciones `import` que solo funcionaban por accidente. (Arreglado por Meador Inge; bpo-7902.)

- It’s now possible for a subclass of the built-in `unicode` type to override the `__unicode__()` method. (Implemented by Victor Stinner; bpo-1583863.)

- El método `translate()` del tipo `bytearray` ahora acepta `None` como primer argumento. (Corregido por Georg Brandl; bpo-4759.)

- When using `@classmethod` and `@staticmethod` to wrap methods as class or static methods, the wrapper object now exposes the wrapped function as their `__func__` attribute. (Contributed by Amaury Forgeot d’Arc, after a suggestion by George Sakkis; bpo-5982.)

- Cuando se establecía un conjunto restringido de atributos utilizando `__slots__`, la eliminación de un atributo no establecido no lanzaba `AttributeError` como cabría esperar. Corregido por Benjamin Peterson; bpo-7604)

- Ahora se admiten dos nuevas codificaciones: «cp720», utilizada principalmente para el texto árabe; y «cp858», una variante de CP 850 que añade el símbolo del euro. (CP720 contribuido por Alexander Belchenko y Amaury Forgeot d’Arc en bpo-1616979; CP858 contribuido por Tim Hatch en bpo-8016)

- The `file` object will now set the `filename` attribute on the `IOError` exception when trying to open a directory on POSIX platforms (noted by Jan Kaliszewski; bpo-4764), and now explicitly checks for and forbids writing to read-only file objects instead of trusting the C library to catch and report the error (fixed by Stefan Krah; bpo-5677).

- El tokenizador de Python ahora traduce los finales de línea por sí mismo, por lo que la función incorporada `compile()` ahora acepta código que utilice cualquier convención de final de línea. Además, ya no requiere que el código termine en una nueva línea.

- Los paréntesis adicionales en las definiciones de función son ilegales en Python 3.x, lo que significa que se obtiene un error de sintaxis de `def f((x)): pass`. En el modo de advertencia Python3, Python 2.7 ahora advertirá sobre este uso no común. (Anotado por James Lingard; bpo-7362.)

- Ahora es posible crear referencias débiles a objetos de clase de estilo antiguo. Las clases de estilo nuevo siempre eran de referencia débil. (Corregido por Antoine Pitrou; bpo-8268.)

- Cuando se recicla un objeto de módulo, el diccionario del módulo ahora solo se borra si nadie más tiene una referencia al diccionario (bpo-7140).

### Cambios en el intérprete

Una nueva variable de entorno, `PYTHONWARNINGS`, permite controlar las advertencias. Debe establecerse en una cadena que contenga la configuración de advertencia, equivalente a las utilizadas con el modificador `-W`, separado por comas. (Contribuido por Brian Curtin; bpo-7301.)

For example, the following setting will print warnings every time they occur, but turn warnings from the `Cookie` module into an error. (The exact syntax for setting an environment variable varies across operating systems and shells.)

    export PYTHONWARNINGS=all,error:::Cookie:0

### Optimizaciones

Se han añadido varias mejoras de rendimiento:

- A new opcode was added to perform the initial setup for `with` statements, looking up the `__enter__()` and `__exit__()` methods. (Contributed by Benjamin Peterson.)

- El recolector de basura ahora funciona mejor para un patrón de uso común: cuando se asignan muchos objetos sin desasignar ninguno de ellos. Antes, la recogida de basura tardaba un tiempo cuadrático, pero ahora el número de recogidas de basura completas se reduce a medida que crece el número de objetos en el montón. La nueva lógica sólo realiza una pasada completa de recogida de basura cuando la generación intermedia ha sido recogida 10 veces y cuando el número de objetos supervivientes de la generación intermedia supera el 10% del número de objetos de la generación más antigua. (Sugerido por Martin von Löwis e implementado por Antoine Pitrou; bpo-4074.)

- El recolector de basura intenta evitar el seguimiento de contenedores simples que no pueden formar parte de un ciclo. En Python 2.7, esto es ahora cierto para tuplas y diccionarios que contienen tipos atómicos (como enteros, cadenas, etc.). Transitoriamente, un dict que contenga tuplas de tipos atómicos tampoco será rastreado. Esto ayuda a reducir el coste de cada recogida de basura al disminuir el número de objetos que debe considerar y recorrer el recolector. (Contribución de Antoine Pitrou; bpo-4688.)

- Los enteros largos se almacenan ahora internamente en base 2**15 o en base 2**30, determinándose la base en el momento de la construcción. Anteriormente, siempre se almacenaban en base 2**15. El uso de la base 2**30 proporciona mejoras significativas en el rendimiento de las máquinas de 64 bits, pero los resultados de las pruebas comparativas en las máquinas de 32 bits han sido contradictorios. Por lo tanto, el valor por defecto es utilizar la base 2**30 en máquinas de 64 bits y la base 2**15 en máquinas de 32 bits; en Unix, hay una nueva opción de configuración `--enable-big-digits` que puede utilizarse para anular este valor por defecto.

  Apart from the performance improvements this change should be invisible to end users, with one exception: for testing and debugging purposes there’s a new structseq `sys.long_info` that provides information about the internal format, giving the number of bits per digit and the size in bytes of the C type used to store each digit:

      >>> import sys
      >>> sys.long_info
      sys.long_info(bits_per_digit=30, sizeof_digit=4)

  (Contribución de Mark Dickinson; bpo-4258.)

  Otro conjunto de cambios hizo que los objetos largos fueran unos pocos bytes más pequeños: 2 bytes menos en sistemas de 32 bits y 6 bytes en los de 64 bits. (Contribución de Mark Dickinson; bpo-5260.)

- El algoritmo de división de enteros largos se ha hecho más rápido ajustando el bucle interno, haciendo desplazamientos en lugar de multiplicaciones, y arreglando una iteración extra innecesaria. Varias pruebas de referencia muestran un aumento de velocidad de entre el 50% a y el 150% en las divisiones de enteros largos y en las operaciones de módulo. (Contribución de Mark Dickinson; bpo-5512). Las operaciones a nivel de bit también son significativamente más rápidas (parche inicial de Gregory Smith; bpo-1087418).

- La implementación de `%` comprueba si el operando de la izquierda es una cadena de Python y lo convierte en un caso especial; esto resulta en un aumento de rendimiento del 1–3% p para aplicaciones que utilizan frecuentemente `%` con cadenas, como las bibliotecas de plantillas. (Implementado por Collin Winter; bpo-5176.)

- Las comprensiones de listas con una condición `if` se compilan en código de bytes más rápido. (Parche de Antoine Pitrou, portado a la 2.7 por Jeffrey Yasskin; bpo-4715)

- La conversión de un entero o un entero largo a una cadena decimal se ha hecho más rápida mediante la conversión en base 10 en lugar de utilizar una función de conversión generalizada que soporta bases arbitrarias. (Parche de Gawain Bolton; bpo-6713.)

- The `split()`, `replace()`, `rindex()`, `rpartition()`, and `rsplit()` methods of string-like types (strings, Unicode strings, and `bytearray` objects) now use a fast reverse-search algorithm instead of a character-by-character scan. This is sometimes faster by a factor of 10. (Added by Florent Xicluna; bpo-7462 and bpo-7622.)

- The `pickle` and `cPickle` modules now automatically intern the strings used for attribute names, reducing memory usage of the objects resulting from unpickling. (Contributed by Jake McGuire; bpo-5084.)

- The `cPickle` module now special-cases dictionaries, nearly halving the time required to pickle them. (Contributed by Collin Winter; bpo-5670.)

## Módulos nuevos y mejorados

Como en cada versión, la biblioteca estándar de Python ha recibido una serie de mejoras y correcciones de errores. Aquí hay una lista parcial de los cambios más notables, ordenados alfabéticamente por nombre de módulo. Consulta el archivo `Misc/NEWS` en el árbol de código fuente para una lista más completa de cambios, o mira los registros de Subversion para todos los detalles.

- La clase base de depuración del módulo `bdb` `Bdb` obtuvo una función para omitir módulos. El constructor ahora toma un iterable que contiene patrones de estilo glob como `django.*`; el depurador no entrará en los marcos de pila de un módulo que coincida con uno de estos patrones. (Aportado por Maru Newby tras una sugerencia de Senthil Kumaran; bpo-5142.)

- El módulo `binascii` soporta ahora la API del buffer, por lo que puede utilizarse con instancias de `memoryview` y otros objetos de buffer similares. (Tomado de la 3.x por Florent Xicluna; bpo-7703.)

- Updated module: the `bsddb` module has been updated from 4.7.2devel9 to version 4.8.4 of the pybsddb package. The new version features better Python 3.x compatibility, various bug fixes, and adds several new BerkeleyDB flags and methods. (Updated by Jesús Cea Avión; bpo-8156. The pybsddb changelog can be read at https://hg.jcea.es/pybsddb/file/tip/ChangeLog.)

- El módulo `bz2` de `BZ2File` ahora soporta el protocolo de gestión de contexto, por lo que se puede escribir `con bz2.BZ2File(...) como f:`. (Contribución de Hagen Fürstenau; bpo-3860.)

- Nueva clase: la clase `Counter` del módulo `collections` es útil para el recuento de datos. Las instancias de `Counter` se comportan mayoritariamente como los diccionarios, pero retornan cero si faltan claves en lugar de lanzar un `KeyError`:

      >>> from collections import Counter
      >>> c = Counter()
      >>> for letter in 'here is a sample of english text':
      ...   c[letter] += 1
      ...
      >>> c
      Counter({' ': 6, 'e': 5, 's': 3, 'a': 2, 'i': 2, 'h': 2,
      'l': 2, 't': 2, 'g': 1, 'f': 1, 'm': 1, 'o': 1, 'n': 1,
      'p': 1, 'r': 1, 'x': 1})
      >>> c['e']
      5
      >>> c['z']
      0

  Hay tres métodos adicionales de `Counter`. `most_common()` retorna los N elementos más comunes y sus recuentos. `elements()` retorna un iterador sobre los elementos contenidos, repitiendo cada elemento tantas veces como su recuento. `subtract()` toma un iterable y resta uno por cada elemento en lugar de sumarlo; si el argumento es un diccionario u otra `Counter`, los recuentos se restan.

      >>> c.most_common(5)
      [(' ', 6), ('e', 5), ('s', 3), ('a', 2), ('i', 2)]
      >>> c.elements() ->
         'a', 'a', ' ', ' ', ' ', ' ', ' ', ' ',
         'e', 'e', 'e', 'e', 'e', 'g', 'f', 'i', 'i',
         'h', 'h', 'm', 'l', 'l', 'o', 'n', 'p', 's',
         's', 's', 'r', 't', 't', 'x'
      >>> c['e']
      5
      >>> c.subtract('very heavy on the letter e')
      >>> c['e']    # Count is now lower
      -1

  Contribución de Raymond Hettinger; bpo-1696199.

  Nueva clase: `OrderedDict` se describe en la sección anterior PEP 372: Adición de un diccionario ordenado a las colecciones.

  Nuevo método: El tipo de datos `deque` tiene ahora un método `count()` que retorna el número de elementos contenidos igual al argumento suministrado x, y un método `reverse()` que invierte los elementos del deque en su lugar. `deque` también expone su longitud máxima como el atributo de sólo lectura `maxlen`. (Ambas características han sido añadidas por Raymond Hettinger)

  La clase `namedtuple` tiene ahora un parámetro opcional rename. Si rename es verdadero, los nombres de campo que no son válidos porque se han repetido o no son identificadores legales de Python serán renombrados a nombres legales que se derivan de la posición del campo dentro de la lista de campos:

      >>> from collections import namedtuple
      >>> T = namedtuple('T', ['field1', '$illegal', 'for', 'field2'], rename=True)
      >>> T._fields
      ('field1', '_1', '_2', 'field2')

  (Añadido por Raymond Hettinger; bpo-1818.)

  Finally, the `Mapping` abstract base class now returns `NotImplemented` if a mapping is compared to another type that isn’t a `Mapping`. (Fixed by Daniel Stutzbach; bpo-8729.)

- Constructors for the parsing classes in the `ConfigParser` module now take an allow_no_value parameter, defaulting to false; if true, options without values will be allowed. For example:

      >>> import ConfigParser, StringIO
      >>> sample_config = """
      ... [mysqld]
      ... user = mysql
      ... pid-file = /var/run/mysqld/mysqld.pid
      ... skip-bdb
      ... """
      >>> config = ConfigParser.RawConfigParser(allow_no_value=True)
      >>> config.readfp(StringIO.StringIO(sample_config))
      >>> config.get('mysqld', 'user')
      'mysql'
      >>> print config.get('mysqld', 'skip-bdb')
      None
      >>> print config.get('mysqld', 'unknown')
      Traceback (most recent call last):
        ...
      NoOptionError: No option 'unknown' in section: 'mysqld'

  (Contribución de Mats Kindahl; bpo-7005.)

- Deprecated function: `contextlib.nested()`, which allows handling more than one context manager with a single `with` statement, has been deprecated, because the `with` statement now supports multiple context managers.

- The `cookielib` module now ignores cookies that have an invalid version field, one that doesn’t contain an integer value. (Fixed by John J. Lee; bpo-3924.)

- La función `deepcopy()` del módulo `copy` ahora copiará correctamente los métodos de instancia vinculados. (Implementado por Robert Collins; bpo-1515.)

- El módulo `ctypes` ahora convierte siempre `None` a un puntero C `NULL` para los argumentos declarados como punteros. (Cambiado por Thomas Heller; bpo-4606.) La biblioteca subyacente libffi ha sido actualizada a la versión 3.0.9, que contiene varias correcciones para diferentes plataformas. (Actualizado por Matthias Klose; bpo-8142.)

- Nuevo método: la clase `timedelta` del módulo `datetime` ha ganado un método `total_seconds()` que retorna el número de segundos de la duración. (Contribución de Brian Quinlan; bpo-5788.)

- New method: the `Decimal` class gained a `from_float()` class method that performs an exact conversion of a floating-point number to a `Decimal`. This exact conversion strives for the closest decimal approximation to the floating-point representation’s value; the resulting decimal value will therefore still include the inaccuracy, if any. For example, `Decimal.from_float(0.1)` returns `Decimal('0.1000000000000000055511151231257827021181583404541015625')`. (Implemented by Raymond Hettinger; bpo-4796.)

  Comparing instances of `Decimal` with floating-point numbers now produces sensible results based on the numeric values of the operands. Previously such comparisons would fall back to Python’s default rules for comparing objects, which produced arbitrary results based on their type. Note that you still cannot combine `Decimal` and floating point in other operations such as addition, since you should be explicitly choosing how to convert between float and `Decimal`. (Fixed by Mark Dickinson; bpo-2531.)

  El constructor de `Decimal` acepta ahora números en coma flotante (añadido por Raymond Hettinger; bpo-8257) y caracteres Unicode no europeos, como los dígitos arábigos-índicos (contribución de Mark Dickinson; bpo-6595).

  La mayoría de los métodos de la clase `Context` ahora aceptan enteros así como instancias de `Decimal`; las únicas excepciones son los métodos `canonical()` y `is_canonical()`. (Parche de Juan José Conti; bpo-7633.)

  Cuando se utilizan instancias `Decimal` con el método `format()` de una cadena, la alineación por defecto era antes la izquierda. Esto se ha cambiado a la alineación derecha, que es más sensible para los tipos numéricos. (Cambiado por Mark Dickinson; bpo-6857.)

  Las comparaciones que implican un valor NaN de señalización (o `sNAN`) señalan ahora `InvalidOperation` en lugar de retornar silenciosamente un valor verdadero o falso dependiendo del operador de comparación. Los valores NaN silenciosos (o `NaN`) son ahora hashable. (Corregido por Mark Dickinson; bpo-7279.)

- El módulo `difflib` produce ahora una salida más compatible con las herramientas modernas diff/patch mediante un pequeño cambio, utilizando un carácter de tabulación en lugar de espacios como separador en la cabecera que da el nombre del fichero. (Corregido por Anatoly Techtonik; bpo-7585.)

- El comando Distutils `sdist` ahora siempre regenera el archivo `MANIFEST`, ya que aunque los archivos `MANIFEST.in` o `setup.py` no hayan sido modificados, el usuario podría haber creado algunos archivos nuevos que deberían ser incluidos. (Corregido por Tarek Ziadé; bpo-8688.)

- The `doctest` module’s `IGNORE_EXCEPTION_DETAIL` flag will now ignore the name of the module containing the exception being tested. (Patch by Lennart Regebro; bpo-7490.)

- The `email` module’s `Message` class will now accept a Unicode-valued payload, automatically converting the payload to the encoding specified by `output_charset`. (Added by R. David Murray; bpo-1368247.)

- La clase `Fraction` acepta ahora una instancia de float o `Decimal`, o dos números racionales, como argumentos para su constructor. (Implementado por Mark Dickinson; los racionales se añadieron en bpo-5812, y float/decimal en bpo-8294)

  Las comparaciones de ordenación (`<`, `<=`, `>`, `>=`) entre fracciones y números complejos ahora lanzan un `TypeError`. Esto corrige un descuido, haciendo que la `Fraction` coincida con los otros tipos numéricos.

- Nueva clase: `FTP_TLS` en el módulo `ftplib` proporciona conexiones FTP seguras utilizando la encapsulación TLS de la autenticación, así como las posteriores transferencias de control y datos. (Contribuido por Giampaolo Rodola; bpo-2054.)

  El método `storbinary()` para subidas binarias puede ahora reiniciar las subidas gracias a un parámetro rest añadido (parche de Pablo Mouzo; bpo-6845)

- New class decorator: `total_ordering()` in the `functools` module takes a class that defines an `__eq__()` method and one of `__lt__()`, `__le__()`, `__gt__()`, or `__ge__()`, and generates the missing comparison methods. Since the `__cmp__()` method is being deprecated in Python 3.x, this decorator makes it easier to define ordered classes. (Added by Raymond Hettinger; bpo-5479.)

  Nueva función: `cmp_to_key()` tomará una función de comparación de estilo antiguo que espera dos argumentos y retornará una nueva llamada que puede usarse como parámetro clave para funciones como `sorted()`, `min()` y `max()`, etc. El principal uso previsto es ayudar a hacer el código compatible con Python 3.x. (Añadido por Raymond Hettinger.)

- Nueva función: la `gc()` del módulo `is_tracked` retorna true si una instancia dada es rastreada por el recolector de basura, false en caso contrario. (Contribución de Antoine Pitrou; bpo-4688.)

- El módulo `gzip` `GzipFile` soporta ahora el protocolo de gestión de contexto, por lo que se puede escribir `con gzip.GzipFile(...) como f:` (contribución de Hagen Fürstenau; bpo-3860), y ahora implementa el ABC de `io.BufferedIOBase`, por lo que se puede envolver con `io.BufferedReader` para un procesamiento más rápido (contribución de Nir Aides; bpo-7471). Ahora también es posible anular la hora de modificación registrada en un archivo gzipped proporcionando una marca de tiempo opcional al constructor. (Contribución de Jacques Frechet; bpo-4272.)

  Los archivos en formato gzip pueden ser rellenados con bytes cero al final; el módulo `gzip` ahora consumirá estos bytes al final. (Corregido por Tadek Pietraszek y Brian Curtin; bpo-2846)

- New attribute: the `hashlib` module now has an `algorithms` attribute containing a tuple naming the supported algorithms. In Python 2.7, `hashlib.algorithms` contains `('md5', 'sha1', 'sha224', 'sha256', 'sha384', 'sha512')`. (Contributed by Carl Chenet; bpo-7418.)

- The default `HTTPResponse` class used by the `httplib` module now supports buffering, resulting in much faster reading of HTTP responses. (Contributed by Kristján Valur Jónsson; bpo-4879.)

  The `HTTPConnection` and `HTTPSConnection` classes now support a source_address parameter, a `(host, port)` 2-tuple giving the source address that will be used for the connection. (Contributed by Eldon Ziegler; bpo-3972.)

- The `ihooks` module now supports relative imports. Note that `ihooks` is an older module for customizing imports, superseded by the `imputil` module added in Python 2.0. (Relative import support added by Neil Schemenauer.)

- El módulo `imaplib` ahora soporta direcciones IPv6. (Contribución de Derek Morr; bpo-1655.)

- Nueva función: la `getcallargs()` del módulo `inspect` toma una llamada y sus argumentos posicionales y de palabra clave, y calcula qué parámetros de la llamada recibirán cada argumento, retornando un diccionario que asigna los nombres de los argumentos a sus valores. Por ejemplo:

      >>> from inspect import getcallargs
      >>> def f(a, b=1, *pos, **named):
      ...     pass
      ...
      >>> getcallargs(f, 1, 2, 3)
      {'a': 1, 'b': 2, 'pos': (3,), 'named': {}}
      >>> getcallargs(f, a=2, x=4)
      {'a': 2, 'b': 1, 'pos': (), 'named': {'x': 4}}
      >>> getcallargs(f)
      Traceback (most recent call last):
      ...
      TypeError: f() takes at least 1 argument (0 given)

  Contribución de George Sakkis; bpo-3135.

- Updated module: The `io` library has been upgraded to the version shipped with Python 3.1. For 3.1, the I/O library was entirely rewritten in C and is 2 to 20 times faster depending on the task being performed. The original Python version was renamed to the `_pyio` module.

  One minor resulting change: the `io.TextIOBase` class now has an `errors` attribute giving the error setting used for encoding and decoding errors (one of `'strict'`, `'replace'`, `'ignore'`).

  La clase `io.FileIO` ahora lanza un `OSError` cuando se le pasa un descriptor de fichero no válido. (Implementado por Benjamin Peterson; bpo-4991.) El método `truncate()` ahora preserva la posición del archivo; antes cambiaba la posición del archivo al final del nuevo archivo. (Corregido por Pascal Chambon; bpo-6939.)

- Nueva función: `itertools.compress(data, selectors)` toma dos iteradores. Los elementos de datos se retornan si el valor correspondiente en selectores es verdadero:

      itertools.compress('ABCDEF', [1,0,1,0,1,1]) =>
        A, C, E, F

  Nueva función: `itertools.combinations_with_replacement(iter, r)` retorna todas las posibles combinaciones de elementos de longitud r del iterable iter. A diferencia de `combinations()`, los elementos individuales pueden repetirse en las combinaciones generadas:

      itertools.combinations_with_replacement('abc', 2) =>
        ('a', 'a'), ('a', 'b'), ('a', 'c'),
        ('b', 'b'), ('b', 'c'), ('c', 'c')

  Tenga en cuenta que los elementos se tratan como únicos en función de su posición en la entrada, no de sus valores reales.

  La función `itertools.count()` tiene ahora un argumento step que permite incrementar por valores distintos de 1. `count()` también permite ahora argumentos de palabra clave, y utilizar valores no enteros como números de punto flotante o instancias de `Decimal`. (Implementado por Raymond Hettinger; bpo-5032.)

  `itertools.combinaciones()` y `itertools.producto()` anteriormente lanzaban `ValueError` para valores de r mayores que el iterable de entrada. Esto se consideraba un error de especificación, por lo que ahora retornan un iterador vacío. (Corregido por Raymond Hettinger; bpo-4816.)

- Módulo actualizado: El módulo `json` ha sido actualizado a la versión 2.0.9 del paquete simplejson, que incluye una extensión en C que hace más rápida la codificación y decodificación. (Contribuido por Bob Ippolito; bpo-4136.)

  Para soportar el nuevo tipo `collections.OrderedDict`, `json.load()` tiene ahora un parámetro opcional object_pairs_hook que será llamado con cualquier objeto literal que decodifique a una lista de pares. (Contribución de Raymond Hettinger; bpo-5381.)

- La clase `mailbox` del módulo `Maildir` ahora registra la marca de tiempo de los directorios que lee, y sólo los relee si la hora de modificación ha cambiado posteriormente. Esto mejora el rendimiento al evitar escaneos innecesarios de directorios. (Corregido por A.M. Kuchling y Antoine Pitrou; bpo-1607951, bpo-6896)

- Nuevas funciones: el módulo `math` ganó `erf()` y `erfc()` para la función de error y la función de error complementaria, `expm1()` que calcula `e**x - 1` con más precisión que usando `exp()` y restando 1, `gamma()` para la función Gamma, y `lgamma()` para el logaritmo natural de la función Gamma. (Contribución de Mark Dickinson y nirinA raseliarison; bpo-3366.)

- The `multiprocessing` module’s `Manager*` classes can now be passed a callable that will be called whenever a subprocess is started, along with a set of arguments that will be passed to the callable. (Contributed by lekma; bpo-5585.)

  The `Pool` class, which controls a pool of worker processes, now has an optional maxtasksperchild parameter. Worker processes will perform the specified number of tasks and then exit, causing the `Pool` to start a new worker. This is useful if tasks may leak memory or other resources, or if some tasks will cause the worker to become very large. (Contributed by Charles Cazabon; bpo-6963.)

- El módulo `nntplib` ahora soporta direcciones IPv6. (Contribución de Derek Morr; bpo-1664.)

- Nuevas funciones: el módulo `os` envuelve las siguientes llamadas al sistema POSIX: `getresgid()` y `getresuid()`, que retornan los GIDs y UIDs reales, efectivos y guardados; `setresgid()` y `setresuid()`, que establecen los GIDs y UIDs reales, efectivos y guardados a nuevos valores; `initgroups()`, que inicializan la lista de acceso a grupos para el proceso actual. (Funciones GID/UID contribuidas por Travis H.; bpo-6508. Soporte para initgroups añadido por Jean-Paul Calderone; bpo-7333)

  La función `os.fork()` ahora reinicializa el bloqueo de importación en el proceso hijo; esto soluciona los problemas en Solaris cuando `fork()` se llama desde un hilo. (Corregido por Zsolt Cserna; bpo-7242.)

- En el módulo `os.path`, las funciones `normpath()` y `abspath()` ahora preservan Unicode; si su ruta de entrada es una cadena Unicode, el valor de retorno es también una cadena Unicode. (`normpath()` arreglado por Matt Giuca en bpo-5827; `abspath()` arreglado por Ezio Melotti en bpo-3426)

- El módulo `pydoc` tiene ahora ayuda para los distintos símbolos que utiliza Python. Ahora puedes hacer `help('<<')` o `help('@')`, por ejemplo. (Contribución de David Laban; bpo-4739.)

- Las funciones `re` del módulo `split()`, `sub()` y `subn()` aceptan ahora un argumento opcional flags, por coherencia con las demás funciones del módulo. (Añadido por Gregory P. Smith)

- Nueva función: `run_path()` en el módulo `runpy` ejecutará el código en un argumento ruta proporcionado. path puede ser la ruta de un fichero fuente de Python (`ejemplo.py`), un fichero bytecode compilado (`ejemplo.pyc`), un directorio (`./package/`), o un archivo zip (`ejemplo.zip`). Si se proporciona un directorio o una ruta zip, se añadirá al frente de `sys.path` y se importará el módulo `__main__`. Se espera que el directorio o zip contenga un `__main__.py`; si no es así, algún otro `__main__.py` podría ser importado desde una ubicación posterior en `sys.path`. Esto hace que más de la maquinaria de `runpy` esté disponible para los scripts que quieran imitar la forma en que la línea de comandos de Python procesa un nombre de ruta explícito. (Añadido por Nick Coghlan; bpo-6816.)

- Nueva función: en el módulo `shutil`, `make_archive()` toma un nombre de fichero, un tipo de archivo (formato zip o tar) y una ruta de directorio, y crea un archivo con el contenido del directorio. (Añadido por Tarek Ziadé.)

  Las funciones `shutil` `copyfile()` y `copytree()` ahora lanzan una excepción `SpecialFileError` cuando se les pide que copien una tubería con nombre. Anteriormente, el código trataba las tuberías con nombre como un archivo normal, abriéndolas para su lectura, lo que bloqueaba indefinidamente. (Corregido por Antoine Pitrou; bpo-3002.)

- El módulo `signal` ya no reinstala el manejador de señales a menos que sea realmente necesario, lo que corrige un error que podía hacer imposible atrapar la señal EINTR de forma robusta. (Corregido por Charles-Francois Natali; bpo-8354.)

- New functions: in the `site` module, three new functions return various site- and user-specific paths. `getsitepackages()` returns a list containing all global site-packages directories, `getusersitepackages()` returns the path of the user’s site-packages directory, and `getuserbase()` returns the value of the `USER_BASE` environment variable, giving the path to a directory that can be used to store data. (Contributed by Tarek Ziadé; bpo-6693.)

  El módulo `site` ahora informa de las excepciones que se producen cuando se importa el módulo `sitecustomize`, y ya no atrapará y tragará la excepción `KeyboardInterrupt`. (Corregido por Victor Stinner; bpo-3137.)

- La función `create_connection()` ganó un parámetro dirección_de_origen, una 2-tupla `(host, port)` que da la dirección de origen que se utilizará para la conexión. (Contribuido por Eldon Ziegler; bpo-3972.)

  Los métodos `recv_into()` y `recvfrom_into()` ahora escribirán en objetos que soporten la API de búfer, más útilmente los objetos `bytearray` y `memoryview`. (Implementado por Antoine Pitrou; bpo-8104.)

- The `SocketServer` module’s `TCPServer` class now supports socket timeouts and disabling the Nagle algorithm. The `disable_nagle_algorithm` class attribute defaults to `False`; if overridden to be true, new request connections will have the TCP_NODELAY option set to prevent buffering many small sends into a single TCP packet. The `timeout` class attribute can hold a timeout in seconds that will be applied to the request socket; if no request is received within that time, `handle_timeout()` will be called and `handle_request()` will return. (Contributed by Kristján Valur Jónsson; bpo-6192 and bpo-6267.)

- Módulo actualizado: el módulo `sqlite3` ha sido actualizado a la versión 2.6.0 del paquete pysqlite. La versión 2.6.0 incluye una serie de correcciones de errores y añade la posibilidad de cargar extensiones de SQLite desde bibliotecas compartidas. Llame al método `enable_load_extension(True)` para habilitar las extensiones, y luego llame a `load_extension()` para cargar una biblioteca compartida en particular. (Actualizado por Gerhard Häring.)

- The `ssl` module’s `SSLSocket` objects now support the buffer API, which fixed a test suite failure (fix by Antoine Pitrou; bpo-7133) and automatically set OpenSSL’s `SSL_MODE_AUTO_RETRY`, which will prevent an error code being returned from `recv()` operations that trigger an SSL renegotiation (fix by Antoine Pitrou; bpo-8222).

  The `wrap_socket()` constructor function now takes a ciphers argument that’s a string listing the encryption algorithms to be allowed; the format of the string is described in the OpenSSL documentation. (Added by Antoine Pitrou; bpo-8322.)

  Otro cambio hace que la extensión cargue todos los cifrados y algoritmos de compendio de OpenSSL para que estén todos disponibles. Algunos certificados SSL no podían ser verificados, reportando un error de «algoritmo desconocido». (Informado por Beda Kosata, y corregido por Antoine Pitrou; bpo-8484)

  The version of OpenSSL being used is now available as the module attributes `ssl.OPENSSL_VERSION` (a string), `ssl.OPENSSL_VERSION_INFO` (a 5-tuple), and `ssl.OPENSSL_VERSION_NUMBER` (an integer). (Added by Antoine Pitrou; bpo-8321.)

- The `struct` module will no longer silently ignore overflow errors when a value is too large for a particular integer format code (one of `bBhHiIlLqQ`); it now always raises a `struct.error` exception. (Changed by Mark Dickinson; bpo-1523.) The `pack()` function will also attempt to use `__index__()` to convert and pack non-integers before trying the `__int__()` method or reporting an error. (Changed by Mark Dickinson; bpo-8300.)

- Nueva función: la función `check_output()` del módulo `subprocess` ejecuta un comando con un conjunto de argumentos especificado y retorna la salida del comando como una cadena de texto cuando el comando se ejecuta sin errores, o lanza una excepción `CalledProcessError` en caso contrario.

      >>> subprocess.check_output(['df', '-h', '.'])
      'Filesystem     Size   Used  Avail Capacity  Mounted on\n
      /dev/disk0s2    52G    49G   3.0G    94%    /\n'

      >>> subprocess.check_output(['df', '-h', '/bogus'])
        ...
      subprocess.CalledProcessError: Command '['df', '-h', '/bogus']' returned non-zero exit status 1

  (Contribución de Gregory P. Smith.)

  The `subprocess` module will now retry its internal system calls on receiving an `EINTR` signal. (Reported by several people; final patch by Gregory P. Smith in bpo-1068268.)

- Nueva función: `is_declared_global()` en el módulo `symtable` retorna true para las variables declaradas explícitamente como globales, false para las que son implícitamente globales. (Contribución de Jeremy Hylton)

- El módulo `syslog` utilizará ahora el valor de `sys.argv[0]` como identificador en lugar del anterior valor por defecto de `'python`. (Cambiado por Sean Reifschneider; bpo-8451.)

- The `sys.version_info` value is now a named tuple, with attributes named `major`, `minor`, `micro`, `releaselevel`, and `serial`. (Contributed by Ross Light; bpo-4285.)

  `sys.getwindowsversion()` also returns a named tuple, with attributes named `major`, `minor`, `build`, `platform`, `service_pack`, `service_pack_major`, `service_pack_minor`, `suite_mask`, and `product_type`. (Contributed by Brian Curtin; bpo-7766.)

- El manejo de errores por defecto del módulo `tarfile` ha cambiado, para no suprimir los errores fatales. El nivel de error por defecto era antes 0, lo que significaba que los errores sólo daban lugar a que se escribiera un mensaje en el registro de depuración, pero como el registro de depuración no está activado por defecto, estos errores pasan desapercibidos. El nivel de error por defecto es ahora 1, que lanza una excepción si hay un error. (Cambiado por Lars Gustäbel; bpo-7357.)

  `tarfile` ahora soporta el filtrado de los objetos `TarInfo` que se añaden a un fichero tar. Cuando llame a `add()`, puede suministrar un argumento opcional filtro que es una llamada. Al filtro se le pasará la clase `TarInfo` de cada fichero que se añada, y podrá modificarlo y retornarlo. Si la llamada retorna `Nada`, el fichero será excluido del archivo resultante. Esto es más potente que el argumento exclude existente, que por lo tanto ha sido obviado. (Añadido por Lars Gustäbel; bpo-6856.) La clase `TarFile` también soporta ahora el protocolo de gestión de contexto. (Añadido por Lars Gustäbel; bpo-7232.)

- El método `wait()` de la clase `threading.Event` ahora retorna la bandera interna al salir. Esto significa que el método normalmente retornará true porque `wait()` se supone que bloquea hasta que la bandera interna se convierte en true. El valor de retorno sólo será falso si se proporcionó un tiempo de espera y la operación expiró. (Contribuido por Tim Lesher; bpo-1674032.)

- La base de datos Unicode proporcionada por el módulo `unicodedata` se utiliza ahora internamente para determinar qué caracteres son numéricos, espacios en blanco o representan saltos de línea. La base de datos también incluye información del archivo de datos `Unihan.txt` (parche de Anders Chrigström y Amaury Forgeot d’Arc; bpo-1571184) y se ha actualizado a la versión 5.2.0 (actualizado por Florent Xicluna; bpo-8024).

- The `urlparse` module’s `urlsplit()` now handles unknown URL schemes in a fashion compliant with RFC 3986: if the URL is of the form `"<something>://..."`, the text before the `://` is treated as the scheme, even if it’s a made-up scheme that the module doesn’t know about. This change may break code that worked around the old behaviour. For example, Python 2.6.4 or 2.5 will return the following:

      >>> import urlparse
      >>> urlparse.urlsplit('invented://host/filename?query')
      ('invented', '', '//host/filename?query', '', '')

  Python 2.7 (y Python 2.6.5) retornará:

      >>> import urlparse
      >>> urlparse.urlsplit('invented://host/filename?query')
      ('invented', 'host', '/filename?query', '', '')

  (Python 2.7 en realidad produce una salida ligeramente diferente, ya que retorna una tupla con nombre en lugar de una tupla estándar)

  The `urlparse` module also supports IPv6 literal addresses as defined by RFC 2732 (contributed by Senthil Kumaran; bpo-2987).

      >>> urlparse.urlparse('http://[1080::8:800:200C:417A]/foo')
      ParseResult(scheme='http', netloc='[1080::8:800:200C:417A]',
                  path='/foo', params='', query='', fragment='')

- Nueva clase: la clase `WeakSet` del módulo `weakref` es un conjunto que sólo contiene referencias débiles a sus elementos; los elementos serán eliminados una vez que no haya referencias que apunten a ellos. (Implementado originalmente en Python 3.x por Raymond Hettinger, y Portado a 2.7 por Michael Foord)

- The `xml.etree.ElementTree` library, no longer escapes ampersands and angle brackets when outputting an XML processing instruction (which looks like `<?xml-stylesheet href="#style1"?>`) or comment (which looks like `<!-- comment -->`). (Patch by Neil Muller; bpo-2746.)

- The XML-RPC client and server, provided by the `xmlrpclib` and `SimpleXMLRPCServer` modules, have improved performance by supporting HTTP/1.1 keep-alive and by optionally using gzip encoding to compress the XML being exchanged. The gzip compression is controlled by the `encode_threshold` attribute of `SimpleXMLRPCRequestHandler`, which contains a size in bytes; responses larger than this will be compressed. (Contributed by Kristján Valur Jónsson; bpo-6267.)

- El módulo `zipfile` de `ZipFile` soporta ahora el protocolo de gestión de contexto, por lo que se puede escribir `con zipfile.ZipFile(...) como f:`. (Contribución de Brian Curtin; bpo-5511.)

  `zipfile` now also supports archiving empty directories and extracts them correctly. (Fixed by Kuba Wieczorek; bpo-4710.) Reading files out of an archive is faster, and interleaving `read()` and `readline()` now works correctly. (Contributed by Nir Aides; bpo-7610.)

  La función `is_zipfile()` acepta ahora un objeto archivo, además de los nombres de ruta aceptados en versiones anteriores. (Contribución de Gabriel Genellina; bpo-4756.)

  El método `writestr()` tiene ahora un parámetro opcional compress_type que permite anular el método de compresión por defecto especificado en el constructor `ZipFile`. (Contribución de Ronald Oussoren; bpo-6003.)

### Nuevo módulo: importlib

Python 3.1 includes the `importlib` package, a re-implementation of the logic underlying Python’s `import` statement. `importlib` is useful for implementers of Python interpreters and to users who wish to write new importers that can participate in the import process. Python 2.7 doesn’t contain the complete `importlib` package, but instead has a tiny subset that contains a single function, `import_module()`.

`import_module(name, package=None)` importa un módulo. name es una cadena que contiene el nombre del módulo o paquete. Es posible realizar importaciones relativas proporcionando una cadena que comience con un carácter `.`, como `..utils.errors`. Para las importaciones relativas, el argumento paquete debe ser proporcionado y es el nombre del paquete que se utilizará como ancla para la importación relativa. `import_module()` inserta el módulo importado en `sys.modules` y retorna el objeto módulo.

He aquí algunos ejemplos:

    >>> from importlib import import_module
    >>> anydbm = import_module('anydbm')  # Standard absolute import
    >>> anydbm
    <module 'anydbm' from '/p/python/Lib/anydbm.py'>
    >>> # Relative import
    >>> file_util = import_module('..file_util', 'distutils.command')
    >>> file_util
    <module 'distutils.file_util' from '/python/Lib/distutils/file_util.pyc'>

`importlib` fue implementado por Brett Cannon e introducido en Python 3.1.

### Nuevo módulo: sysconfig

El módulo `sysconfig` ha sido retirado del paquete Distutils, convirtiéndose en un nuevo módulo de alto nivel por derecho propio. `sysconfig` proporciona funciones para obtener información sobre el proceso de construcción de Python: interruptores del compilador, rutas de instalación, el nombre de la plataforma y si Python se está ejecutando desde su directorio fuente.

Algunas de las funciones del módulo son:

- `get_config_var()` retorna variables del Makefile de Python y del fichero `pyconfig.h`.

- `get_config_vars()` retorna un diccionario que contiene todas las variables de configuración.

- `get_path()` retorna la ruta configurada para un tipo de módulo concreto: la biblioteca estándar, módulos específicos del sitio, módulos específicos de la plataforma, etc.

- `is_python_build()` retorna true si está ejecutando un binario desde un árbol de fuentes de Python, y false en caso contrario.

Consulte la documentación de `sysconfig` para más detalles y para una lista completa de funciones.

El paquete Distutils y `sysconfig` son ahora mantenidos por Tarek Ziadé, que también ha iniciado un paquete Distutils2 (repositorio de fuentes en https://hg.python.org/distutils2/) para desarrollar una versión de próxima generación de Distutils.

### ttk: Widgets temáticos para Tk

Tcl/Tk 8.5 incluye un conjunto de widgets temáticos que reimplementan los widgets básicos de Tk pero tienen una apariencia más personalizable y, por tanto, pueden parecerse más a los widgets de la plataforma nativa. Este conjunto de widgets se llamaba originalmente Tile, pero fue renombrado a Ttk (por «Tk temático») al ser añadido a la versión 8.5 de Tcl/Tck.

To learn more, read the `ttk` module documentation. You may also wish to read the Tcl/Tk manual page describing the Ttk theme engine, available at https://www.tcl.tk/man/tcl8.5/TkCmd/ttk_intro.html. Some screenshots of the Python/Ttk code in use are at https://code.google.com/archive/p/python-ttk/wikis/Screenshots.wiki.

The `tkinter.ttk` module was written by Guilherme Polo and added in bpo-2983. An alternate version called `Tile.py`, written by Martin Franklin and maintained by Kevin Walzer, was proposed for inclusion in bpo-2618, but the authors argued that Guilherme Polo’s work was more comprehensive.

### Módulo actualizado: unittest

The `unittest` module was greatly enhanced; many new features were added. Most of these features were implemented by Michael Foord, unless otherwise noted. The enhanced version of the module is downloadable separately for use with Python versions 2.4 to 2.6, packaged as the `unittest2` package, from unittest2.

Cuando se usa desde la línea de comandos, el módulo puede descubrir pruebas automáticamente. No es tan elegante como py.test o nose, pero proporciona una forma sencilla de ejecutar pruebas guardadas dentro de un conjunto de directorios de paquetes. Por ejemplo, el siguiente comando buscará en el subdirectorio `test/` cualquier archivo de prueba importable llamado `test*.py`:

    python -m unittest discover -s test

Consulte la documentación del módulo `unittest` para más detalles. (Desarrollado en bpo-6001.)

La función `main()` soporta algunas otras opciones nuevas:

- `-b` o `--buffer` almacenará en búfer la salida estándar y los flujos de error estándar durante cada prueba. Si la prueba pasa, se descartará cualquier salida resultante; en caso de falla, se mostrará la salida almacenada en búfer.

- `-c` o `--catch` hará que la interrupción de control-C se maneje con más gracia. En lugar de interrumpir el proceso de prueba inmediatamente, se completará la prueba que se esté ejecutando en ese momento y luego se informará de los resultados parciales hasta la interrupción. Si está impaciente, una segunda pulsación de control-C provocará una interrupción inmediata.</unittest>

  Este manejador de control-C intenta evitar que se produzcan problemas cuando el código que se está probando o las pruebas que se están ejecutando han definido un manejador de señales propio, advirtiendo que ya se ha establecido un manejador de señales y llamándolo. Si esto no te funciona, hay un decorador `removeHandler()` que puede utilizarse para marcar las pruebas que deben tener el manejador de control-C desactivado.

- `-f` o `--failfast` hace que la ejecución de la prueba se detenga inmediatamente cuando una prueba falla en lugar de continuar ejecutando más pruebas. (Sugerido por Cliff Dyer e implementado por Michael Foord; bpo-8074)</unittest>

Los mensajes de progreso ahora muestran “x” para los fallos esperados y “u” para los éxitos inesperados cuando se ejecuta en modo verboso. (Contribución de Benjamin Peterson)

Los casos de prueba pueden lanzar la excepción `SkipTest` para saltarse una prueba (bpo-1034053).

Los mensajes de error para los fallos `assertEqual()`, `assertTrue()`, y `assertFalse()` ahora proporcionan más información. Si estableces el atributo `longMessage` de tus clases `TestCase` a true, tanto el mensaje de error estándar como cualquier mensaje adicional que proporciones se imprimirán para los fallos. (Añadido por Michael Foord; bpo-5663.)

El método `assertRaises()` ahora retorna un manejador de contexto cuando se llama sin proporcionar un objeto invocable para ejecutar. Por ejemplo, puede escribir esto:

    with self.assertRaises(KeyError):
        {}['foo']

(Implementado por Antoine Pitrou; bpo-4444.)

Ahora se soportan las funciones de configuración y desmontaje a nivel de módulo y de clase. Los módulos pueden contener funciones `setUpModule()` y `tearDownModule()`. Las clases pueden tener métodos `setUpClass()` y `tearDownClass()` que deben ser definidos como métodos de clase (usando `@classmethod` o equivalente). Estas funciones y métodos se invocan cuando el ejecutor de pruebas cambia a un caso de prueba en un módulo o clase diferente.

Se han añadido los métodos `addCleanup()` y `doCleanups()`. `addCleanup()` permite añadir funciones de limpieza que serán llamadas incondicionalmente (después de `setUp()` si `setUp()` falla, en caso contrario después de `tearDown()`). Esto permite una asignación y desasignación de recursos mucho más sencilla durante las pruebas (bpo-5679).

Se añadieron varios métodos nuevos que proporcionan pruebas más especializadas. Muchos de estos métodos fueron escritos por ingenieros de Google para utilizarlos en sus conjuntos de pruebas; Gregory P. Smith, Michael Foord y GvR trabajaron en la fusión de los mismos en la versión de Python de `unittest`.

- `assertIsNone()` y `assertIsNotNone()` toman una expresión y verifican que el resultado es o no es `None`.

- `assertIs()` y `assertIsNot()` toman dos valores y comprueban si los dos valores se evalúan al mismo objeto o no. (Añadido por Michael Foord; bpo-2578.)

- `assertIsInstance()` y `assertNotIsInstance()` comprueban si el objeto resultante es una instancia de una clase concreta, o de una tupla de clases. (Añadido por Georg Brandl; bpo-7031.)

- `assertGreater()`, `assertGreaterEqual()`, `assertLess()`, y `assertLessEqual()` comparan dos cantidades.

- `assertMultiLineEqual()` compara dos cadenas, y si no son iguales, muestra una comparación útil que resalta las diferencias en las dos cadenas. Esta comparación se utiliza ahora por defecto cuando las cadenas Unicode se comparan con `assertEqual()`.

- `assertRegexpMatches()` and `assertNotRegexpMatches()` checks whether the first argument is a string matching or not matching the regular expression provided as the second argument (bpo-8038).

- `assertRaisesRegexp()` checks whether a particular exception is raised, and then also checks that the string representation of the exception matches the provided regular expression.

- `assertIn()` y `assertNotIn()` comprueban si primero está o no está en segundo.

- `assertItemsEqual()` tests whether two provided sequences contain the same elements.

- `assertSetEqual()` compara si dos conjuntos son iguales, y sólo informa de las diferencias entre los conjuntos en caso de error.

- De forma similar, `assertListEqual()` y `assertTupleEqual()` comparan los tipos especificados y explican cualquier diferencia sin imprimir necesariamente sus valores completos; estos métodos se utilizan ahora por defecto cuando se comparan listas y tuplas utilizando `assertEqual()`. De forma más general, `assertSequenceEqual()` compara dos secuencias y puede comprobar opcionalmente si ambas secuencias son de un tipo determinado.

- `assertDictEqual()` compares two dictionaries and reports the differences; it’s now used by default when you compare two dictionaries using `assertEqual()`. `assertDictContainsSubset()` checks whether all of the key/value pairs in first are found in second.

- `assertAlmostEqual()` y `assertNotAlmostEqual()` prueban si first y second son aproximadamente iguales. Este método puede redondear su diferencia a un número especificado opcionalmente de lugares (el valor predeterminado es 7) y compararlo con cero, o requerir que la diferencia sea menor que un valor delta proporcionado.

- `loadTestsFromName()` respeta correctamente el atributo `suiteClass` de la `TestLoader`. (Corregido por Mark Roddy; bpo-6866.)

- Un nuevo hook permite extender el método `assertEqual()` para manejar nuevos tipos de datos. El método `addTypeEqualityFunc()` toma un objeto de tipo y una función. La función se utilizará cuando los dos objetos que se comparan sean del tipo especificado. Esta función debe comparar los dos objetos y lanzar una excepción si no coinciden; es una buena idea que la función proporcione información adicional acerca de por qué los dos objetos no coinciden, al igual que los nuevos métodos de comparación de secuencias.

`unittest.main()` ahora toma un argumento opcional `exit`. Si es falso, `main()` no llama a `sys.exit()`, permitiendo que `main()` sea utilizado desde el intérprete interactivo. (Contribuido por J. Pablo Fernández; bpo-3379.)

`TestResult` tiene nuevos métodos `startTestRun()` y `stopTestRun()` que se llaman inmediatamente antes y después de la ejecución de una prueba. (Contribución de Robert Collins; bpo-5728.)

Con todos estos cambios, el archivo `unittest.py` se estaba volviendo incómodamente grande, por lo que el módulo se convirtió en un paquete y el código se dividió en varios archivos (por Benjamin Peterson). Esto no afecta a la forma de importar o utilizar el módulo.

Ver también

https://web.archive.org/web/20210619163128/http://www.voidspace.org.uk/python/articles/unittest2.shtml

  Describe las nuevas funciones, cómo utilizarlas y la justificación de varias decisiones de diseño. (Por Michael Foord.)

### Módulo actualizado: ElementTree 1.3

La versión de la biblioteca ElementTree incluida en Python se ha actualizado a la versión 1.3. Algunas de las nuevas características son:

- Las diversas funciones de análisis ahora toman un argumento de palabra clave parser que da una instancia de `XMLParser` que se utilizará. Esto hace posible anular la codificación interna del archivo:

      p = ET.XMLParser(encoding='utf-8')
      t = ET.XML("""<root/>""", parser=p)

  Errors in parsing XML now raise a `ParseError` exception, whose instances have a `position` attribute containing a (line, column) tuple giving the location of the problem.

- ElementTree’s code for converting trees to a string has been significantly reworked, making it roughly twice as fast in many cases. The `ElementTree.write()` and `Element.write()` methods now have a method parameter that can be «xml» (the default), «html», or «text». HTML mode will output empty elements as `<empty></empty>` instead of `<empty/>`, and text mode will skip over elements and only output the text chunks. If you set the `tag` attribute of an element to `None` but leave its children in place, the element will be omitted when the tree is written out, so you don’t need to do more extensive rearrangement to remove a single element.

  También se ha mejorado la gestión de los espacios de nombres. Ahora todas las declaraciones `xmlns:<whatever>` se emiten en el elemento raíz, y no dispersas en el XML resultante. Se puede establecer el espacio de nombres por defecto para un árbol mediante el atributo `default_namespace` y se pueden registrar nuevos prefijos con `register_namespace()`. En el modo XML, puede utilizar el parámetro true/false xml_declaration para suprimir la declaración XML.

- Nuevo método `Element`: `extend()` añade los elementos de una secuencia a los hijos del elemento. Los propios elementos se comportan como secuencias, por lo que es fácil mover los hijos de un elemento a otro:

      from xml.etree import ElementTree as ET

      t = ET.XML("""<list>
        <item>1</item> <item>2</item>  <item>3</item>
      </list>""")
      new = ET.XML('<root/>')
      new.extend(t)

      # Outputs <root><item>1</item>...</root>
      print ET.tostring(new)

- New `Element` method: `iter()` yields the children of the element as a generator. It’s also possible to write `for child in elem:` to loop over an element’s children. The existing method `getiterator()` is now deprecated, as is `getchildren()` which constructs and returns a list of children.

- New `Element` method: `itertext()` yields all chunks of text that are descendants of the element. For example:

      t = ET.XML("""<list>
        <item>1</item> <item>2</item>  <item>3</item>
      </list>""")

      # Outputs ['\n  ', '1', ' ', '2', '  ', '3', '\n']
      print list(t.itertext())

- Deprecado: el uso de un elemento como booleano (es decir, `if elem:`) retornaba true si el elemento tenía algún hijo, o false si no había ningún hijo. Este comportamiento es confuso – `None` es falso, pero también lo es un elemento sin hijos? – por lo que ahora provocará un `FutureWarning`. En tu código, deberías ser explícito: escribe `len(elem) != 0` si te interesa el número de hijos, o `elem no es None`.

Fredrik Lundh desarrolla ElementTree y produjo la versión 1.3; puede leer su artículo que describe 1.3 en https://web.archive.org/web/20200703234532/http://effbot.org/zone/elementtree-13-intro.htm. Florent Xicluna actualizó la versión incluida con Python, luego de discusiones en python-dev y en bpo-6472.)

## Cambios en la API de construcción y C

Los cambios en el proceso de construcción de Python y en la API de C incluyen:

- The latest release of the GNU Debugger, GDB 7, can be scripted using Python. When you begin debugging an executable program P, GDB will look for a file named `P-gdb.py` and automatically read it. Dave Malcolm contributed a `python-gdb.py` that adds a number of commands useful when debugging Python itself. For example, `py-up` and `py-down` go up or down one Python stack frame, which usually corresponds to several C stack frames. `py-print` prints the value of a Python variable, and `py-bt` prints the Python stack trace. (Added as a result of bpo-8032.)

- Si utiliza el archivo `.gdbinit` proporcionado con Python, la macro «pyo» en la versión 2.7 ahora funciona correctamente cuando el hilo que se está depurando no tiene el GIL; la macro ahora lo adquiere antes de imprimir. (Contribución de Victor Stinner; bpo-3632.)

- `Py_AddPendingCall()` ahora es seguro para los hilos, permitiendo que cualquier hilo trabajador envíe notificaciones al hilo principal de Python. Esto es particularmente útil para las operaciones asíncronas de IO. (Contribuido por Kristján Valur Jónsson; bpo-4293.)

- New function: `PyCode_NewEmpty()` creates an empty code object; only the filename, function name, and first line number are required. This is useful for extension modules that are attempting to construct a more useful traceback stack. Previously such extensions needed to call `PyCode_New()`, which had many more arguments. (Added by Jeffrey Yasskin.)

- Nueva función: `PyErr_NewExceptionWithDoc()` crea una nueva clase de excepción, igual que la existente `PyErr_NewException()`, pero toma un argumento extra `char *` que contiene el docstring de la nueva clase de excepción. (Añadido por “lekma” en el bug tracker de Python; bpo-7033)

- Nueva función: `PyFrame_GetLineNumber()` toma un objeto frame y retorna el número de línea que el frame está ejecutando actualmente. Anteriormente, el código tenía que obtener el índice de la instrucción de código de bytes que se estaba ejecutando, y luego buscar el número de línea correspondiente a esa dirección. (Añadido por Jeffrey Yasskin)

- Nuevas funciones: `PyLong_AsLongAndOverflow()` y `PyLong_AsLongLongAndOverflow()` aproximan un entero largo de Python como C long o long long. Si el número es demasiado grande para caber en el tipo de salida, se establece un indicador overflow y se devuelve a la persona que llama. (Aportado por Case Van Horsen; bpo-7528 y bpo-7767.)

- New function: stemming from the rewrite of string-to-float conversion, a new `PyOS_string_to_double()` function was added. The old `PyOS_ascii_strtod()` and `PyOS_ascii_atof()` functions are now deprecated.

- Nueva función: `PySys_SetArgvEx()` establece el valor de `sys.argv` y puede opcionalmente actualizar `sys.path` para incluir el directorio que contiene el script nombrado por `sys.argv[0]` dependiendo del valor de un parámetro updatepath.

  Esta función se añadió para cerrar un agujero de seguridad para las aplicaciones que incrustan Python. La antigua función, `PySys_SetArgv()`, siempre actualizaba `sys.path`, y a veces añadía el directorio actual. Esto significaba que, si ejecutabas una aplicación que incrustaba Python en un directorio controlado por otra persona, los atacantes podían poner un módulo de caballo de Troya en el directorio (digamos, un archivo llamado `os.py`) que tu aplicación luego importaría y ejecutaría.

  Si mantienes una aplicación C/C++ que incrusta Python, comprueba si estás llamando a `PySys_SetArgv()` y considera cuidadosamente si la aplicación debería estar usando `PySys_SetArgvEx()` con updatepath establecido en false.

  Security issue reported as CVE-2008-5983; discussed in bpo-5753, and fixed by Antoine Pitrou.

- Nuevas macros: los ficheros de cabecera de Python definen ahora las siguientes macros: `Py_ISALNUM`, `Py_ISALPHA`, `Py_ISDIGIT`, `Py_ISLOWER`, `Py_ISSPACE`, `Py_ISUPPER`, `Py_ISXDIGIT`, `Py_TOLOWER` y `Py_TOUPPER`. Todas estas funciones son análogas a las macros estándar de C para clasificar caracteres, pero ignoran la configuración regional actual, porque en varios lugares Python necesita analizar los caracteres de forma independiente de la configuración regional. (Añadido por Eric Smith; bpo-5793.)

- Removed function: `PyEval_CallObject()` is now only available as a macro. A function version was being kept around to preserve ABI linking compatibility, but that was in 1997; it can certainly be deleted by now. (Removed by Antoine Pitrou; bpo-8276.)

- New format codes: the `PyString_FromFormat()`, `PyString_FromFormatV()`, and `PyErr_Format()` functions now accept `%lld` and `%llu` format codes for displaying C’s long long types. (Contributed by Mark Dickinson; bpo-7228.)

- Se ha cambiado la complicada interacción entre los hilos y la bifurcación de procesos. Anteriormente, el proceso hijo creado por `os.fork()` podía fallar porque el hijo se creaba con un solo hilo en ejecución, el hilo que realizaba el `os.fork()`. Si otros hilos estuvieran manteniendo un bloqueo, como el bloqueo de importación de Python, cuando se realizara el fork, el bloqueo seguiría marcado como «mantenido» en el nuevo proceso. Pero en el proceso hijo nada liberaría el bloqueo, ya que los otros hilos no estaban replicados, y el proceso hijo ya no podría realizar importaciones.

  Python 2.7 adquiere el bloqueo de importación antes de realizar un `os.fork()`, y también limpiará cualquier bloqueo creado usando el módulo `threading`. Los módulos de extensión C que tienen bloqueos internos, o que llaman a `fork()` ellos mismos, no se beneficiarán de esta limpieza.

  (Corregido por Thomas Wouters; bpo-1590864.)

- The `Py_Finalize()` function now calls the internal `threading._shutdown()` function; this prevents some exceptions from being raised when an interpreter shuts down. (Patch by Adam Olsen; bpo-1722344.)

- When using the `PyMemberDef` structure to define attributes of a type, Python will no longer let you try to delete or set a `T_STRING_INPLACE` attribute.

- Los símbolos globales definidos por el módulo `ctypes` llevan ahora el prefijo `Py`, o bien `_ctypes`. (Implementado por Thomas Heller; bpo-3102.)

- New configure option: the `--with-system-expat` switch allows building the `pyexpat` module to use the system Expat library. (Contributed by Arfrever Frehtes Taifersar Arahesis; bpo-7609.)

- Nueva opción de configuración: la opción `--with-valgrind` ahora desactivará el asignador pymalloc, que es difícil de analizar correctamente por el detector de errores de memoria de Valgrind. Por lo tanto, Valgrind detectará mejor las fugas de memoria y los desbordamientos. (Contribución de James Henstridge; bpo-2422.)

- Nueva opción de configuración: ahora puede suministrar una cadena vacía a `--with-dbmliborder=` para desactivar todos los módulos DBM. (Añadido por Arfrever Frehtes Taifersar Arahesis; bpo-6491)

- El script configure comprueba ahora los errores de redondeo en coma flotante en ciertos chips Intel de 32 bits y define una definición del preprocesador `X87_DOUBLE_ROUNDING`. Ningún código utiliza actualmente esta definición, pero está disponible si alguien desea utilizarla. (Añadido por Mark Dickinson; bpo-2937.)

  configure ahora también establece una variable Makefile `LDCXXSHARED` para soportar el enlazado de C++. (Contribuido por Arfrever Frehtes Taifersar Arahesis; bpo-1222585.)

- El proceso de construcción ahora crea los archivos necesarios para el soporte de pkg-config. (Contribución de Clinton Roy; bpo-3585.)

- El proceso de construcción ahora soporta Subversion 1.7. (Contribuido por Arfrever Frehtes Taifersar Arahesis; bpo-6094.)

### Cápsulas

Python 3.1 añade un nuevo tipo de datos C, `PyCapsule`, para proporcionar una API C a un módulo de extensión. Una cápsula es esencialmente el soporte de un puntero C `void *`, y está disponible como un atributo del módulo; por ejemplo, la API del módulo `socket` se expone como `socket.CAPI`, y `unicodedata` expone `ucnhash_CAPI`. Otras extensiones pueden importar el módulo, acceder a su diccionario para obtener el objeto cápsula, y luego obtener el puntero `void *`, que normalmente apuntará a una matriz de punteros a las diversas funciones de la API del módulo.

There is an existing data type already used for this, `PyCObject`, but it doesn’t provide type safety. Evil code written in pure Python could cause a segmentation fault by taking a `PyCObject` from module A and somehow substituting it for the `PyCObject` in module B. Capsules know their own name, and getting the pointer requires providing the name:

    void *vtable;

    if (!PyCapsule_IsValid(capsule, "mymodule.CAPI") {
            PyErr_SetString(PyExc_ValueError, "argument type invalid");
            return NULL;
    }

    vtable = PyCapsule_GetPointer(capsule, "mymodule.CAPI");

Se asegura que `vtable` apunta a lo que se espera. Si se pasara una cápsula diferente, `PyCapsule_IsValid()` detectaría el nombre erróneo y retornaría false. Consulta Proporcionar una API C para un módulo de extensión para más información sobre el uso de estos objetos.

Python 2.7 now uses capsules internally to provide various extension-module APIs, but the `PyCObject_AsVoidPtr()` was modified to handle capsules, preserving compile-time compatibility with the `PyCObject` interface. Use of `PyCObject_AsVoidPtr()` will signal a `PendingDeprecationWarning`, which is silent by default.

Implementado en Python 3.1 y portado a 2.7 por Larry Hastings; discutido en bpo-5630.

### Cambios específicos en los puertos: Windows

- The `msvcrt` module now contains some constants from the `crtassem.h` header file: `CRT_ASSEMBLY_VERSION`, `VC_ASSEMBLY_PUBLICKEYTOKEN`, and `LIBRARIES_ASSEMBLY_NAME_PREFIX`. (Contributed by David Cournapeau; bpo-4365.)

- The `_winreg` module for accessing the registry now implements the `CreateKeyEx()` and `DeleteKeyEx()` functions, extended versions of previously supported functions that take several extra arguments. The `DisableReflectionKey()`, `EnableReflectionKey()`, and `QueryReflectionKey()` were also tested and documented. (Implemented by Brian Curtin: bpo-7347.)

- The new `_beginthreadex()` API is used to start threads, and the native thread-local storage functions are now used. (Contributed by Kristján Valur Jónsson; bpo-3582.)

- The `os.kill()` function now works on Windows. The signal value can be the constants `CTRL_C_EVENT`, `CTRL_BREAK_EVENT`, or any integer. The first two constants will send ``Control`-`C`` and ``Control`-`Break`` keystroke events to subprocesses; any other value will use the `TerminateProcess()` API. (Contributed by Miki Tebeka; bpo-1220212.)

- La función `os.listdir()` ahora falla correctamente si la ruta está vacía. (Corregido por Hirokazu Yamamoto; bpo-5913.)

- The `mimetypes` module will now read the MIME database from the Windows registry when initializing. (Patch by Gabriel Genellina; bpo-4969.)

### Cambios específicos en los puertos: Mac OS X

- La ruta `/Library/Python/2.7/site-packages` se añade ahora a `sys.path`, para compartir los paquetes añadidos entre la instalación del sistema y una copia de la misma versión instalada por el usuario. (Cambiado por Ronald Oussoren; bpo-4865.)

  Distinto en la versión 2.7.13: A partir de la versión 2.7.13, se ha eliminado este cambio. `/Library/Python/2.7/site-packages`, el directorio site-packages utilizado por el sistema Python 2.7 suministrado por Apple ya no se añade a `sys.path` para los Python instalados por el usuario, como los instaladores de python.org. A partir de macOS 10.12, Apple ha cambiado la configuración del directorio site-packages del sistema, lo que puede hacer que falle la instalación de componentes pip, como setuptools. Los paquetes instalados para el sistema Python ya no se compartirán con los Python instalados por el usuario. (bpo-28440)

### Cambios específicos en los puertos: FreeBSD

- FreeBSD 7.1’s `SO_SETFIB` constant, used with the `socket()` methods `getsockopt()`/`setsockopt()` to select an alternate routing table, is now available in the `socket` module. (Added by Kyle VanderBeek; bpo-8235.)

## Otros cambios y correcciones

- Dos scripts de evaluación, `iobench` y `ccbench`, han sido añadidos al directorio `Tools`. `iobench` mide la velocidad de los objetos de E/S de los archivos retornados por `open()` al realizar varias operaciones, y `ccbench` es una evaluación de concurrencia que trata de medir el rendimiento de la computación, la latencia del cambio de hilos y el ancho de banda del procesamiento de E/S al realizar varias tareas utilizando un número variable de hilos.

- El script `Tools/i18n/msgfmt.py` ahora entiende las formas plurales en los archivos `.po`. (Corregido por Martin von Löwis; bpo-5464.)

- When importing a module from a `.pyc` or `.pyo` file with an existing `.py` counterpart, the `co_filename` attributes of the resulting code objects are overwritten when the original filename is obsolete. This can happen if the file has been renamed, moved, or is accessed through different paths. (Patch by Ziga Seilnacht and Jean-Paul Calderone; bpo-1180193.)

- El script `regrtest.py` ahora toma una opción `--randseed=` que toma un entero que será usado como semilla aleatoria para la opción `-r` que ejecuta las pruebas en orden aleatorio. La opción `-r` también informa de la semilla que se ha utilizado (Añadido por Collin Winter.)

- Otra opción `regrtest.py` es `-j`, que toma un número entero que especifica cuántas pruebas se ejecutan en paralelo. Esto permite reducir el tiempo total de ejecución en máquinas multinúcleo. Esta opción es compatible con varias otras opciones, incluyendo la opción `-R` que es conocida por producir tiempos de ejecución largos. (Añadido por Antoine Pitrou, bpo-6152.) También puede utilizarse con una nueva opción `-F` que ejecuta las pruebas seleccionadas en un bucle hasta que fallen. (Añadido por Antoine Pitrou; bpo-7312.)

- Cuando se ejecuta como un script, el módulo `py_compile.py` ahora acepta `'-'` como argumento, que leerá la entrada estándar para la lista de nombres de archivos a compilar. (Contribuido por Piotr Ożarowski; bpo-8233.)

## Adaptación a Python 2.7

Esta sección enumera los cambios descritos anteriormente y otras correcciones de errores que pueden requerir cambios en su código:

- The `range()` function processes its arguments more consistently; it will now call `__int__()` on non-float, non-integer arguments that are supplied to it. (Fixed by Alexander Belopolsky; bpo-1533.)

- El método string `format()` ha cambiado la precisión por defecto utilizada para los números de punto flotante y complejos de 6 decimales a 12, que coincide con la precisión utilizada por `str()`. (Cambiado por Eric Smith; bpo-5920.)

- Because of an optimization for the `with` statement, the special methods `__enter__()` and `__exit__()` must belong to the object’s type, and cannot be directly attached to the object’s instance. This affects new-style classes (derived from `object`) and C extension types. (bpo-6101.)

- Due to a bug in Python 2.6, the exc_value parameter to `__exit__()` methods was often the string representation of the exception, not an instance. This was fixed in 2.7, so exc_value will be an instance as expected. (Fixed by Florent Xicluna; bpo-7853.)

- Cuando se establecía un conjunto restringido de atributos utilizando `__slots__`, la eliminación de un atributo no establecido no lanzaba `AttributeError` como cabría esperar. Corregido por Benjamin Peterson; bpo-7604)

En la biblioteca estándar:

- Las operaciones con instancias `datetime` que daban como resultado un año que caía fuera del rango soportado no siempre lanzaban `OverflowError`. Estos errores se comprueban ahora con más cuidado y se lanzará la excepción. (Informado por Mark Leander, parche de Anand B. Pillai y Alexander Belopolsky; bpo-7150)

- Cuando se utilizan instancias `Decimal` con el método `format()` de una cadena, la alineación por defecto era antes la alineación a la izquierda. Se ha cambiado a alineación derecha, lo que podría cambiar la salida de sus programas. (Cambiado por Mark Dickinson; bpo-6857.)

  Las comparaciones que implican un valor NaN de señalización (o `sNAN`) señalan ahora `InvalidOperation` en lugar de retornar silenciosamente un valor verdadero o falso dependiendo del operador de comparación. Los valores NaN silenciosos (o `NaN`) son ahora hashable. (Corregido por Mark Dickinson; bpo-7279.)

- The `xml.etree.ElementTree` library no longer escapes ampersands and angle brackets when outputting an XML processing instruction (which looks like `<?xml-stylesheet href="#style1"?>`) or comment (which looks like `<!-- comment -->`). (Patch by Neil Muller; bpo-2746.)

- The `readline()` method of `StringIO` objects now does nothing when a negative length is requested, as other file-like objects do. (bpo-7348).

- El módulo `syslog` utilizará ahora el valor de `sys.argv[0]` como identificador en lugar del anterior valor por defecto de `'python`. (Cambiado por Sean Reifschneider; bpo-8451.)

- El manejo de errores por defecto del módulo `tarfile` ha cambiado, para no suprimir los errores fatales. El nivel de error por defecto era antes 0, lo que significaba que los errores sólo daban lugar a que se escribiera un mensaje en el registro de depuración, pero como el registro de depuración no está activado por defecto, estos errores pasan desapercibidos. El nivel de error por defecto es ahora 1, que lanza una excepción si hay un error. (Cambiado por Lars Gustäbel; bpo-7357.)

- The `urlparse` module’s `urlsplit()` now handles unknown URL schemes in a fashion compliant with RFC 3986: if the URL is of the form `"<something>://..."`, the text before the `://` is treated as the scheme, even if it’s a made-up scheme that the module doesn’t know about. This change may break code that worked around the old behaviour. For example, Python 2.6.4 or 2.5 will return the following:

      >>> import urlparse
      >>> urlparse.urlsplit('invented://host/filename?query')
      ('invented', '', '//host/filename?query', '', '')

  Python 2.7 (y Python 2.6.5) retornará:

      >>> import urlparse
      >>> urlparse.urlsplit('invented://host/filename?query')
      ('invented', 'host', '/filename?query', '', '')

  (Python 2.7 en realidad produce una salida ligeramente diferente, ya que retorna una tupla con nombre en lugar de una tupla estándar)

Para las extensiones en C:

- Las extensiones de C que utilizan códigos de formato entero con la familia de funciones `PyArg_Parse*` ahora lanzarán una excepción `TypeError` en lugar de provocar un `DeprecationWarning` (bpo-5080).

- Use the new `PyOS_string_to_double()` function instead of the old `PyOS_ascii_strtod()` and `PyOS_ascii_atof()` functions, which are now deprecated.

Para aplicaciones que incrustan Python:

- Se ha añadido la función `PySys_SetArgvEx()`, que permite a las aplicaciones cerrar un agujero de seguridad cuando se utiliza la función `PySys_SetArgv()` existente. Compruebe si está llamando a `PySys_SetArgv()` y considere cuidadosamente si la aplicación debería estar usando `PySys_SetArgvEx()` con updatepath establecido en false.

## Nuevas funciones añadidas a las versiones de mantenimiento de Python 2.7

Se pueden añadir nuevas características a las versiones de mantenimiento de Python 2.7 cuando la situación lo requiera realmente. Cualquier adición debe pasar por el proceso de Propuesta de Mejora de Python, y hacer un caso convincente de por qué no se puede abordar adecuadamente mediante la adición de la nueva característica únicamente a Python 3, o bien mediante su publicación en el Índice de Paquetes de Python.

Además de las propuestas específicas enumeradas a continuación, existe una exención general que permite añadir nuevas advertencias `-3` en cualquier versión de mantenimiento de Python 2.7.

### Dos nuevas variables de entorno para el modo de depuración

In debug mode, the `[xxx refs]` statistic is not written by default, the `PYTHONSHOWREFCOUNT` environment variable now must also be set. (Contributed by Victor Stinner; bpo-31733.)

When Python is compiled with `COUNT_ALLOC` defined, allocation counts are no longer dumped by default anymore: the `PYTHONSHOWALLOCCOUNT` environment variable must now also be set. Moreover, allocation counts are now dumped into stderr, rather than stdout. (Contributed by Victor Stinner; bpo-31692.)

Added in version 2.7.15.

### PEP 434: Excepción de mejora de IDLE para todas las ramas

PEP 434 describe una exención general para los cambios realizados en el entorno de desarrollo de IDLE que se envía junto con Python. Esta exención hace posible que los desarrolladores de IDLE proporcionen una experiencia de usuario más consistente en todas las versiones soportadas de Python 2 y 3.

Para conocer los detalles de los cambios de IDLE, consulte el archivo NEWS de la versión en cuestión.

### PEP 466: Mejoras en la seguridad de la red para Python 2.7

PEP 466 describe una serie de propuestas de mejora de la seguridad de la red que han sido aprobadas para su inclusión en las versiones de mantenimiento de Python 2.7, y el primero de esos cambios aparecerá en la versión 2.7.7 de Python.

Funciones relacionadas con 466 añadidas en Python 2.7.7:

- `hmac.compare_digest()` fue portado desde Python 3 para hacer una operación de comparación resistente a los ataques de tiempo disponible para las aplicaciones de Python 2. (Contribuido por Alex Gaynor; bpo-21306.)

- OpenSSL 1.0.1g fue actualizado en los instaladores oficiales de Windows publicados en python.org. (Contribuido por Zachary Ware; bpo-21462.)

Funciones relacionadas con 466 añadidas en Python 2.7.8:

- `hashlib.pbkdf2_hmac()` fue portado desde Python 3 para hacer que un algoritmo de hash adecuado para el almacenamiento seguro de contraseñas esté ampliamente disponible para las aplicaciones de Python 2. (Contribuido por Alex Gaynor; bpo-21304.)

- OpenSSL 1.0.1h was upgraded for the official Windows installers published on python.org. (Contributed by Zachary Ware in bpo-21671 for CVE-2014-0224.)

Funciones relacionadas con 466 añadidas en Python 2.7.9:

- La mayor parte del módulo `ssl` de Python 3.4 ha sido portado a esta versión. Esto significa que `ssl` ahora soporta la Indicación de Nombre de Servidor, la configuración de TLS1.x, el acceso al almacén de certificados de la plataforma, la clase `SSLContext`, y otras características. (Contribución de Alex Gaynor y David Reid; bpo-21308.)

  Consulte las notas «Versión añadida: 2.7.9» en la documentación del módulo para obtener detalles específicos.

- `os.urandom()` ha sido modificado para almacenar en caché un descriptor de fichero en `/dev/urandom` en lugar de reabrir `/dev/urandom` en cada llamada. (Contribuido por Alex Gaynor; bpo-21305.)

- `hashlib.algorithms_guaranteed` y `hashlib.algorithms_available` han sido portados desde Python 3 para facilitar a las aplicaciones de Python 2 la selección del algoritmo hash más potente disponible. (Contribuido por Alex Gaynor en bpo-21307)

### PEP 477: Backport ensurepip (PEP 453) a Python 2.7

PEP 477 aprueba la inclusión del módulo PEP 453 ensurepip y la documentación mejorada que ha permitido en las versiones de mantenimiento de Python 2.7, apareciendo primero en la versión 2.7.9 de Python.

#### Puesta en marcha de pip por defecto

El nuevo módulo `ensurepip` (definido en PEP 453) proporciona un mecanismo estándar multiplataforma para arrancar el instalador pip en las instalaciones de Python. La versión de `pip` incluida con Python 2.7.9 es `pip` 1.5.6, y las futuras versiones de mantenimiento de 2.7.x actualizarán la versión incluida a la última versión de `pip` que esté disponible en el momento de crear la versión candidata.

Por defecto, los comandos `pip`, `pipX` y `pipX.Y` se instalarán en todas las plataformas (donde X.Y representa la versión de la instalación de Python), junto con el paquete de Python `pip` y sus dependencias.

Para las construcciones de CPython source en sistemas POSIX, los comandos `make install` y `make altinstall` no arrancan `pip` por defecto. Este comportamiento puede ser controlado a través de las opciones de configuración, y anulado a través de las opciones del Makefile.</building-python-on-unix>

En Windows y Mac OS X, los instaladores de CPython ahora instalan por defecto `pip` junto con el propio CPython (los usuarios pueden optar por no instalarlo durante el proceso de instalación). Los usuarios de Windows tendrán que optar por las modificaciones automáticas del `PATH` para que `pip` esté disponible por defecto desde la línea de comandos, de lo contrario se puede acceder a través del lanzador de Python para Windows como `py -m pip`.

Como se discute en el PEP, los empaquetadores de plataformas pueden optar por no instalar estos comandos por defecto, siempre y cuando, cuando se invoquen, proporcionen instrucciones claras y sencillas sobre cómo instalarlos en esa plataforma (normalmente utilizando el gestor de paquetes del sistema).

#### Cambios en la documentación

Como parte de este cambio, las secciones Instalando módulos de Python y Distribuir módulos de Python de la documentación se han rediseñado por completo como documentos breves de introducción y preguntas frecuentes. La mayor parte de la documentación de empaquetado ahora se ha trasladado a Python Packaging Authority mantenido Python Packaging User Guide y la documentación de los proyectos individuales.

However, as this migration is currently still incomplete, the legacy versions of those guides remaining available as Building C and C++ Extensions with setuptools and Building C and C++ Extensions with setuptools.

Ver también

PEP 453 – Arranque explícito de pip en instalaciones de Python

  PEP escrito por Donald Stufft y Nick Coghlan, implementado por Donald Stufft, Nick Coghlan, Martin von Löwis y Ned Deily.

### PEP 476: Habilitar la verificación de certificados por defecto para los clientes http stdlib

PEP 476 updated `httplib` and modules which use it, such as `urllib2` and `xmlrpclib`, to now verify that the server presents a certificate which is signed by a Certificate Authority in the platform trust store and whose hostname matches the hostname being requested by default, significantly improving security for many applications. This change was made in the Python 2.7.9 release.

Para las aplicaciones que requieren el antiguo comportamiento anterior, pueden pasar un contexto alternativo:

    import urllib2
    import ssl

    # This disables all verification
    context = ssl._create_unverified_context()

    # This allows using a specific certificate for the host, which doesn't need
    # to be in the trust store
    context = ssl.create_default_context(cafile="/path/to/file.crt")

    urllib2.urlopen("https://invalid-cert", context=context)

### PEP 493: Herramientas de migración de verificación HTTPS para Python 2.7

PEP 493 proporciona herramientas de migración adicionales para soportar un proceso de actualización de la infraestructura más incremental para los entornos que contienen aplicaciones y servicios que dependen del procesamiento históricamente permisivo de los certificados de servidor cuando se establecen conexiones HTTPS de cliente. Estas adiciones se realizaron en la versión 2.7.12 de Python.

Estas herramientas están pensadas para su uso en casos en los que las aplicaciones y servicios afectados no pueden modificarse para pasar explícitamente un contexto SSL más permisivo al establecer la conexión.

Para las aplicaciones y servicios que no pueden ser modificados en absoluto, la nueva variable de entorno `PYTHONHTTPSVERIFY` puede establecerse a `0` para revertir todo un proceso de Python al comportamiento permisivo por defecto de Python 2.7.8 y anteriores.

For cases where the connection establishment code can’t be modified, but the overall application can be, the new `ssl._https_verify_certificates()` function can be used to adjust the default behaviour at runtime.

### Nuevo objetivo de construcción `make regen-all`

Para simplificar la compilación cruzada, y para asegurar que CPython pueda ser compilado de forma fiable sin requerir que una versión existente de Python esté ya disponible, el sistema de construcción basado en autotools ya no intenta recompilar implícitamente los archivos generados basándose en los tiempos de modificación de los archivos.

En su lugar, se ha añadido un nuevo comando `make regen-all` para forzar la regeneración de estos archivos cuando se desee (por ejemplo, después de que se haya construido una versión inicial de Python basada en las versiones pregeneradas).

También se definen objetivos de regeneración más selectivos - ver Makefile.pre.in para más detalles.

(Contribución de Victor Stinner en bpo-23404.)

Added in version 2.7.14.

### Eliminación del objetivo de construcción `make touch`

Se ha eliminado el objetivo de compilación `make touch` que anteriormente se utilizaba para solicitar la regeneración implícita de los archivos generados mediante la actualización de sus tiempos de modificación.

Se ha sustituido por el nuevo objetivo `make regen-all`.

(Contribución de Victor Stinner en bpo-23404.)

Distinto en la versión 2.7.14.

## Agradecimientos

El autor desea agradecer a las siguientes personas sus sugerencias, correcciones y ayuda en varios borradores de este artículo: Nick Coghlan, Philip Jenvey, Ryan Lovett, R. David Murray y Hugh Secker-Walker.