Что нового в Python 3.2¶

электронная почта¶

Удобство использования пакета email в Python 3 было в основном исправлено благодаря интенсивным усилиям Р. Дэвида Мюррея. Проблема заключалась в том, что электронные письма обычно считываются и сохраняются в виде текста bytes, а не str, и они могут содержать несколько кодировок в одном электронном письме. Таким образом, пакет электронной почты пришлось расширить для анализа и генерации сообщений электронной почты в байтовом формате.

• Новые функции message_from_bytes() и message_from_binary_file(), а также новые классы BytesFeedParser и BytesParser позволяют преобразовывать двоичные данные сообщений в объекты модели.

• Учитывая байты, введенные в модель, get_payload() по умолчанию декодирует текст сообщения, который имеет Content-Transfer-Encoding из 8 бит, используя кодировку, указанную в заголовках MIME, и возвращает результирующую строку.

• Учитывая байты, введенные в модель, Generator преобразует тела сообщений, которые имеют Content-Transfer-Encoding значение 8 бит, в 7 бит Content-Transfer-Encoding.

  Заголовки с незакодированными байтами, отличными от ASCII, считаются закодированными RFC 2047 с использованием набора символов unknown-8bit.

• Новый класс BytesGenerator выдает байты в качестве выходных данных, сохраняя все неизмененные данные, отличные от ASCII, которые присутствовали во входных данных, используемых для построения модели, включая тела сообщений с Content-Transfer-Encoding, равными 8 битам.

• Класс smtplib SMTP теперь принимает байтовую строку в качестве аргумента msg для метода sendmail(), а новый метод send_message() принимает объект Message и может дополнительно получать адреса from_addr и to_addrs непосредственно из объекта.

(Предложено и реализовано Р. Дэвидом Мюрреем, bpo-4661 и bpo-10321.)

элементарное дерево¶

Пакет xml.etree.ElementTree и его аналог xml.etree.cElementTree были обновлены до версии 1.3.

Было добавлено несколько новых и полезных функций и методов:

• xml.etree.ElementTree.fromstringlist() который создает XML-документ из последовательности фрагментов

• xml.etree.ElementTree.register_namespace() для регистрации префикса глобального пространства имен

• xml.etree.ElementTree.tostringlist() для строкового представления, включающего все подсписки

• xml.etree.ElementTree.Element.extend() для добавления последовательности из нуля или более элементов

• xml.etree.ElementTree.Element.iterfind() выполняет поиск по элементу и подэлементам

• xml.etree.ElementTree.Element.itertext() создает текстовый итератор для элемента и его подэлементов

• xml.etree.ElementTree.TreeBuilder.end() закрывает текущий элемент

• xml.etree.ElementTree.TreeBuilder.doctype() обрабатывает объявление типа документа

Два метода были признаны устаревшими:

• вместо xml.etree.ElementTree.getchildren() используйте list(elem).

• вместо xml.etree.ElementTree.getiterator() используйте Element.iter.

Подробную информацию об обновлении смотрите в разделе Introducing ElementTree на веб-сайте Фредрика Лунда.

(Авторы: Флоран Шиклуна и Фредрик Лунд, bpo-6472.)

функциональные средства¶

• Модуль functools включает в себя новый декоратор для кэширования вызовов функций. functools.lru_cache() позволяет сохранять повторяющиеся запросы к внешнему ресурсу всякий раз, когда ожидается, что результаты будут одинаковыми.

  Например, добавление декоратора кэширования к функции запроса базы данных может сохранить доступ к базе данных для популярных поисковых запросов:

  >>> import functools
  >>> @functools.lru_cache(maxsize=300)
  ... def get_phone_number(name):
  ...     c = conn.cursor()
  ...     c.execute('SELECT phonenumber FROM phonelist WHERE name=?', (name,))
  ...     return c.fetchone()[0]
  

  >>> for name in user_requests:        
  ...     get_phone_number(name)        # cached lookup
  

  Чтобы помочь с выбором эффективного размера кэша, функция wrapped предназначена для отслеживания статистики кэша:

  >>> get_phone_number.cache_info()     
  CacheInfo(hits=4805, misses=980, maxsize=300, currsize=300)
  

  Если таблица списка телефонов будет обновлена, устаревшее содержимое кэша может быть удалено с помощью:

  >>> get_phone_number.cache_clear()
  

  (Материал подготовлен Раймондом Хеттингером и включает дизайнерские идеи Джима Бейкера, Мики Тебеки и Ника Коглана; смотрите recipe 498245, recipe 577479, bpo-10586, и bpo-10593.)

• Декоратор functools.wraps() теперь добавляет атрибут __wrapped__, указывающий на исходную вызываемую функцию. Это позволяет анализировать встроенные функции. Он также копирует __annotations__, если он определен. И теперь он также изящно пропускает отсутствующие атрибуты, такие как __doc__, которые могут быть не определены для обернутого вызываемого объекта.

  В приведенном выше примере кэш можно удалить, восстановив исходную функцию:

  >>> get_phone_number = get_phone_number.__wrapped__    # uncached function
  

  (Авторы: Ник Коглан и Терренс Коул; bpo-9567, bpo-3445, и bpo-8814.)

• Чтобы облегчить написание классов с расширенными методами сравнения, новый декоратор functools.total_ordering() будет использовать существующие методы равенства и неравенства для заполнения оставшихся методов.

  Например, указание __eq__ и __lt__ позволит total_ordering() заполнить __le__, __gt__ и __ge__:

  @total_ordering
  class Student:
      def __eq__(self, other):
          return ((self.lastname.lower(), self.firstname.lower()) ==
                  (other.lastname.lower(), other.firstname.lower()))
  
      def __lt__(self, other):
          return ((self.lastname.lower(), self.firstname.lower()) <
                  (other.lastname.lower(), other.firstname.lower()))
  

  С помощью декоратора total_ordering остальные методы сравнения заполняются автоматически.

  (Автор - Раймонд Хеттингер.)

• Чтобы облегчить перенос программ с Python 2, функция functools.cmp_to_key() преобразует функцию сравнения старого образца в современную key function:

  >>> # locale-aware sort order
  >>> sorted(iterable, key=cmp_to_key(locale.strcoll)) 
  

  Примеры сортировки и краткое руководство по сортировке приведены в руководстве Sorting HowTo.

  (Автор - Раймонд Хеттингер.)

итеративные инструменты¶

• Модуль itertools имеет новую функцию accumulate(), созданную по образцу оператора Apple scan и функции Numpy accumulate:

  >>> from itertools import accumulate
  >>> list(accumulate([8, 2, 50]))
  [8, 10, 60]
  

  >>> prob_dist = [0.1, 0.4, 0.2, 0.3]
  >>> list(accumulate(prob_dist))      # cumulative probability distribution
  [0.1, 0.5, 0.7, 1.0]
  

  Пример использования accumulate() смотрите в examples for the random module.

  (Автор - Раймонд Хеттингер, с учетом дизайнерских предложений Марка Дикинсона.)

коллекции¶

• В классе collections.Counter теперь есть две формы вычитания на месте: существующий оператор -= для saturating subtraction и новый метод subtract() для обычного вычитания. Первый вариант подходит для multisets, которые имеют только положительные значения, а второй больше подходит для вариантов использования, которые допускают отрицательные значения:

  >>> from collections import Counter
  >>> tally = Counter(dogs=5, cats=3)
  >>> tally -= Counter(dogs=2, cats=8)    # saturating subtraction
  >>> tally
  Counter({'dogs': 3})
  

  >>> tally = Counter(dogs=5, cats=3)
  >>> tally.subtract(dogs=2, cats=8)      # regular subtraction
  >>> tally
  Counter({'dogs': 3, 'cats': -5})
  

  (Автор - Раймонд Хеттингер.)

• В классе collections.OrderedDict есть новый метод move_to_end(), который берет существующий ключ и перемещает его либо в первую, либо в последнюю позицию в упорядоченной последовательности.

  По умолчанию элемент перемещается на последнюю позицию. Это эквивалентно обновлению записи с помощью od[k] = od.pop(k).

  Операция быстрого перехода к концу полезна для изменения последовательности записей. Например, упорядоченный словарь можно использовать для отслеживания порядка доступа к записям по возрастанию от самой старой к последней, к которой был осуществлен доступ.

  >>> from collections import OrderedDict
  >>> d = OrderedDict.fromkeys(['a', 'b', 'X', 'd', 'e'])
  >>> list(d)
  ['a', 'b', 'X', 'd', 'e']
  >>> d.move_to_end('X')
  >>> list(d)
  ['a', 'b', 'd', 'e', 'X']
  

  (Автор - Раймонд Хеттингер.)

• В классе collections.deque появились два новых метода count() и reverse(), которые делают их более взаимозаменяемыми с объектами list:

  >>> from collections import deque
  >>> d = deque('simsalabim')
  >>> d.count('s')
  2
  >>> d.reverse()
  >>> d
  deque(['m', 'i', 'b', 'a', 'l', 'a', 's', 'm', 'i', 's'])
  

  (Автор - Раймонд Хеттингер.)

нарезание резьбы¶

Модуль threading имеет новый класс синхронизации Barrier, позволяющий нескольким потокам ожидать, пока все они не достигнут общей точки барьера. Барьеры полезны для обеспечения того, чтобы задача с несколькими предварительными условиями не выполнялась до тех пор, пока не будут выполнены все предшествующие задачи.

Барьеры могут работать с произвольным количеством потоков. Это обобщение Rendezvous, которое определено только для двух потоков.

Реализованный в виде двухфазного циклического барьера, Barrier объекты подходят для использования в циклах. Отдельные фазы заполнения и слива гарантируют, что все потоки будут освобождены (осушены), прежде чем какой-либо из них сможет вернуться в цикл и снова войти в барьер. Барьер полностью сбрасывается после каждого цикла.

Пример использования барьеров:

from threading import Barrier, Thread

def get_votes(site):
    ballots = conduct_election(site)
    all_polls_closed.wait()        # do not count until all polls are closed
    totals = summarize(ballots)
    publish(site, totals)

all_polls_closed = Barrier(len(sites))
for site in sites:
    Thread(target=get_votes, args=(site,)).start()

В этом примере барьер устанавливает правило, согласно которому голоса не могут быть подсчитаны ни на одном избирательном участке до тех пор, пока не будут закрыты все избирательные участки. Обратите внимание, что решение с барьером похоже на решение с threading.Thread.join(), но потоки остаются активными и продолжают выполнять свою работу (подведение итогов голосования) после преодоления барьерной точки.

Если какая-либо из предыдущих задач может зависнуть или быть отложена, можно создать барьер с необязательным параметром timeout. Затем, если период ожидания истекает до того, как все предыдущие задачи достигнут точки барьера, все ожидающие потоки освобождаются и возникает исключение BrokenBarrierError:

def get_votes(site):
    ballots = conduct_election(site)
    try:
        all_polls_closed.wait(timeout=midnight - time.now())
    except BrokenBarrierError:
        lockbox = seal_ballots(ballots)
        queue.put(lockbox)
    else:
        totals = summarize(ballots)
        publish(site, totals)

В этом примере барьер применяет более строгое правило. Если на некоторых избирательных участках работа не завершается до полуночи, время действия барьера истекает, бюллетени опечатываются и помещаются в очередь для последующей обработки.

Смотрите Barrier Synchronization Patterns для получения дополнительных примеров того, как барьеры могут использоваться в параллельных вычислениях. Кроме того, в The Little Book of Semaphores, разделе 3.6, есть простое, но подробное объяснение барьеров.

((Автор - Кристиан Валюр Йонссон, а обзор API - Джеффри Ясскин опубликовал в bpo-8777.)

дата и время¶

• Модуль datetime имеет новый тип timezone, который реализует интерфейс tzinfo, возвращая фиксированное смещение по UTC и название часового пояса. Это упрощает создание объектов даты и времени, зависящих от часового пояса:

  >>> from datetime import datetime, timezone
  
  >>> datetime.now(timezone.utc)
  datetime.datetime(2010, 12, 8, 21, 4, 2, 923754, tzinfo=datetime.timezone.utc)
  
  >>> datetime.strptime("01/01/2000 12:00 +0000", "%m/%d/%Y %H:%M %z")
  datetime.datetime(2000, 1, 1, 12, 0, tzinfo=datetime.timezone.utc)
  

• Кроме того, объекты timedelta теперь можно умножать на float и делить на объекты float и int. И timedelta объекты теперь могут делить друг друга.

• Метод datetime.date.strftime() больше не ограничен годами после 1900 года. Новый поддерживаемый диапазон лет составляет от 1000 до 9999 включительно.

• Всякий раз, когда в кортеже времени используется двузначный год, интерпретация определяется значением time.accept2dyear. Значение по умолчанию равно True, что означает, что для двузначного года столетие определяется в соответствии с правилами POSIX, регулирующими формат strptime %y.

  Начиная с Py3.2, при использовании эвристики угадывания века будет выдаваться значение DeprecationWarning. Вместо этого рекомендуется установить значение time.accept2dyear на False, чтобы можно было использовать большие диапазоны дат без использования догадок:

  >>> import time, warnings
  >>> warnings.resetwarnings()      # remove the default warning filters
  
  >>> time.accept2dyear = True      # guess whether 11 means 11 or 2011
  >>> time.asctime((11, 1, 1, 12, 34, 56, 4, 1, 0))
  Warning (from warnings module):
    ...
  DeprecationWarning: Century info guessed for a 2-digit year.
  'Fri Jan  1 12:34:56 2011'
  
  >>> time.accept2dyear = False     # use the full range of allowable dates
  >>> time.asctime((11, 1, 1, 12, 34, 56, 4, 1, 0))
  'Fri Jan  1 12:34:56 11'
  

  Некоторые функции теперь имеют значительно расширенные диапазоны дат. Когда time.accept2dyear равно false, функция time.asctime() будет принимать любой год, который соответствует C int, в то время как функции time.mktime() и time.strftime() будут принимать весь диапазон функций, поддерживаемых соответствующей операционной системой .

(Материалы предоставлены Александром Белопольским и Виктором Стиннером в bpo-1289118, bpo-5094, bpo-6641, bpo-2706, bpo-1777412, bpo-8013, и bpo-10827.)

математика¶

Модуль math был обновлен шестью новыми функциями, разработанными в соответствии со стандартом C99.

Функция isfinite() обеспечивает надежный и быстрый способ определения специальных значений. Она возвращает True для обычных чисел и False для Nan или Infinity.:

>>> from math import isfinite
>>> [isfinite(x) for x in (123, 4.56, float('Nan'), float('Inf'))]
[True, True, False, False]

Функция expm1() вычисляет e**x-1 для малых значений x без потери точности, которая обычно сопровождает вычитание почти равных величин:

>>> from math import expm1
>>> expm1(0.013671875)   # more accurate way to compute e**x-1 for a small x
0.013765762467652909

Функция erf() вычисляет интеграл вероятности или Gaussian error function. Дополнительная функция ошибки, erfc(), равна 1 - erf(x):

>>> from math import erf, erfc, sqrt
>>> erf(1.0/sqrt(2.0))   # portion of normal distribution within 1 standard deviation
0.682689492137086
>>> erfc(1.0/sqrt(2.0))  # portion of normal distribution outside 1 standard deviation
0.31731050786291404
>>> erf(1.0/sqrt(2.0)) + erfc(1.0/sqrt(2.0))
1.0

Функция gamma() является непрерывным продолжением факториальной функции. Подробности смотрите в разделе https://en.wikipedia.org/wiki/Gamma_function. Поскольку функция связана с факториалами, она становится большой даже при малых значениях x, поэтому существует также функция lgamma() для вычисления натурального логарифма гамма-функции:

>>> from math import gamma, lgamma
>>> gamma(7.0)           # six factorial
720.0
>>> lgamma(801.0)        # log(800 factorial)
4551.950730698041

(Автор: Марк Дикинсон.)

азбука¶

Модуль abc теперь поддерживает abstractclassmethod() и abstractstaticmethod().

Эти инструменты позволяют определить abstract base class, для реализации которого требуется определенный classmethod() или staticmethod():

class Temperature(metaclass=abc.ABCMeta):
    @abc.abstractclassmethod
    def from_fahrenheit(cls, t):
        ...
    @abc.abstractclassmethod
    def from_celsius(cls, t):
        ...

(Патч, представленный Дэниелом Урбаном; bpo-5867.)

ио¶

В io.BytesIO добавлен новый метод, getbuffer(), который обеспечивает функциональность, аналогичную memoryview(). Он создает редактируемое представление данных без создания копии. Произвольный доступ к буферу и поддержка нотации фрагментов хорошо подходят для редактирования на месте:

>>> REC_LEN, LOC_START, LOC_LEN = 34, 7, 11

>>> def change_location(buffer, record_number, location):
...     start = record_number * REC_LEN + LOC_START
...     buffer[start: start+LOC_LEN] = location

>>> import io

>>> byte_stream = io.BytesIO(
...     b'G3805  storeroom  Main chassis    '
...     b'X7899  shipping   Reserve cog     '
...     b'L6988  receiving  Primary sprocket'
... )
>>> buffer = byte_stream.getbuffer()
>>> change_location(buffer, 1, b'warehouse  ')
>>> change_location(buffer, 0, b'showroom   ')
>>> print(byte_stream.getvalue())
b'G3805  showroom   Main chassis    '
b'X7899  warehouse  Reserve cog     '
b'L6988  receiving  Primary sprocket'

(Автор: Антуан Питру в статье bpo-5506.)

повторная публикация¶

При написании метода __repr__() для пользовательского контейнера легко забыть обработать случай, когда элемент ссылается на сам контейнер. Встроенные объекты Python, такие как list и set, обрабатывают самореференцию, отображая «…» в рекурсивной части строки представления.

Чтобы облегчить написание таких методов __repr__(), в модуле reprlib появился новый декоратор recursive_repr(), который обнаруживает рекурсивные вызовы __repr__() и заменяет их строкой-заполнителем:

>>> class MyList(list):
...     @recursive_repr()
...     def __repr__(self):
...         return '<' + '|'.join(map(repr, self)) + '>'
...
>>> m = MyList('abc')
>>> m.append(m)
>>> m.append('x')
>>> print(m)
<'a'|'b'|'c'|...|'x'>

(Материал подготовлен Раймондом Хеттингером в bpo-9826 и bpo-9840.)

регистрация¶

В дополнение к конфигурации на основе словаря, описанной выше, пакет logging имеет множество других улучшений.

Документация по ведению журнала была дополнена basic tutorial, advanced tutorialи cookbook рецептами ведения журнала. Эти документы - самый быстрый способ узнать о ведении журнала.

Функция настройки logging.basicConfig() получила аргумент style для поддержки трех различных типов форматирования строк. По умолчанию используется «%» для традиционного %-форматирования, может быть установлено значение «{» для нового стиля str.format() или может быть установлено значение «$» для форматирования в стиле оболочки, предоставляемого string.Template. Следующие три конфигурации эквивалентны:

>>> from logging import basicConfig
>>> basicConfig(style='%', format="%(name)s -> %(levelname)s: %(message)s")
>>> basicConfig(style='{', format="{name} -> {levelname} {message}")
>>> basicConfig(style='$', format="$name -> $levelname: $message")

Если до возникновения события ведения журнала не была настроена никакая конфигурация, то теперь используется конфигурация по умолчанию с использованием StreamHandler, направленная на sys.stderr для событий уровня WARNING или выше. Ранее событие, произошедшее до настройки конфигурации, либо вызывало исключение, либо автоматически отбрасывало событие в зависимости от значения logging.raiseExceptions. Новый обработчик по умолчанию хранится в logging.lastResort.

Использование фильтров было упрощено. Вместо создания объекта Filter предикатом может быть любой вызываемый объект Python, который возвращает True или False.

Был внесен ряд других улучшений, которые повышают гибкость и упрощают настройку. Полный список изменений в Python 3.2 приведен в документации по модулю.

csv-файл¶

Модуль csv теперь поддерживает новый диалект, unix_dialect, который использует кавычки для всех полей и традиционный стиль Unix с '\n' в качестве окончания строки. Зарегистрированное название диалекта - unix.

В csv.DictWriter есть новый метод, writeheader() для записи начальной строки для документирования имен полей:

>>> import csv, sys
>>> w = csv.DictWriter(sys.stdout, ['name', 'dept'], dialect='unix')
>>> w.writeheader()
"name","dept"
>>> w.writerows([
...     {'name': 'tom', 'dept': 'accounting'},
...     {'name': 'susan', 'dept': 'Salesl'}])
"tom","accounting"
"susan","sales"

(Новый диалект, предложенный Джеем Тэлботом в bpo-5975, и новый метод, предложенный Эдом Абрахамом в bpo-1537721.)

контекстная библиотека¶

Существует новый и немного сногсшибательный инструмент ContextDecorator, который полезен для создания context manager, который выполняет двойную функцию декоратора функций.

Для удобства эта новая функциональность используется contextmanager(), так что для поддержки обеих ролей не требуется никаких дополнительных усилий.

Основная идея заключается в том, что как контекстные менеджеры, так и декораторы функций могут использоваться для создания оболочек до и после выполнения действия. Контекстные менеджеры обертывают группу инструкций, используя инструкцию with, а декораторы функций обертывают группу инструкций, заключенных в функцию. Таким образом, иногда возникает необходимость в написании предварительной или последующей оболочки, которую можно использовать в любой роли.

Например, иногда бывает полезно дополнить функции или группы инструкций средством ведения журнала, которое может отслеживать время входа и время выхода. Вместо того, чтобы писать для задачи как средство оформления функций, так и контекстный менеджер, contextmanager() предоставляет обе возможности в одном определении:

from contextlib import contextmanager
import logging

logging.basicConfig(level=logging.INFO)

@contextmanager
def track_entry_and_exit(name):
    logging.info('Entering: %s', name)
    yield
    logging.info('Exiting: %s', name)

Раньше это можно было использовать только в качестве контекстного менеджера:

with track_entry_and_exit('widget loader'):
    print('Some time consuming activity goes here')
    load_widget()

Теперь его можно использовать и в качестве декоратора:

@track_entry_and_exit('widget loader')
def activity():
    print('Some time consuming activity goes here')
    load_widget()

Попытка выполнять две роли одновременно накладывает некоторые ограничения на технику. Контекстные менеджеры обычно обладают достаточной гибкостью, чтобы возвращать аргумент, используемый оператором with, но аналогов для декораторов функций нет.

В приведенном выше примере не существует простого способа для контекстного менеджера track_entry_and_exit вернуть экземпляр журнала для использования в теле вложенных инструкций.

(Автор: Майкл Фурд в статье bpo-9110.)

десятичная система счисления и дроби¶

Марк Дикинсон разработал элегантную и эффективную схему, гарантирующую, что различные числовые типы данных будут иметь одинаковое хэш-значение всякий раз, когда их фактические значения равны (bpo-8188).:

assert hash(Fraction(3, 2)) == hash(1.5) == \
       hash(Decimal("1.5")) == hash(complex(1.5, 0))

Некоторые детали хэширования доступны с помощью нового атрибута sys.hash_info, который описывает разрядность хэш-значения, модуль простого числа, значения хэша для infinity и nan, а также множитель, используемый для мнимой части числа:

>>> sys.hash_info 
sys.hash_info(width=64, modulus=2305843009213693951, inf=314159, nan=0, imag=1000003)

Ранее было принято решение об ограничении функциональной совместимости различных числовых типов. По-прежнему не поддерживается (и не рекомендуется) неявное смешивание в арифметических выражениях, таких как Decimal('1.1') + float('1.1'), поскольку последнее теряет информацию в процессе построения двоичного числа с плавающей точкой. Однако, поскольку существующее значение с плавающей запятой может быть преобразовано без потерь в десятичное или рациональное представление, имеет смысл добавить их в конструктор и поддерживать сравнения смешанного типа.

• Конструктор decimal.Decimal теперь принимает объекты float напрямую, поэтому больше нет необходимости использовать метод from_float() (bpo-8257).

• Теперь полностью поддерживаются сравнения смешанных типов, так что объекты Decimal можно напрямую сравнивать с объектами float и fractions.Fraction (bpo-2531 и bpo-8188).

Аналогичные изменения были внесены в fractions.Fraction, так что методы from_float() и from_decimal() больше не нужны (bpo-8294):

>>> from decimal import Decimal
>>> from fractions import Fraction
>>> Decimal(1.1)
Decimal('1.100000000000000088817841970012523233890533447265625')
>>> Fraction(1.1)
Fraction(2476979795053773, 2251799813685248)

Другим полезным изменением для модуля decimal является то, что атрибут Context.clamp теперь является общедоступным. Это полезно при создании контекстов, соответствующих десятичным форматам обмена, указанным в IEEE 754 (см. bpo-8540).

(Авторы: Марк Дикинсон и Рэймонд Хеттингер.)

ftp-сервер¶

Класс ftplib.FTP теперь поддерживает протокол управления контекстом для безусловного использования исключений socket.error и закрытия FTP-соединения по завершении:

>>> from ftplib import FTP
>>> with FTP("ftp1.at.proftpd.org") as ftp:
        ftp.login()
        ftp.dir()

'230 Anonymous login ok, restrictions apply.'
dr-xr-xr-x   9 ftp      ftp           154 May  6 10:43 .
dr-xr-xr-x   9 ftp      ftp           154 May  6 10:43 ..
dr-xr-xr-x   5 ftp      ftp          4096 May  6 10:43 CentOS
dr-xr-xr-x   3 ftp      ftp            18 Jul 10  2008 Fedora

Другие файлообразные объекты, такие как mmap.mmap и fileinput.input(), также получили возможность автоматического закрытия контекстных менеджеров:

with fileinput.input(files=('log1.txt', 'log2.txt')) as f:
    for line in f:
        process(line)

((Материалы предоставлены Тареком Зиаде и Джампаоло Родола в bpo-4972, а также Георгом Брандлом в bpo-8046 и bpo-1286.)

Класс FTP_TLS теперь принимает параметр context, который представляет собой объект ssl.SSLContext, позволяющий объединять параметры конфигурации SSL, сертификаты и закрытые ключи в единую (потенциально долговечную) структуру.

(Автор: Джампаоло Родола; bpo-8806.)

всплывающий¶

Функции os.popen() и subprocess.Popen() теперь поддерживают инструкции with для автоматического закрытия файловых дескрипторов.

(Авторы - Антуан Питру и Брайан Кертин в bpo-7461 и bpo-10554.)

выбирать¶

Модуль select теперь предоставляет новый постоянный атрибут PIPE_BUF, который указывает минимальное количество байт, которые гарантированно не будут заблокированы, когда select.select() сообщит, что канал готов к записи.

>>> import select
>>> select.PIPE_BUF  
512

(Доступно в системах Unix. Исправление от Себастьена Сабле в bpo-9862)

gzip и zipfile¶

gzip.GzipFile теперь реализован io.BufferedIOBase abstract base class ( за исключением truncate()). Он также имеет метод peek() и поддерживает невидимые файловые объекты, а также файловые объекты с нулевым заполнением.

Модуль gzip также поддерживает функции compress() и decompress() для упрощения сжатия и распаковки данных в памяти. Имейте в виду, что текст должен быть закодирован как bytes перед сжатием и распаковкой.:

>>> import gzip
>>> s = 'Three shall be the number thou shalt count, '
>>> s += 'and the number of the counting shall be three'
>>> b = s.encode()                        # convert to utf-8
>>> len(b)
89
>>> c = gzip.compress(b)
>>> len(c)
77
>>> gzip.decompress(c).decode()[:42]      # decompress and convert to text
'Three shall be the number thou shalt count'

(Автор - Ананд Б. Пиллаи в bpo-3488; и Антуан Питру, Нир Эйдес и Брайан Кертин в bpo-9962, bpo-1675951, bpo-7471 и bpo-2846.)

Кроме того, класс zipfile.ZipExtFile был переработан для представления файлов, хранящихся в архиве. Новая реализация значительно быстрее и может быть преобразована в объект io.BufferedReader для большего ускорения. Это также решает проблему, из-за которой чередующиеся вызовы read и readline давали неверные результаты.

(Исправление отправлено помощниками Nir в bpo-7610.)

архивный файл¶

Класс TarFile теперь можно использовать в качестве контекстного менеджера. Кроме того, его метод add() имеет новую опцию filter, которая управляет тем, какие файлы добавляются в архив, и позволяет редактировать метаданные файла.

Новая опция filter заменяет старый, менее гибкий параметр exclude, который теперь считается устаревшим. Если он указан, необязательный параметр filter должен быть равен keyword argument. Предоставленная пользователем функция фильтрации принимает объект TarInfo и возвращает обновленный объект TarInfo, или, если требуется исключить файл, функция может вернуть None:

>>> import tarfile, glob

>>> def myfilter(tarinfo):
...     if tarinfo.isfile():             # only save real files
...         tarinfo.uname = 'monty'      # redact the user name
...         return tarinfo

>>> with tarfile.open(name='myarchive.tar.gz', mode='w:gz') as tf:
...     for filename in glob.glob('*.txt'):
...         tf.add(filename, filter=myfilter)
...     tf.list()
-rw-r--r-- monty/501        902 2011-01-26 17:59:11 annotations.txt
-rw-r--r-- monty/501        123 2011-01-26 17:59:11 general_questions.txt
-rw-r--r-- monty/501       3514 2011-01-26 17:59:11 prion.txt
-rw-r--r-- monty/501        124 2011-01-26 17:59:11 py_todo.txt
-rw-r--r-- monty/501       1399 2011-01-26 17:59:11 semaphore_notes.txt

((Предложено Тареком Зиаде и реализовано Ларсом Густабелем в bpo-6856.)

хэшлиб¶

Модуль hashlib имеет два новых постоянных атрибута, в которых перечислены алгоритмы хеширования, которые гарантированно присутствуют во всех реализациях, и те, которые доступны в текущей реализации:

>>> import hashlib

>>> hashlib.algorithms_guaranteed
{'sha1', 'sha224', 'sha384', 'sha256', 'sha512', 'md5'}

>>> hashlib.algorithms_available
{'md2', 'SHA256', 'SHA512', 'dsaWithSHA', 'mdc2', 'SHA224', 'MD4', 'sha256',
'sha512', 'ripemd160', 'SHA1', 'MDC2', 'SHA', 'SHA384', 'MD2',
'ecdsa-with-SHA1','md4', 'md5', 'sha1', 'DSA-SHA', 'sha224',
'dsaEncryption', 'DSA', 'RIPEMD160', 'sha', 'MD5', 'sha384'}

(Предложено Карлом Шене в bpo-7418.)

аст¶

Модуль ast содержит замечательный универсальный инструмент для безопасного вычисления строк выражений с использованием синтаксиса Python literal. Функция ast.literal_eval() служит безопасной альтернативой функции построения eval(), которой легко злоупотребить. Python 3.2 добавляет bytes и set литералы в список поддерживаемых типов: строки, байты, числа, кортежи, списки, диктовки, множества, логические значения и None.

>>> from ast import literal_eval

>>> request = "{'req': 3, 'func': 'pow', 'args': (2, 0.5)}"
>>> literal_eval(request)
{'args': (2, 0.5), 'req': 3, 'func': 'pow'}

>>> request = "os.system('do something harmful')"
>>> literal_eval(request)
Traceback (most recent call last):
  ...
ValueError: malformed node or string: <_ast.Call object at 0x101739a10>

(Реализовано Бенджамином Петерсоном и Георгом Брандлом.)

ос¶

В разных операционных системах используются разные кодировки имен файлов и переменных среды. Модуль os предоставляет две новые функции, fsencode() и fsdecode(), для кодирования и декодирования имен файлов:

>>> import os
>>> filename = 'Sehenswürdigkeiten'
>>> os.fsencode(filename)
b'Sehensw\xc3\xbcrdigkeiten'

Некоторые операционные системы допускают прямой доступ к закодированным байтам в среде. Если это так, то константа os.supports_bytes_environ будет иметь значение true.

Для прямого доступа к закодированным переменным среды (если они доступны) используйте новую функцию os.getenvb() или используйте os.environb, которая является байтовой версией os.environ.

(Автор: Виктор Стиннер.)

выключил¶

Функция shutil.copytree() имеет две новые опции:

• ignore_dangling_symlinks: когда symlinks=False, функция копирует файл, на который указывает символическая ссылка, а не саму символическую ссылку. Этот параметр отключает ошибку, возникающую, если файл не существует.

• copy_function: вызываемая функция, которая будет использоваться для копирования файлов. shutil.copy2() используется по умолчанию.

((Автор: Тарек Зиаде.)

Кроме того, модуль shutil теперь поддерживает archiving operations для zip-файлов, несжатых tar-файлов, gzip-файлов tar и bzip-файлов tar. Также есть функции для регистрации дополнительных форматов архивируемых файлов (таких как xz-сжатые tarf-файлы или пользовательские форматы).

Основными функциями являются make_archive() и unpack_archive(). По умолчанию обе работают с текущим каталогом (который можно задать с помощью os.chdir()) и с любыми подкаталогами. В имени файла архива необходимо указать полный путь. Процесс архивации является неразрушающим (исходные файлы сохраняются без изменений).

>>> import shutil, pprint

>>> os.chdir('mydata')  # change to the source directory
>>> f = shutil.make_archive('/var/backup/mydata',
...                         'zip')      # archive the current directory
>>> f                                   # show the name of archive
'/var/backup/mydata.zip'
>>> os.chdir('tmp')                     # change to an unpacking
>>> shutil.unpack_archive('/var/backup/mydata.zip')  # recover the data

>>> pprint.pprint(shutil.get_archive_formats())  # display known formats
[('bztar', "bzip2'ed tar-file"),
 ('gztar', "gzip'ed tar-file"),
 ('tar', 'uncompressed tar file'),
 ('zip', 'ZIP file')]

>>> shutil.register_archive_format(     # register a new archive format
...     name='xz',
...     function=xz.compress,           # callable archiving function
...     extra_args=[('level', 8)],      # arguments to the function
...     description='xz compression'
... )

((Автор: Тарек Зиаде.)

sqlite3¶

Модуль sqlite3 был обновлен до версии pysqlite 2.6.0. В нем появились две новые возможности.

• Атрибут sqlite3.Connection.in_transit имеет значение true, если существует активная транзакция для незафиксированных изменений.

• Методы sqlite3.Connection.enable_load_extension() и sqlite3.Connection.load_extension() позволяют загружать расширения SQLite из файлов «.so». Одним из хорошо известных расширений является расширение для полнотекстового поиска, распространяемое вместе с SQLite.

(Авторы: Р. Дэвид Мюррей и Шашват Ананд; bpo-8845.)

HTML¶

Был представлен новый модуль html, содержащий только одну функцию, escape(), которая используется для экранирования зарезервированных символов из HTML-разметки:

>>> import html
>>> html.escape('x > 2 && x < 7')
'x &gt; 2 &amp;&amp; x &lt; 7'

разъем¶

Модуль socket имеет два новых улучшения.

• У объектов Socket теперь есть метод detach(), который переводит сокет в закрытое состояние без фактического закрытия базового файлового дескриптора. Последний затем можно повторно использовать для других целей. (Добавлено Антуаном Питру; bpo-8524.)

• socket.create_connection() теперь поддерживается протокол управления контекстом для безусловного использования исключений socket.error и закрытия сокета по завершении. (Автор: Джампаоло Родола; bpo-9794.)

протокол ssl¶

Модуль ssl добавил ряд функций, удовлетворяющих общим требованиям к безопасным (зашифрованным, аутентифицированным) подключениям к Интернету:

• Новый класс, SSLContext, служит контейнером для постоянных данных SSL, таких как настройки протокола, сертификаты, закрытые ключи и различные другие параметры. Он включает в себя wrap_socket() для создания SSL-сокета из контекста SSL.

• Новая функция, ssl.match_hostname(), поддерживает проверку подлинности сервера для протоколов более высокого уровня, реализуя правила HTTPS (из RFC 2818), которые также подходят для других протоколов.

• Функция-конструктор ssl.wrap_socket() теперь принимает аргумент ciphers. В строке ciphers перечислены разрешенные алгоритмы шифрования в формате, описанном в OpenSSL documentation.

• При подключении к последним версиям OpenSSL модуль ssl теперь поддерживает расширение протокола TLS для указания имени сервера, позволяющее нескольким «виртуальным хостам» использовать разные сертификаты на одном IP-порту. Это расширение поддерживается только в клиентском режиме и активируется путем передачи аргумента server_hostname в значение ssl.SSLContext.wrap_socket().

• В модуль ssl добавлены различные опции, такие как OP_NO_SSLv2, которая отключает небезопасный и устаревший протокол SSLv2.

• Теперь расширение загружает все шифры OpenSSL и алгоритмы дайджеста. Если некоторые SSL-сертификаты не могут быть проверены, о них сообщается как об ошибке «неизвестный алгоритм».

• Используемая версия OpenSSL теперь доступна с помощью атрибутов модуля ssl.OPENSSL_VERSION (строка), ssl.OPENSSL_VERSION_INFO ( кортеж из 5) и ssl.OPENSSL_VERSION_NUMBER (целое число).

(Предоставлено Антуаном Питру в bpo-8850, bpo-1589, bpo-8322, bpo-5639, bpo-4870, bpo-8484, и bpo-8321.)

nntp¶

Модуль nntplib имеет обновленную реализацию с улучшенной семантикой байтов и текста, а также более практичными API. Эти улучшения нарушают совместимость с версией nntplib в Python 3.1, которая сама по себе была частично неработоспособной.

Также была добавлена поддержка защищенных подключений как через неявный (с использованием nntplib.NNTP_SSL), так и через явный (с использованием nntplib.NNTP.starttls()) протокол TLS.

(Авторы: Антуан Питру в bpo-9360 и Эндрю Вант в bpo-1926.)

сертификаты¶

http.client.HTTPSConnection, urllib.request.HTTPSHandler и urllib.request.urlopen() теперь примите необязательные аргументы, чтобы разрешить проверку сертификата сервера с помощью набора центров сертификации, как рекомендуется при публичном использовании HTTPS.

(Добавлено Антуаном Питру, bpo-9003.)

imaplib¶

Поддержка явного TLS для стандартных подключений IMAP4 была добавлена с помощью нового метода imaplib.IMAP4.starttls.

(Авторы: Лоренцо М. Катуччи и Антуан Питру, bpo-4471.)

http.клиент¶

В модуле http.client был внесен ряд небольших улучшений в API. Простые ответы HTTP 0.9 старого образца больше не поддерживаются, а параметр strict устарел во всех классах.

Классы HTTPConnection и HTTPSConnection теперь имеют параметр source_address для кортежа (хост, порт), указывающий, откуда осуществляется HTTP-соединение.

В HTTPSConnection была добавлена поддержка проверки сертификатов и виртуальных хостов HTTPS.

Метод request() для объектов connection допускал необязательный аргумент body, так что для предоставления содержимого запроса можно было использовать file object. Удобно, что аргумент body теперь также принимает объект iterable, если он содержит явный заголовок Content-Length. Этот расширенный интерфейс стал гораздо более гибким, чем раньше.

Для установления HTTPS-соединения через прокси-сервер существует новый метод set_tunnel(), который устанавливает хост и порт для туннелирования HTTP-соединения.

Чтобы соответствовать поведению http.server, клиентская библиотека HTTP теперь также кодирует заголовки в кодировке ISO-8859-1 (Latin-1). Это уже делалось для входящих заголовков, так что теперь поведение согласовано как для входящего, так и для исходящего трафика. (Смотрите работу Армина Ронахера в bpo-10980.)

единичный тест¶

Модуль unittest содержит ряд улучшений, поддерживающих обнаружение тестов для пакетов, упрощающих экспериментирование в интерактивном режиме, новые методы тестирования, улучшенные диагностические сообщения о сбоях тестирования и улучшенные названия методов.

• Вызов командной строки python -m unittest теперь может принимать пути к файлам вместо имен модулей для выполнения определенных тестов (bpo-10620). Новое средство обнаружения тестов позволяет находить тесты внутри пакетов, обнаруживая любой тест, который можно импортировать из каталога верхнего уровня. Каталог верхнего уровня можно указать с помощью параметра -t, шаблон для сопоставления файлов с -p и каталог для запуска поиска с помощью -s:

  $ python -m unittest discover -s my_proj_dir -p _test.py
  

  (Автор: Майкл Фурд.)

• Экспериментировать с интерактивной подсказкой теперь стало проще, поскольку класс unittest.TestCase теперь может быть создан без аргументов:

  >>> from unittest import TestCase
  >>> TestCase().assertEqual(pow(2, 3), 8)
  

  (Автор: Майкл Фурд.)

• Модуль unittest содержит два новых метода: assertWarns() и assertWarnsRegex() для проверки того, что тестируемый код запускает данный тип предупреждения:

  with self.assertWarns(DeprecationWarning):
      legacy_function('XYZ')
  

  (Автор: Антуан Питру, bpo-9754.)

  Другой новый метод, assertCountEqual(), используется для сравнения двух итераций, чтобы определить, равно ли количество их элементов (присутствуют ли одни и те же элементы с одинаковым количеством вхождений независимо от порядка).:

  def test_anagram(self):
      self.assertCountEqual('algorithm', 'logarithm')
  

  (Автор - Раймонд Хеттингер.)

• Основной особенностью модуля unittest является попытка провести значимую диагностику при сбое теста. Когда это возможно, сбой регистрируется вместе с результатами тестирования. Это особенно полезно для анализа файлов журналов неудачных запусков тестов. Однако, поскольку различия иногда могут быть объемными, появился новый атрибут maxDiff, который устанавливает максимальную длину отображаемых различий.

• Кроме того, названия методов в модуле подверглись ряду исправлений.

  Например, assertRegex() - это новое имя для assertRegexpMatches(), которое было неправильно названо, поскольку в тесте используется re.search(), а не re.match(). Другие методы, использующие регулярные выражения, теперь называются с использованием краткой формы «Regex» вместо «Regexp» - это соответствует именам, используемым в других реализациях unittest, соответствует старому названию модуля re в Python и имеет однозначную верблюжью оболочку.

  (Автор - Раймонд Хеттингер, автор - Эцио Мелотти.)

• Чтобы повысить согласованность, некоторые давние псевдонимы методов устарели в пользу предпочтительных имен:

  Старое название	Предпочитаемое имя
  assert_()	assertTrue()
  assertEquals()	assertEqual()
  assertNotEquals()	assertNotEqual()
  assertAlmostEquals()	assertAlmostEqual()
  assertNotAlmostEquals()	assertNotAlmostEqual()

  Аналогичным образом, ожидается, что методы TestCase.fail*, которые устарели в Python 3.1, будут удалены в Python 3.3. Также смотрите раздел Устаревшие псевдонимы в документации unittest.

  (Автор: Эцио Мелотти; bpo-9424.)

• Метод assertDictContainsSubset() был признан устаревшим, поскольку он был неправильно реализован с аргументами в неправильном порядке. Это создавало труднообрабатываемые оптические иллюзии, при которых тесты, подобные TestCase().assertDictContainsSubset({'a':1, 'b':2}, {'a':1}), завершались неудачей.

  (Автор - Раймонд Хеттингер.)

случайный¶

Целочисленные методы в модуле random теперь лучше справляются с получением равномерных распределений. Ранее они вычисляли выборки с помощью int(n*random()), которые имели небольшое отклонение всякий раз, когда n не было степенью двойки. Теперь выполняется множественный выбор в диапазоне до следующей степени двойки, и выбор сохраняется только в том случае, если он попадает в диапазон 0 <= x < n. Затронутыми функциями и методами являются randrange(), randint(), choice(), shuffle() и sample().

(Автор: Раймонд Хеттингер; bpo-9025.)

поплиб¶

POP3_SSL класс теперь принимает параметр context, который представляет собой объект ssl.SSLContext, позволяющий объединять параметры конфигурации SSL, сертификаты и закрытые ключи в единую (потенциально долговечную) структуру.

(Автор: Джампаоло Родола; bpo-8807.)

асинхронный процессор¶

asyncore.dispatcher теперь предоставляет метод handle_accepted(), возвращающий пару (sock, addr), который вызывается, когда фактически установлено соединение с новой удаленной конечной точкой. Предполагается, что это будет использоваться в качестве замены старого handle_accept() и позволит пользователю не вызывать accept() напрямую.

(Автор: Джампаоло Родола; bpo-6706.)

временный файл¶

Модуль tempfile имеет новый контекстный менеджер, TemporaryDirectory который обеспечивает простую детерминированную очистку временных каталогов:

with tempfile.TemporaryDirectory() as tmpdirname:
    print('created temporary dir:', tmpdirname)

(Авторы - Нил Шеменауэр и Ник Коглан; bpo-5178.)

проверить¶

• В модуле inspect появилась новая функция getgeneratorstate(), позволяющая легко определять текущее состояние генератора-итератора:

  >>> from inspect import getgeneratorstate
  >>> def gen():
  ...     yield 'demo'
  >>> g = gen()
  >>> getgeneratorstate(g)
  'GEN_CREATED'
  >>> next(g)
  'demo'
  >>> getgeneratorstate(g)
  'GEN_SUSPENDED'
  >>> next(g, None)
  >>> getgeneratorstate(g)
  'GEN_CLOSED'
  

  (Авторы: Родольфо Экхардт и Ник Коглан, bpo-10220.)

• Для поддержки поиска без возможности активации динамического атрибута в модуле inspect добавлена новая функция getattr_static(). В отличие от hasattr(), это настоящий поиск только для чтения, гарантирующий, что состояние не изменится во время поиска:

  >>> class A:
  ...     @property
  ...     def f(self):
  ...         print('Running')
  ...         return 10
  ...
  >>> a = A()
  >>> getattr(a, 'f')
  Running
  10
  >>> inspect.getattr_static(a, 'f')
  <property object at 0x1022bd788>
  

(Автор: Майкл Фурд.)

pydoc¶

Модуль pydoc теперь предоставляет значительно улучшенный интерфейс веб-сервера, а также новую опцию командной строки -b, позволяющую автоматически открывать окно браузера для отображения этого сервера:

$ pydoc3.2 -b

(Автор: Рон Адам; bpo-2001.)

дис¶

Модуль dis получил две новые функции для проверки кода, code_info() и show_code(). Обе предоставляют подробную информацию об объекте кода для предоставленной функции, метода, строки исходного кода или объекта кода. Первый возвращает строку, а второй выводит ее на экран:

>>> import dis, random
>>> dis.show_code(random.choice)
Name:              choice
Filename:          /Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/random.py
Argument count:    2
Kw-only arguments: 0
Number of locals:  3
Stack size:        11
Flags:             OPTIMIZED, NEWLOCALS, NOFREE
Constants:
   0: 'Choose a random element from a non-empty sequence.'
   1: 'Cannot choose from an empty sequence'
Names:
   0: _randbelow
   1: len
   2: ValueError
   3: IndexError
Variable names:
   0: self
   1: seq
   2: i

Кроме того, функция dis() теперь принимает строковые аргументы, так что распространенная идиома dis(compile(s, '', 'eval')) может быть сокращена до dis(s):

>>> dis('3*x+1 if x%2==1 else x//2')
  1           0 LOAD_NAME                0 (x)
              3 LOAD_CONST               0 (2)
              6 BINARY_MODULO
              7 LOAD_CONST               1 (1)
             10 COMPARE_OP               2 (==)
             13 POP_JUMP_IF_FALSE       28
             16 LOAD_CONST               2 (3)
             19 LOAD_NAME                0 (x)
             22 BINARY_MULTIPLY
             23 LOAD_CONST               1 (1)
             26 BINARY_ADD
             27 RETURN_VALUE
        >>   28 LOAD_NAME                0 (x)
             31 LOAD_CONST               0 (2)
             34 BINARY_FLOOR_DIVIDE
             35 RETURN_VALUE

Взятые вместе, эти улучшения упрощают изучение того, как реализован CPython, и позволяют самостоятельно увидеть, что делает синтаксис языка «под капотом».

(Автор: Ник Коглан в статье bpo-9147.)

дбм¶

Все модули базы данных теперь поддерживают методы get() и setdefault().

(Предложено Рэем Алленом в bpo-9523.)

типы данных¶

Новый тип ctypes.c_ssize_t представляет тип данных C ssize_t.

сайт¶

Модуль site содержит три новые функции, полезные для составления отчетов о деталях конкретной установки Python.

• getsitepackages() содержит список всех глобальных каталогов пакетов сайтов.

• getuserbase() сообщает о базовом каталоге пользователя, в котором могут храниться данные.

• getusersitepackages() показывает путь к каталогу пакетов сайта для конкретного пользователя.

>>> import site
>>> site.getsitepackages()
['/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/site-packages',
 '/Library/Frameworks/Python.framework/Versions/3.2/lib/site-python',
 '/Library/Python/3.2/site-packages']
>>> site.getuserbase()
'/Users/raymondhettinger/Library/Python/3.2'
>>> site.getusersitepackages()
'/Users/raymondhettinger/Library/Python/3.2/lib/python/site-packages'

Удобно, что некоторые функции сайта доступны непосредственно из командной строки:

$ python -m site --user-base
/Users/raymondhettinger/.local
$ python -m site --user-site
/Users/raymondhettinger/.local/lib/python3.2/site-packages

(Автор: Тарек Зиаде в статье bpo-6693.)

системная настройка¶

Новый модуль sysconfig упрощает поиск путей установки и переменных конфигурации, которые различаются в зависимости от платформы и установки.

Модуль предоставляет доступ к простым функциям доступа к информации о платформе и версии:

• get_platform() возвращает значения типа linux-i586 или macosx-10.6-ppc.

• get_python_version() возвращает строку версии Python, например «3.2».

Он также предоставляет доступ к путям и переменным, соответствующим одной из семи именованных схем, используемых distutils. К ним относятся posix_prefix, posix_home, posix_user, nt, nt_user, os2, os2_home:

• get_paths() создает словарь, содержащий пути установки для текущей схемы установки.

• get_config_vars() возвращает словарь переменных, зависящих от платформы.

Существует также удобный интерфейс командной строки:

C:\Python32>python -m sysconfig
Platform: "win32"
Python version: "3.2"
Current installation scheme: "nt"

Paths:
        data = "C:\Python32"
        include = "C:\Python32\Include"
        platinclude = "C:\Python32\Include"
        platlib = "C:\Python32\Lib\site-packages"
        platstdlib = "C:\Python32\Lib"
        purelib = "C:\Python32\Lib\site-packages"
        scripts = "C:\Python32\Scripts"
        stdlib = "C:\Python32\Lib"

Variables:
        BINDIR = "C:\Python32"
        BINLIBDEST = "C:\Python32\Lib"
        EXE = ".exe"
        INCLUDEPY = "C:\Python32\Include"
        LIBDEST = "C:\Python32\Lib"
        SO = ".pyd"
        VERSION = "32"
        abiflags = ""
        base = "C:\Python32"
        exec_prefix = "C:\Python32"
        platbase = "C:\Python32"
        prefix = "C:\Python32"
        projectbase = "C:\Python32"
        py_version = "3.2"
        py_version_nodot = "32"
        py_version_short = "3.2"
        srcdir = "C:\Python32"
        userbase = "C:\Documents and Settings\Raymond\Application Data\Python"

(Удалено из дистрибутива Тареком Зиаде.)

pdb (почтовый индекс)¶

Модуль отладчика pdb получил ряд улучшений в удобстве использования:

• pdb.py теперь есть опция -c, которая выполняет команды, указанные в файле сценария .pdbrc.

• Файл сценария .pdbrc может содержать continue и next команды, которые продолжают отладку.

• Конструктор класса Pdb теперь принимает аргумент nosigint.

• Новые команды: l(list), ll(long list) и source для отображения исходного кода.

• Новые команды: display и undisplay для отображения или скрытия значения выражения, если оно изменилось.

• Новая команда: interact для запуска интерактивного интерпретатора, содержащего глобальные и локальные имена, найденные в текущей области видимости.

• Точки останова могут быть очищены по номеру точки останова.

(Авторы: Георг Брандл, Антонио Куни и Илья Сандлер.)

анализатор конфигурации¶

Модуль configparser был изменен для улучшения удобства использования и предсказуемости синтаксического анализатора по умолчанию и поддерживаемого им синтаксиса INI. Старый класс ConfigParser был удален в пользу SafeConfigParser, который, в свою очередь, был переименован в ConfigParser. Поддержка встроенных комментариев теперь отключена по умолчанию, и дублирование разделов или параметров запрещено в одном источнике конфигурации.

Анализаторы конфигурации получили новый API, основанный на протоколе сопоставления:

>>> parser = ConfigParser()
>>> parser.read_string("""
... [DEFAULT]
... location = upper left
... visible = yes
... editable = no
... color = blue
...
... [main]
... title = Main Menu
... color = green
...
... [options]
... title = Options
... """)
>>> parser['main']['color']
'green'
>>> parser['main']['editable']
'no'
>>> section = parser['options']
>>> section['title']
'Options'
>>> section['title'] = 'Options (editable: %(editable)s)'
>>> section['title']
'Options (editable: no)'

Новый API реализован поверх классического API, поэтому пользовательские подклассы синтаксического анализатора должны иметь возможность использовать его без изменений.

Структура INI-файла, принятая анализаторами конфигурации, теперь может быть изменена. Пользователи могут указать альтернативные разделители параметров/значений и префиксы комментариев, изменить название раздела «ПО УМОЛЧАНИЮ» или переключить синтаксис интерполяции.

Имеется поддержка подключаемой интерполяции, включая дополнительный обработчик интерполяции ExtendedInterpolation:

>>> parser = ConfigParser(interpolation=ExtendedInterpolation())
>>> parser.read_dict({'buildout': {'directory': '/home/ambv/zope9'},
...                   'custom': {'prefix': '/usr/local'}})
>>> parser.read_string("""
... [buildout]
... parts =
...   zope9
...   instance
... find-links =
...   ${buildout:directory}/downloads/dist
...
... [zope9]
... recipe = plone.recipe.zope9install
... location = /opt/zope
...
... [instance]
... recipe = plone.recipe.zope9instance
... zope9-location = ${zope9:location}
... zope-conf = ${custom:prefix}/etc/zope.conf
... """)
>>> parser['buildout']['find-links']
'\n/home/ambv/zope9/downloads/dist'
>>> parser['instance']['zope-conf']
'/usr/local/etc/zope.conf'
>>> instance = parser['instance']
>>> instance['zope-conf']
'/usr/local/etc/zope.conf'
>>> instance['zope9-location']
'/opt/zope'

Также был добавлен ряд более мелких функций, таких как поддержка указания кодировки в операциях чтения, указание резервных значений для функций get или чтение непосредственно из словарей и строк.

(Все изменения внес Лукаш Ланга.)

urllib.синтаксический анализ¶

Для модуля urllib.parse был внесен ряд улучшений в удобство использования.

Функция urlparse() теперь поддерживает IPv6 адресов, как описано в RFC 2732:

>>> import urllib.parse
>>> urllib.parse.urlparse('http://[dead:beef:cafe:5417:affe:8FA3:deaf:feed]/foo/') 
ParseResult(scheme='http',
            netloc='[dead:beef:cafe:5417:affe:8FA3:deaf:feed]',
            path='/foo/',
            params='',
            query='',
            fragment='')

Функция urldefrag() теперь возвращает значение named tuple:

>>> r = urllib.parse.urldefrag('http://python.org/about/#target')
>>> r
DefragResult(url='http://python.org/about/', fragment='target')
>>> r[0]
'http://python.org/about/'
>>> r.fragment
'target'

Кроме того, функция urlencode() теперь стала гораздо более гибкой, принимая в качестве аргумента query либо тип string, либо тип bytes. Если это строка, то параметры safe, encoding и error отправляются в quote_plus() для кодирования:

>>> urllib.parse.urlencode([
...      ('type', 'telenovela'),
...      ('name', '¿Dónde Está Elisa?')],
...      encoding='latin-1')
'type=telenovela&name=%BFD%F3nde+Est%E1+Elisa%3F'

Как подробно описано в Синтаксический анализ байтов, закодированных в формате ASCII, все функции urllib.parse теперь принимают в качестве входных данных байтовые строки в кодировке ASCII, если они не смешаны с обычными строками. Если в качестве параметров заданы байтовые строки в кодировке ASCII, то возвращаемые типы также будут байтовыми строками в кодировке ASCII:

>>> urllib.parse.urlparse(b'http://www.python.org:80/about/') 
ParseResultBytes(scheme=b'http', netloc=b'www.python.org:80',
                 path=b'/about/', params=b'', query=b'', fragment=b'')

(Работа Ника Коглана, Дэна Мана и Сентила Кумарана в книге bpo-2987, bpo-5468, и bpo-9873.)

почтовый ящик¶

Благодаря совместным усилиям Р. Дэвида Мюррея в Python 3.2 был исправлен модуль mailbox. Проблема заключалась в том, что изначально почтовый ящик был спроектирован с текстовым интерфейсом, но сообщения электронной почты лучше всего отображать с помощью bytes, поскольку различные части сообщения могут быть изменены. могут иметь разные кодировки.

Решение использовало двоичную поддержку пакета email для анализа произвольных сообщений электронной почты. Кроме того, решение потребовало внесения ряда изменений в API.

Как и ожидалось, метод add() для объектов mailbox.Mailbox теперь принимает двоичный ввод.

StringIO и ввод текстового файла устарели. Кроме того, ввод строки завершится ошибкой на ранней стадии, если используются символы, отличные от ASCII. Ранее это приводило к сбою при обработке электронного письма на более позднем этапе.

Также поддерживается двоичный вывод. Метод get_file() теперь возвращает файл в двоичном режиме (раньше он неправильно переводил файл в текстовый режим). Существует также новый метод get_bytes(), который возвращает bytes представление сообщения, соответствующего заданному ключу.

Все еще возможно получить недвоичный вывод, используя метод get_string() старого API, но этот подход не очень полезен. Вместо этого лучше извлекать сообщения из объекта Message или загружать их из двоичного ввода.

(Автор - Р. Дэвид Мюррей, при содействии Штеффена Даоде Нурпмесо и первоначальном исправлении Виктором Стиннером в bpo-9124.)

обезглавленный демон¶

Демонстрационный код для модуля turtle был перенесен из каталога Demo в основную библиотеку. Он включает в себя более десятка примеров сценариев с живым отображением. Поскольку он включен в sys.path, его теперь можно запускать непосредственно из командной строки:

$ python -m turtledemo

(Перенесено из демонстрационного каталога Александром Белопольским в bpo-10199.)