# What's New in Python 2.7

著者

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

この文書は Python 2.7 の新機能について解説します。Python 2.7 は 2010 年 7 月 3 日にリリースされました。

数値周りの扱いが、浮動小数点数でも `Decimal` クラスでもいろいろな点で改良されました、標準ライブラリにいくつかの有用な追加が行われました。 `unittest` モジュールが大幅に改良され、コマンドラインオプション解析の `argparse` モジュールが追加され、 `collections` モジュールに便利な `OrderedDict` と `Counter` が追加され、他にもたくさんの改良が行われています。

Python 2.7 は 2.x の最終リリースになることが予定されているので、私たちはこのリリースを長期にわたって良いものになるように努力してきました。Python 3 への移植を助けるため、いくつかの新機能が Python 3.x から Python 2.7 に取り込まれています。

このドキュメントは新機能の完全な詳細を提供するのではなくて、簡易な概要を提供することを目的にしています。完全な詳細が知りたければ、 https://docs.python.org の Python 2.7 のドキュメントを参照してください。設計と実装の根拠を理解したい場合は、新機能に関する PEP を参照するか、 https://bugs.python.org に議論したい機能について登録してください。可能な限り、 "What's New in Python" は各変更の bug や patch に対してリンクしています。

## Python 2.x の今後

Python 2.7 は 2.x シリーズの最後のメジャーリリースになります。Python のメンテナは既に Python 3.x シリーズへの新機能の開発に焦点をシフトしています。Python 2 は今後もバグフィックスを受け容れ、新しいハードウェアやサポートしている OS のバージョンでのビルドが出来るように保つ一方で、言語や標準ライブラリの新しい完全な機能のリリースは行いません。

しかしながら、Python 2.7 と Python 3 の間の共通の大きなサブセットがあって、その共通サブセットあるいは直接的に Python 3 のものへの移行に伴う多くの変更が安全に自動的に行える一方で、その他の変更(Unicode の扱いに関係するものに顕著ですが)入念な検討を必要とし、移行を有効に行うためには堅牢な回帰テストスイートが望まれることでしょう。

これは Python 2.7 が長期間に渡って依然として有効であり、安定性と、Python 3 がいまだに移植されていないような製品システムのベースプラットフォームのサポートを提供し続けることを意味しています。Python 2.7 シリーズに望まれているライフサイクルについての完全な詳細は、 PEP 373 に記述されています。

2.7 が長期的に重要なリリースになるので、いくつかの結論があります:

- 上述のように、 2.7 リリースは以前の 2.x バージョンに較べて遥かに長期間のメンテナンスとなります。Python 2.7 は現在では、最低でも 2020 年までコア開発チームによって(セキュリティアップデートやほかのバグフィックスの)サポートがなされ続けることが求められています(最初のリリースから 10 年後です。普通であれば 18--24 ヶ月なのに)。

- Python 2.7 標準ライブラリが年老いていくに従い、(直接であれ再配布であれ) Python Package Index の効果的な利用が Python 2 ユーザにとってますます重要になっています。さまざまなタスクをこなすありとあらゆるサードパーティパッケージに加え、Python 2 互換の、Python 3 標準ライブラリからバックポートした新しいモジュールや機能を含むパッケージ、Python 3 への移行を容易にするための様々なツールやライブラリが入手出来ます。Python Packaging User Guide は Python Package Index からソフトウェアをダウンロード・インストールする際のガイダンスです。

- Python 2 を拡張するための望ましいアプローチは現在では Python Package Index に新しいパッケージを公開することである一方で、このアプローチが全てのケースで求められるわけではありません。特にそれがネットワークセキュリティに関係している場合には。PyPI に新規もしくは更新パッケージを公開することでは十分ではない例外的なケースにおいては、Python 2 標準ライブラリに直接新機能を追加するために Python Enhancement Proposal プロセスが使われるでしょう。そのような追加の全てと、それらが追加されたメンテナンスリリースは、下の方の Python 2.7 メンテナンスリリースで追加された新機能 セクションで言及されます。

Python 2 から Python 3 へ乗り換えたいと望むプロジェクトあるいはPython 2 と Python 3 両方のユーザをサポートしたいと願うライブラリやフレームワークの開発者向けに、さまざまなツールやガイドがあります。これらは、相応しいアプローチを決めたりある種複雑な技術的詳細の管理をする手助けとなるでしょう。まず手始めには Python 2 から Python 3 への移植 HOWTO ガイドをご覧になることをお奨めします。

## Deprecation Warnings の扱いの変更

Python 2.7 では開発者向けの警告をデフォルトで抑止するポリシーが取られました。 `DeprecationWarning` とそれを継承した警告は、指定されない限りは無視され、アプリケーションのユーザーがその警告を見ないですむようになりました。この変更は Python 3.2 ブランチにも適用されました。 (stdlib-sig で討議され、 bpo-7319 になりました)

以前のリリースでは、 `DeprecationWarning` メッセージはデフォルトで有効になっており、 Python 開発者に、将来のバージョンの Python でそのコードのどこが動かなくなるかを明確に知らせていました。

しかし、 Python で開発されたアプリケーションの利用者であって開発には携わっていない人がどんどん増えてきました。 `DeprecationWarning` メッセージはそれらのユーザーには無関係で、彼らをアプリケーションが本当に正しく動いているのか不安にさせ、ユーザーの質問に応えるための開発者の負担も増やしていました。

`DeprecationWarning` メッセージの表示を有効にするには、 `-Wdefault` (短い形式: `-Wd`) スイッチか、Python を実行する前に `PYTHONWARNINGS` 環境変数を `"default"` (か、 `"d"`)に設定します。 Python コードから有効にする場合は `warnings.simplefilter('default')` とします。

`unittest` モジュールもテスト実行時に自動的に deprecation warnings を有効にします。

## Python 3.1 の機能

Python 2.6 は Python 3.0 から多くの機能を取り込み、Python 2.7 は Python 3.1 の新しい機能のいくつかを取り込みました。2.x シリーズは 3.x シリーズへの移行のためのツールを提供し続けています。

Python 2.7 に取り込まれた 3.1 の機能の不完全なリスト:

- 集合のリテラル文法 (`{1,2,3}` は mutable set になります)

- 辞書と集合の内包表記 (`{i: i*2 for i in range(3)}`).

- 1つの `with` 文で複数のコンテキストマネージャを扱えるように。

- `io` ライブラリの新バージョン。パフォーマンスのためにC言語で描き直されています。

- PEP 372: collections に順序付き辞書を追加 で解説されている順序付き辞書

- PEP 378: 1000区切りのための書式指定子 で解説されている新しい `","` フォーマット指定子

- `memoryview` オブジェクト

- `importlib` モジュールの小さいサブセット。 下に説明があります

- float `x` の `repr()` が多くの場合に短くなりました。これは `x` に戻せることが保証される最小の10進文字列です。以前のバージョンの Python では、 `float(repr(x))` が `x` になることだけが保証されていました。

- float から文字列、文字列から float への変換が正しく丸められるようになりました。 `round()` 関数も正しく丸めるようになりました。

- 拡張モジュールが C API を提供するための、 `PyCapsule` 型

- `PyLong_AsLongAndOverflow()` C API 関数

新しい Python3 モード Warning:

- `operator.isCallable()` と `operator.sequenceIncludes()` は 3.x ではサポートされず、 warning になります。

- `-3` スイッチは、整数または長整数での古い除算方式を使用した場合に警告を出力するようになる `-Qwarn` スイッチを有効にするようになりました。

## PEP 372: collections に順序付き辞書を追加

通常の Python 辞書は、 key/value ペアを不定の順序でイテレートします。何年にもわたり、いろいろな人が key の挿入順を保存する辞書の別実装を書いてきました。その経験に基づき、 2.7 は `collections` モジュールに新しい `OrderedDict` クラスを追加しました。

`OrderedDict` API は通常の辞書と同じインタフェースを提供していますが、 key/value をイテレートするときに key が最初に挿入された順番になることが保証されています。

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

新しいエントリが既存のエントリを上書きした場合は、元の挿入順序が保持されます。:

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

エントリを削除して再挿入すると、順序は一番最後に移動します。:

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

`popitem()` メソッドは、オプションの last 引数を持ち、でフォルトで `True` になっています。 last が真の場合、一番最近に追加された key が返され、削除されます。偽の場合、最も古い key が選ばれます:

    >>> 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)

2つの順序付き辞書を比較するときは、key/value だけでなく、挿入順も比較されます。:

    >>> 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

`OrderedDict` を通常の辞書と比較すると、挿入順は無視されて単に key/value だけが比較されます。

`OrderedDict` の実装はこうなっています。 key の2重リンクリストを管理し、新しい key が挿入されるときにリストに新しい key を追加します。2つ目の辞書が key を対応するリストノードにマップします。なので、削除時にリンクリストを操作する必要はなく、コストは O(1) に保たれています。

標準ライブラリのいくつかのモジュールで、順序付き辞書の利用がサポートされています。

- `ConfigParser` モジュールはデフォルトで順序付き辞書を使います。設定ファイルを読み込み、編集した後、元の順序で書きなおすことができます。

- `collections.namedtuple()` の `_asdict()` メソッドは、タプルの順序と同じ順序の順序付き辞書を返すようになりました。

- `json` モジュールのデコーダーが `OrderedDict` をビルドするのをサポートするために、 `JSONDecoder` クラスのコンストラクタに object_pairs_hook 引数が追加されました。 PyYAML などの外部のライブラリでもサポートされています。

参考

PEP 372 - collections に順序付き辞書を追加

  PEP written by Armin Ronacher and Raymond Hettinger; implemented by Raymond Hettinger.

## PEP 378: 1000区切りのための書式指定子

大きい数値に区切り文字を追加して、18446744073709551616 の代わりに 18,446,744,073,709,551,616 と出力すると、プログラムの出力を読みやすくできます。

これを行う一般的な方法は `locale` モジュールを使うことで、複数の区切り文字 (北米では "," で、ヨーロッパでは ".") を使ったり、複数のグループの大きさを使うことができます。しかし、 `locale` の利用方法は複雑ですし、スレッドごとに異なるロケールの出力を行うプログラムでは利用することができません。

そのため、シンプルなカンマによるグループ化機構が `str.format()` メソッドのミニ言語に追加されました。浮動小数点数をフォーマットする場合、シンプルにカンマを幅と精度の間に置きます。

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

整数をフォーマットする場合は、幅の後にカンマを追加します。

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

この機構は全く柔軟性を持っていません。区切り文字は常にカンマですし、グループは常に数字3つになります。カンマ書式機構は `locale` ほど汎用ではありませんが、手軽に使うことができます。

参考

PEP 378 - 1000区切りのための書式指定子

  PEP written by Raymond Hettinger; implemented by Eric Smith.

## PEP 389: コマンドライン解析のための argparse モジュール

コマンドライン引数の解析のための `argparse` モジュールが、 `optparse` モジュールのより強力な代替として追加されました。

これにより、 Python はコマンドライン引数の解析のために3つの異なるモジュール、 `getopt`, `optparse`, `argparse` を持つことになります。 `getopt` モジュールは C言語用ライブラリの `getopt()` 関数に似せてあるので、あとで C 言語で書き直すかもしれないプログラムのプロトタイプを Python で書く場合に役に立ちます。 `optparse` は冗長になってしまいましたが、まだたくさんのスクリプトが利用していて、それらのスクリプトを自動的に更新する手段が無いので、削除される予定はありません。(`argparse` API を `optparse` のインタフェースに適合させる方法も検討されましたが、多くの複雑さと難点のために却下されました)

古いバージョンの Python との互換性を気にすること無く新しいスクリプトを書く時は、 `optparse` の代わりに `argparse` を使ってください。

以下はこの使用例です:

    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__

オーバーライドしない限り、 `-h` と `--help` スイッチが自動的に追加され、綺麗にフォーマットした出力を生成します。

    -> ./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

`optparse` と同じく、コマンドラインスイッチと引数は、 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` は `optparse` よりも多くの便利なバリデーションを持っています。引数の正確な数を整数で指定したり、 `'*'` で0以上の数を指定したり、 `'+'` で1以上の数を指定したり、 `'?'` でオプションにしたりできます。トップレベルのパーサーはサブパーサーを持つことができ、 `svn commit`, `svn checkout` のように異なるオプションを持ったサブコマンドを定義できます。引数のタイプに `FileType` を指定することで、自動でファイルを開き、 `'-'` が指定されたときに標準入出力だと判断することができます。

参考

`argparse` のドキュメント

  argparse モジュールのドキュメント

optparse からのアップグレード

  `optparse` を使うコードを変換する方法を説明した Python のドキュメントの一部

PEP 389 - argparse コマンドライン解析モジュール

  PEP written and implemented by Steven Bethard.

## PEP 391: logging の辞書ベースの設定

`logging` モジュールは非常に柔軟です。アプリケーションは logging のサブシステムのツリーを定義できます。このツリーの各ロガーはいくつかのメッセージをフィルターし、異なるフォーマットを行い、メッセージを沢山の種類のハンドラーに渡します。

この柔軟性は、多くの設定を必要とします。オブジェクトを生成してプロパティを設定する Python コードを書くこともできますが、複雑なセットアップをしようとすると退屈なコードを書かないといけなくなります。 `logging` は設定ファイルのパースを行う `fileConfig()` 関数を提供していますが、このファイルフォーマットはフィルターの設定をサポートしていませんし、プログラムで生成するのはさらに面倒になります。

Python 2.7 は logging の設定のために辞書を使う `dictConfig()` 関数を追加しました。いろいろな入力から辞書を作成する方法があります。コードで作ったり、 JSON ファイルをパースしたり、YAMLのパーサーをインストールしてあればそれを使うことができます。詳しい情報は 環境設定のための関数 を参照してください。

以下は、2つのロガー、 root logger と "network" という名前の logger を設定する例です。root logger に送られたメッセージは syslog プロトコルを利用してシステムログに送られ、 "network" logger に送られたメッセージは 1 MB ごとにローテートされる `network.log` ファイルに書きこまれます。

    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')

他にも、 `logging` モジュールには Vinary Sajip によって実装された 3 つの改良があります。

- `SysLogHandler` クラスは TCP 経由の syslog をサポートします。コンストラクタの socktype 引数は使用するソケットの種類として、 UDP を使う `socket.SOCK_DGRAM` と TCP を使う `socket.SOCK_STREAM` のどちらかを取ります。デフォルトはUDPのままです。

- `Logger` インスタンスに `getChild()` メソッドが追加されました。これは、相対パスで下位の logger を返します。 例えば、 `log = getLogger('app')` として logger を取得した後、 `log.getChild('network.listen')` は `getLogger('app.network.listen')` と同じになります。

- `LoggerAdapter` クラスに meth:~logging.LoggerAdapter.isEnabledFor メソッドが追加されました。 level を引数に取り、ベースの logger がその重要度レベルのメッセージを処理するかどうかを返します。

参考

PEP 391 - logging の辞書ベースの設定

  PEP written and implemented by Vinay Sajip.

## PEP 3106: 辞書 View

辞書の `keys()`, `values()`, `items()` メソッドは Python 3.x では動作が代わり、完全に実体化されたリストの代わりに、 view と呼ばれるオブジェクトを返すようになりました。

Python 2.7 では、 `keys()`, `values()`, `items()` の動作を変えてしまうと、既存の大量のコードが動かなくなってしまうので、Python 3.x と同じ動作に合わせることはできません。なので、 Python 3.x のメソッドと同じ動作をするメソッドを、別の `viewkeys()`, `viewvalues()`, `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])

View はイテレートするだけでなく、set と似た利用をすることもできます。`&` 演算子で共通部分集合を、`|` 演算子で話集合を取ることができます。

    >>> 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])

view は辞書とその辞書の変化に追随しています。:

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

ただし、view をイテレートしている間に key の追加や削除ができないことに気を付けてください。:

    >>> 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

Python 2.x で view メソッドを利用すると、 2to3 が自動的にそれを通常の `keys()`, `values()`, `items()` メソッドに書き換えてくれます。

参考

PEP 3106 - Revamping dict.keys(), .values() and .items()

  PEP written by Guido van Rossum. Backported to 2.7 by Alexandre Vassalotti; bpo-1967.

## PEP 3137: memoryview オブジェクト

`memoryview` オブジェクトは、他のオブジェクトのメモリの内容に対する `bytes` 型のインタフェースに合わせた view を提供します。

    >>> 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>

view の内容は bytes 型の文字列か整数のリストに変換することができます。

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

`memoryview` オブジェクトは、対象となる背後のオブジェクトが変更可能 (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')
    >>>

参考

PEP 3137 - Immutable Bytes and Mutable Buffer

  PEP written by Guido van Rossum. Implemented by Travis Oliphant, Antoine Pitrou and others. Backported to 2.7 by Antoine Pitrou; bpo-2396.

## その他の言語変更

Python 言語コアに小さな変更がいくつか行われました:

- set リテラルのためのシンタックスが Python 3.x からバックポートされました。内容を波括弧で囲うと mutable set になります。dict リテラルとの区別は、コロンと value が存在しないことで行われます。なので、`{}` は引き続き空の dict になります。空の set を作るときには `set()` を使ってください。

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

  Backported by Alexandre Vassalotti; bpo-2335.

- dict と set の内包表記も Python 3.x からバックポートされました。list と generator の内包表記を set と dict にも使えるように一般化させています。

      >>> {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'])

  Backported by Alexandre Vassalotti; bpo-2333.

- `with` 文が1つの文で複数のコンテキストマネージャーを使えるようになりました。コンテキストマネージャーは左から右へ処理され、それぞれが新しい `with` 文の開始となるように扱われます。つまり:

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

  は、以下と同じです

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

  `contextlib.nested()` 関数は非常に似た機能を提供していたので、もう必要なくなり廃止予定となりました。

  (Proposed in https://codereview.appspot.com/53094; implemented by Georg Brandl.)

- 浮動小数点数と文字列の間の変換がほとんどのプラットフォームで正しく丸められるようになりました。この変換はいろいろな場面で発生します: float 型や complex 型に対する `str()` 関数の適用、 `float` や `complex` コンストラクタ、数値フォーマット、 `marshal`, `pickle`, `json` モジュールを使ってのシリアライズとデシリアライズ、 Python コード中の float や imaginary リテラルの解析、 `Decimal` から float への変換などです。

  これに関連して、浮動小数点数 x の `repr()` は、 (round-half-to-even 丸めモードで)正しく丸め処理をした場合に元の x に戻せる最小の 10進文字列になりました。以前は x を17桁の10進文字列に丸めていました。

  丸めライブラリが、この改善が Windows や gcc, icc, suncc を使った Unix 環境で動かす役目をおっています。このライブラリの正確な動作が保証できない少しの環境があるので、そういったシステムではこのライブラリは利用されません。 `sys.float_repr_style` が `short` なら新しいコードが利用されていて、 `legacy` なら利用されていません。

  Implemented by Eric Smith and Mark Dickinson, using David Gay's `dtoa.c` library; bpo-7117.

- 多倍長整数や通常の整数から浮動小数点への変換でも丸め処理が変更され、元の数に一番近い浮動小数点値が返されるようになりました。これは浮動小数点へ完全に変換できる小さい整数では問題になりませんが、桁数に対して精度がどうしても足りない場合に関係します。Python 2.7 はより正確に近似するようになりました。例えば、Python 2.6 では次のように計算されていました:

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

  Python 2.7 の浮動小数点への変換結果は元の数値より大きくなりますが、元の値により近くなっています:

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

  (Implemented by Mark Dickinson; bpo-3166.)

  この丸めの動作により、整数同士の true division (`from __future__ import division`) の結果もより正確になりました。 (Also implemented by Mark Dickinson; bpo-1811.)

- 複素数に対する暗黙の型強制は削除されました。インタプリタは complex オブジェクトに対して `__coerce__()` メソッドを呼び出そうとしません。 (Removed by Meador Inge and Mark Dickinson; bpo-5211.)

- `str.format()` メソッドは置換フィールドに対する自動ナンバリングをサポートするようになりました。これにより `str.format()` をより `%s` と同じように使えるようになりました。

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

  自動ナンバリングは左のフィールドから右のフィールドへと行われるので、最初の `{...}` 指定は `str.format()` メソッドの最初の引数を利用し、次の指定は次の引数を利用します。自動ナンバリングと明示的なナンバリングを混ぜて使うことはできず、全ての置換指定に手動でナンバリングするか、全てを自動ナンバリングに任せなければなりません。ただし、上の例の2つめのように、自動ナンバリングと名前フィールドを混ぜて使うことは可能です。 (Contributed by Eric Smith; bpo-5237.)

  複素数が `format()` をサポートするようになりました。デフォルトでは右寄せになります。精度やカンマ区切りの指定は、実部と虚部のそれぞれに対して適用されます。アラインの指定は `1.5+3j` のような複素数全体に対して適用されます。 (Contributed by Eric Smith; bpo-1588 and bpo-7988.)

  'F' 書式符号は常に大文字を使って出力するようになり、 'INF' や 'NAN' が出力されるようになりました。 (Contributed by Eric Smith; bpo-3382.)

  低レベルな変更: `object.__format__()` メソッドは `PendingDeprecationWarning` を発生させるようになりました。 `object` に対する `__format__()` メソッドはオブジェクトを文字列表現に変換してそれをフォーマットするからです。以前は、このメソッドは書式文字列を受け取り文字列表現を返していましたが、この仕様は Python コードのミスを隠してしまう可能性がありました。アライメントや精度のようなフォーマット指定情報を渡した時、そのなにかそのオブジェクトに合ったフォーマットがあることを期待しているはずなのに、 `object.__format__()` メソッドはそれを無視します。 (Fixed by Eric Smith; bpo-7994.)

- `int()` と `long()` 型に `bit_length` メソッドが追加されました。このメソッドはその値を2進数で表現したときに何ビット必要になるかを返します:

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

  (Contributed by Fredrik Johansson and Victor Stinner; bpo-3439.)

- `import` 文が、絶対インポート (例: `from .os import sep`)が失敗したときに相対インポートを試さなくなりました。これはバグ修正ですが、いままでたまたま動いていただけの `import` 文を動かなくしてしまう可能性があります。(Fixed by Meador Inge; bpo-7902.)

- ビルトインの `unicode` 型のサブクラスが `__unicode__()` メソッドをオーバーライドできるようになりました。(Implemented by Victor Stinner; bpo-1583863.)

- `bytearray` 型の `translate()` メソッドが第一引数に `None` を受け入れるようになりました。 (Fixed by Georg Brandl; bpo-4759.)

- `@classmethod` や `@staticmethod` を使ってクラスメソッドやスタティックメソッドを作成した時、そのラッパーオブジェクトがラップ対象となる関数を `__func__` 属性で公開するようになりました。(Contributed by Amaury Forgeot d'Arc, after a suggestion by George Sakkis; bpo-5982.)

- `__slots__` を利用して属性を制限した場合に、設定されていない属性を del したときに `AttributeError` にならなかったのを修正しました。 (Fixed by Benjamin Peterson; bpo-7604.)

- 2つの新しいエンコーディングが追加されました: "cp720" は主にアラビア文字に使われます。 "cp858" は cp850 の一種ですが、ユーロ記号を追加しています。 (CP720 contributed by Alexander Belchenko and Amaury Forgeot d'Arc in bpo-1616979; CP858 contributed by Tim Hatch in bpo-8016.)

- `file` オブジェクトは、POSIX環境に置いてディレクトリを開こうとした時に発生する `IOError` 例外に `filename` 属性を設定するようになりました。 (noted by Jan Kaliszewski; bpo-4764) また、読み出し専用のファイルに対する書き込みを、Cライブラリ側のエラー検出・報告に頼るのではなく、明示的にチェックするようになりました。 (fixed by Stefan Krah; bpo-5677).

- Python の字句解析機は改行をそれ自身に変換するようになりました。それにより、組み込みの `compile()` 関数がどの改行コードを利用したコードでも受け付けるようになりました。また、コードの終端の改行も不要になりました。

- 関数宣言中の余分な丸括弧は Python 3.x では不正になりました。つまり、 `def f((x)): pass` はsyntax errorになります。 Python3 警告モードでは、 Python 2.7 はこの利用方法について警告を出すようになりました。 (Noted by James Lingard; bpo-7362.)

- 古いスタイルのクラスのオブジェクトに対して弱参照を作れるようになりました。新スタイルクラスには以前から弱参照を利用できます。(Fixed by Antoine Pitrou; bpo-8268.)

- モジュールオブジェクトがGCされたとき、モジュールの辞書は、他にその辞書への参照を持っているものがない場合にのみクリアされるようになりました。(bpo-7140).

### インタプリタの変更

新しい環境変数 `PYTHONWARNINGS` を使って警告を制御できるようになりました。この環境変数には、 `-W` スイッチに使われる警告の設定を、カンマ区切りの文字列として指定します。 (Contributed by Brian Curtin; bpo-7301.)

例えば、以下の設定は警告が発生するたびにそれを表示しますが、 `Cookie` モジュールからの警告はエラーにします。 (環境変数を設定するための文法はOSとシェルに依存します)

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

### 最適化

いくつかの場面でパフォーマンスが向上しています。

- `with` 文の初期セットアップを行うための新しいオペコードが追加されました。 `__enter__()` と `__exit__()` メソッドの検索を行います。 (Contributed by Benjamin Peterson.)

- たくさんのオブジェクトを開放せずに確保していくという、よくある使い方の 1つにおいて、GCのパフォーマンスが向上しました。以前はこの場合にGCにかかる時間はオブジェクトの数の2乗に比例していました。現在はフルGCの数は増えたヒープ上のオブジェクトの数に比例しています。新しい方式では、3世代中2世代目に対するGCが10回実行されたうえで、 2世代目から3世代目に移ったオブジェクトの数が3世代目のオブジェクトの数の 10%を超えたときにフルGCが発生します。(Suggested by Martin von Löwis and implemented by Antoine Pitrou; bpo-4074.)

- GCが循環参照になりえないシンプルなコンテナ型の追跡を避けるようになりました。 Python 2.7 では、アトミックな型(整数、文字列など)のみを含むタプルと辞書は追跡されません。推移的に、アトミックな型のみを含むタプルを含む辞書も、同じく追跡されません。これにより、GCによって巡回されチェックされるオブジェクトの数が減るので、 GCのコストを減らすことができます。 (Contributed by Antoine Pitrou; bpo-4688.)

- 多倍長整数の内部格納方式が、 2**15 ベースと 2**30 ベースのどちらかをビルド時に選択するようになりました。以前は常に 2**15 ベースで格納していました。 2**30 ベースにすると 64bit マシンに置いては確実にパフォーマンスが向上しますが、 32bit マシンではパフォーマンスが向上する場合も低下する場合もあります。なので、デフォルトでは 64bit マシンでは 2**30 ベースで、 32bit マシンでは 2**15 ベースになるようになります。 Unix では新しい configure オプションとして `--enable-big-digits` が追加され、このデフォルトの選択をオーバーライドできるようになっています。

  この変更はパフォーマンスの向上以外の形ではユーザーに見えないはずですが、 1つだけ例外があります。テストとデバッグを目的として、 `sys.long_info` というデータが追加され、内部フォーマットとして digit あたりのビット数と、それに使うCのデータ型のバイト数の情報を提供します:

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

  (Contributed by Mark Dickinson; bpo-4258.)

  その他の変更により、多倍長整数オブジェクトのサイズは数バイト小さくなりました。 32bit システムでは 2byte, 64bit システムでは 6byte 小さくなりました。 (Contributed by Mark Dickinson; bpo-5260.)

- 多倍長整数の除算アルゴリズムが、内部のループの軽量化や乗算からシフト演算への置き換え、不要なイテレーションの削除により高速化されました。いくつかのベンチマークによると、多倍長整数の剰余演算は 50% から 150% 高速化されています。 (Contributed by Mark Dickinson; bpo-5512.) ビット演算も高速化されています。(initial patch by Gregory Smith; bpo-1087418)

- `%` の実装が、左側のオペランドが文字列型かどうかをチェックしてその場合の処理を特殊化しました。これにより文字列に対して `%` を頻繁に使う、テンプレートライブラリなどのアプリケーションのパフォーマンスが1--3%向上します。 (Implemented by Collin Winter; bpo-5176.)

- `if` 条件付きのリスト内包表記がより高速なバイトコードにコンパイルされるようになりました。(Patch by Antoine Pitrou, back-ported to 2.7 by Jeffrey Yasskin; bpo-4715.)

- 整数や多倍長整数から10進文字列への変換を、任意の基数をサポートした汎用の変換関数を使う代わりに10進数に特殊化した処理を行うことで高速化しました。 (Patch by Gawain Bolton; bpo-6713.)

- 文字列等(str, unicode, `bytearray`) の `split()`, `replace()`, `rindex()`, `rpartition()`, `rsplit()` メソッドが、1文字ずつのスキャンの代わりに高速な逆方向スキャンアルゴリズムを使うようになりました。これにより、場合によっては10倍レベルの高速化になります。(Added by Florent Xicluna; bpo-7462 and bpo-7622.)

- `pickle` と `cPickle` モジュールが、属性名に使われている文字列を自動的にインターンするようになりました。これにより unpickle 後のオブジェクトのメモリ使用量が減ります。(Contributed by Jake McGuire; bpo-5084.)

- `cPickle` モジュールが辞書に対する特殊化を行い、 pickle にかかる時間をおよそ半分に減らしました。 (Contributed by Collin Winter; bpo-5670.)

## 新しいモジュールと改良されたモジュール

全てのリリースに置いて、 Python の標準ライブラリはたくさんの改良とバグ修正がされてきました。ここでは一部の注目に値する変更を、モジュール名で辞書順ソートしてリストアップしています。もっと完全な変更リストが見たければ、ソースツリー内の `Misc/NEWS` ファイルか、全ての完全な詳細が入っている Subversion のログを参照してください。

- `bdb` モジュールの基底デバッガクラス `Bdb` に、モジュールをスキップする機能が追加されました。コンストラクタは `django.*` のような glob スタイルのパターンをもった iterable を引数として受け取ります。デバッガはパターンのどれかにマッチするスタックフレームにステップインしません。 (Contributed by Maru Newby after a suggestion by Senthil Kumaran; bpo-5142.)

- `binascii` モジュールが buffer API をサポートするようになり、 `memoryview` インスタンスやその他のバッファオブジェクトともに利用できるようになりました。 (Backported from 3.x by Florent Xicluna; bpo-7703.)

- `bsddb` モジュールが pybsddb パッケージ の 4.7.2devel9 から 4.8.4 に更新されました。新しいバージョンはより Python 3.x との互換性がよくなり、いくつかのバグ修正と、いくつかの新しい BerkeleyDB のフラグとメソッドが追加されています。 (Updated by Jesús Cea Avión; bpo-8156. The pybsddb changelog can be read at http://hg.jcea.es/pybsddb/file/tip/ChangeLog.)

- `bz2` モジュールの `BZ2File` がコンテキストマネージャープロトコルをサポートするようになりました。これにより、 `with bz2.BZ2File(...) as f:` といった書き方ができます。 (Contributed by Hagen Fürstenau; bpo-3860.)

- `collections` モジュールの新しい `Counter` クラスは、データの数え上げをするときに便利です。 `Counter` インスタンスは辞書のように振る舞いますが、キーが存在しなかったときに `KeyError` 例外を発生させる代わりに 0 を返します。

      >>> 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

  `Counter` には追加の3つのメソッドがあります。 `most_common()` はカウントが最も多い N 要素とそのカウントを返します。 `elements()` はカウントしている要素を、そのカウント数だけ繰り返すイテレータを返します。 `subtract()` はイテレート可能型を受け取り、その各要素を足すのではなく引いて行きます。引数が辞書か他の `Counter` だった場合は、そのカウントが引かれます。

      >>> 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

  Contributed by Raymond Hettinger; bpo-1696199.

  新しいクラス `OrderedDict` はすでに PEP 372: collections に順序付き辞書を追加 で紹介しました。

  メソッドが追加されました。`deque` データ型の `count()` メソッドは、引数で指定された x と等しい要素が何個入っているかを返します。 `reverse()` メソッドは deque 内の要素をインプレースで逆順にします。 `deque` はまた、最大長を返す読み出し専用の属性 `maxlen` を持ちます。 (Both features added by Raymond Hettinger.)

  `namedtuple` クラスにオプションの rename 引数が追加されました。 rename が真のとき、複数回現れたり Python の識別子として許可されないために無効なフィールド名があったとき、フィールドのリスト内での場所に基づく有効なフィールド名に置き換えられます。

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

  (Added by Raymond Hettinger; bpo-1818.)

  `Mapping` 抽象基底クラスが、他の `Mapping` でない型と比較されたときに `NotImplemented` を返すようになりました。(Fixed by Daniel Stutzbach; bpo-8729.)

- `ConfigParser` モジュールのパーサークラスのコンストラクタが allow_no_value 引数を受け取るようになりました。これはデフォルトでは False です。真の場合、値のないオプションが利用できるようになります。例えば:

      >>> 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'

  (Contributed by Mats Kindahl; bpo-7005.)

- `contextlib.nested()` 関数が廃止予定になりました。これは1つの `with` 文で1つ以上のコンテキストマネージャーを扱うためのものでしたが、 `with` 文が複数のコンテキストマネージャーをサポートするようになりました。

- `cookielib` モジュールが不正な、値が整数値ではないバージョンフィールドを持つ cookie を無視するようになりました。(Fixed by John J. Lee; bpo-3924.)

- `copy` モジュールの `deepcopy()` 関数が、束縛ずみインスタンスメソッドを正しくコピーするようになりました。(Implemented by Robert Collins; bpo-1515.)

- `ctypes` モジュールが、ポインタとして宣言された引数に対して `None` が渡された場合常に C の NULL ポインタに変換するようになりました。(Changed by Thomas Heller; bpo-4606.) 基盤となっている libffi ライブラリ が 3.0.9 にアップデートされ、いくつかのプラットフォームにおけるいろいろな問題が修正されました。(Updated by Matthias Klose; bpo-8142.)

- 新しいメソッド: `datetime` モジュールの `timedelta` クラスに `total_seconds()` メソッドが追加されました。これはその期間の秒数を返します。(Contributed by Brian Quinlan; bpo-5788.)

- 新しいメソッド: `Decimal` クラスに、浮動小数点数から `Decimal` への正確な変換を行う `from_float()` クラスメソッドが追加されました。この正確な変換は、浮動小数点数が示す値に一番近い近似となる10進数を求めます。なので、このメソッドを使ったとしてもある程度の誤差は残ります。例えば、 `Decimal.from_float(0.1)` は `Decimal('0.1000000000000000055511151231257827021181583404541015625')` を返します。 (Implemented by Raymond Hettinger; bpo-4796.)

  `Decimal` のインスタンスと浮動小数点数の比較は、オペランドの値に応じた賢い結果を返すようになりました。以前はこの比較は Python のデフォルトのオブジェクト比較にフォールバックし、オペランドの型に応じて不定な結果が返されていました。ただし、 `Decimal` と浮動小数点数を加算などの他の演算で組み合わせることはいまでも許可されていません。浮動小数点数と `Decimal` の間の変換方法を明示的に指定するべきです。(Fixed by Mark Dickinson; bpo-2531.)

  `Decimal` のコンストラクタが浮動小数点数を受け入れるようになりました。 (added by Raymond Hettinger; bpo-8257) また、アラビア・インド数字などの、ヨーロッパ以外の Unicode 文字も受け入れるようになりました。 (contributed by Mark Dickinson; bpo-6595).

  `Context` クラスのほとんどのメソッドが `Decimal` インスタンスと同じく整数を受け入れるようになりました。例外は `canonical()` と `is_canonical()` メソッドだけです。 (Patch by Juan José Conti; bpo-7633.)

  `Decimal` インスタンスを文字列の `format()` メソッドで利用した場合、デフォルトのアライメントが左揃えから、数値型に適した右揃えに変更されました。 (Changed by Mark Dickinson; bpo-6857.)

  signaling NaN (あるいは `sNAN`) との比較は、暗黙に比較演算に応じて真偽値を返すのではなく、 `InvalidOperation` 例外を発生させるようになりました。 Quiet NaN (あるいは `NaN`) はハッシュ可能になりました。 (Fixed by Mark Dickinson; bpo-7279.)

- `difflib` モジュールの出力が、ファイル名を含むヘッダのセパレータにスペースではなくタブ文字を使うようになり、最近の diff/patch ツールとの互換性が高くなりました。(Fixed by Anatoly Techtonik; bpo-7585.)

- Distutils `sdist` コマンドが、 `MANIFEST.in` や `setup.py` ファイルが変更されていなくても、ユーザーが作成したかもしれない新しいファイルが含まれるようにするために、毎回 `MANIFEST` ファイルを再生成するようになりました。 (Fixed by Tarek Ziadé; bpo-8688.)

- `doctest` モジュールの `IGNORE_EXCEPTION_DETAIL` フラグが、テストされている例外を含むモジュールの名前を無視するようになりました。 (Patch by Lennart Regebro; bpo-7490.)

- `email` モジュールの `Message` クラスが Uniode値のペイロードを受け入れるようになり、自動的に `output_charset` で指定されたエンコーディングに変換するようになりました。 (Added by R. David Murray; bpo-1368247.)

- `Fraction` クラスが、コンストラクタの引数として、 1つの float 値、 `Decimal` インスタンス、 2つの有理数を受け入れるようになりました。(Implemented by Mark Dickinson; rationals added in bpo-5812, and float/decimal in bpo-8294.)

  fraction と complex 数の間の順序比較演算 (`<`, `<=`, `>`, `>=`)が `TypeError` 例外を発生させるようになりました。これは過失を修正し、 `Fraction` を他の数値型とマッチさせます。

- 新しいクラス: `FTP_TLS` が `ftplib` に追加されました。認証とその後の制御・データ転送をTLSカプセル化することでセキュアなFTP接続を提供します。 (Contributed by Giampaolo Rodola; bpo-2054.)

  バイナリデータのアップロードを行う `storbinary()` に rest 引数が追加され、アップロードのリスタートができるようになりました。 (patch by Pablo Mouzo; bpo-6845.)

- 新しいクラスデコレータ: `functools` モジュールに `total_ordering()` が追加されました。 `__eq__()` と、 `__lt__()`, `__le__()`, `__gt__()`, `__ge__()` のいづれか1つを定義したクラスを受け取り、残りの比較メソッドを生成します。 `__cmp__()` メソッドが Python 3.x では廃止されたので、順序のあるクラスを定義するのを簡単にするためにこのデコレータがあります。(Added by Raymond Hettinger; bpo-5479.)

  新しい関数: `cmp_to_key()` 関数は、古いスタイルの2引数を受け取る比較関数を受け取り、 `sorted()`, `min()`, `max()` などの key 引数に利用できる呼び出し可能オブジェクトを返します。この関数の主な目的は、古いコードを Python 3.x へ対応させるのを手助けすることです。(Added by Raymond Hettinger.)

- 新しい関数: `gc` モジュールに `is_tracked()` 関数が追加されました。渡されたオブジェクトがGCに追跡されている場合に True を、そうでない場合に False を返します。 (Contributed by Antoine Pitrou; bpo-4688.)

- `gzip` モジュールの `GzipFile` がコンテキストマネージャープロトコルをサポートしました。 `with gzip.GzipFile(...) as f:` と書くことができます。(contributed by Hagen Fürstenau; bpo-3860 また、 `io.BufferedIOBase` ABC を実装しています。なので、より高速な処理のために `io.BufferedReader` でラップすることができます。 (contributed by Nir Aides; bpo-7471). さらに、コンストラクタにオプションのタイムスタンプを指定することで、 gzip ファイル内の変更時間レコードをオーバーライドすることができるようになりました。 (Contributed by Jacques Frechet; bpo-4272.)

  gzip ファイルフォーマットのファイルは最後にゼロバイトによるパディングができるようになりました。 `gzip` モジュールは末尾のゼロバイトを消費します。(Fixed by Tadek Pietraszek and Brian Curtin; bpo-2846.)

- 新しい属性: `hashlib` モジュールに `algorithms` 属性が追加されました。これはサポートしているアルゴリズムを含むタプルです。 Python 2.7 では、 `hashlib.algorithms` は `('md5', 'sha1', 'sha224', 'sha256', 'sha384', 'sha512')` が含まれています。 (Contributed by Carl Chenet; bpo-7418.)

- `httplib` モジュールで使われているデフォルトの `HTTPResponse` クラスがバッファリングをサポートし、HTTPレスポンスをより高速に読み込めるようになりました。 (Contributed by Kristján Valur Jónsson; bpo-4879.)

  `HTTPConnection` と `HTTPSConnection` クラスが source_address 引数として `(host, port)` の2要素タプルを受け取るようになりました。これは接続のソースアドレスとして利用されます。 (Contributed by Eldon Ziegler; bpo-3972.)

- `ihooks` モジュールが相対 import をサポートしました。 `ihooks` import をカスタマイズするための古いモジュールで、 Python 2.0 で追加された `imputil` モジュールに取って変わられていることに注意してください。 (Relative import support added by Neil Schemenauer.)

- `imaplib` モジュールが IPv6 アドレスをサポートするようになりました。 (Contributed by Derek Morr; bpo-1655.)

- `inspect` モジュールに `getcallargs()` 関数が追加されました。 callable とその位置引数、キーワード引数を受け取り、 callable のどの仮引数がどの実引数を受け取るかを計算し、引数名から値へマップする辞書を返します。例えば:

      >>> 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)

  Contributed by George Sakkis; bpo-3135.

- 更新されたモジュール: `io` ライブラリが、Python 3.1 に同梱されるバージョンに更新されました。 3.1 では、I/O ライブラリは完全に C で書き直され、処理されるタスクに依って 2 から 20 倍速くなりました。元の Python バージョンは `_pyio` モジュールに改名されました。

  結果の軽微な変更: `io.TextIOBase` クラスは、エンコーディングやデコーディングのエラーに使われるエラー設定 (`'strict'`, `'replace'`, `'ignore'` のいずれか) を与える `errors` 属性を持つようになりました。

  `io.FileIO` クラスは、無効なファイルディスクリプタを渡されたときに `OSError` を送出するようになりました。(Implemented by Benjamin Peterson; bpo-4991.) `truncate()` メソッドは、ファイル位置を保存するようになりました。以前は、ファイル位置を新しいファイルの末尾に変更しました。(Fixed by Pascal Chambon; bpo-6939.)

- 新しい関数: `itertools.compress(data, selectors)` は、2 つのイテレータを取ります。data の要素は、selectors の対応する値が真であれば返されます:

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

  新しい関数: `itertools.combinations_with_replacement(iter, r)` は、 iter から、すべての可能な長さ r の要素の組合せを返します。 `combinations()` とは異なり、生成された組合せに個別の要素が繰り返し出現できます:

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

  なお要素は、実際の値ではなく、その入力内での位置に依って一意であるとみなされます。

  `itertools.count()` 関数は、1 以外の値を増分できるように、 step 引数を追加しました。 `count()` はまた、キーワード引数に対応し、さらに浮動小数点数や `Decimal` インスタンスのような、非整数の値を使えるようになりました。(Implemented by Raymond Hettinger; bpo-5032.)

  `itertools.combinations()` および `itertools.product()` は、以前は入力のイテレート可能オブジェクトより大きい r に `ValueError` を返していました。これは仕様エラーと認められ、空のイテレータを返すようになりました。(Fixed by Raymond Hettinger; bpo-4816.)

- 更新されたモジュール: `json` モジュールが、エンコーディングやデコーディングを高速化する C 拡張を含んだ、 simplejson パッケージのバージョン 2.0.9 にアップグレードされました。 (Contributed by Bob Ippolito; bpo-4136.)

  新しい `collections.OrderedDict` 型をサポートするために、 `json.load()` はオプションとして、任意のオブジェクトリテラルに対して呼び出され、ペアのリストにデコードする object_pairs_hook パラメタを追加しました。(Contributed by Raymond Hettinger; bpo-5381.)

- `mailbox` モジュールの `Maildir` クラスは、読み込むディレクトリのタイムスタンプを記録し、その後に更新時刻が変わった場合にのみ再読み込みするようになりました。これは不必要なディレクトリ走査を避けることでパフォーマンスを向上させます。(Fixed by A.M. Kuchling and Antoine Pitrou; bpo-1607951, bpo-6896.)

- 新しい関数: `math` モジュールは、誤差関数と相補誤差関数 `erf()` および `erfc()` 、 `e**x - 1` を `exp()` から 1 を引くのよりも高い精度で計算する `expm1()` 、ガンマ関数 `gamma()` 、そしてガンマ関数の自然対数 `lgamma()` を追加しました。 (Contributed by Mark Dickinson and nirinA raseliarison; bpo-3366.)

- `multiprocessing` モジュールの `Manager*` クラスに、サブプロセスの開始時に呼び出される呼び出し可能オブジェクトと、それに渡される引数群を渡すことができるようになりました。 (Contributed by lekma; bpo-5585.)

  ワーカプロセスのプールを制御する `Pool` クラスに、オプションの maxtasksperchild パラメタが追加されました。ワーカプロセスはこれで指定された数のタスクを処理したら、退出して `Pool` に新しいワーカーを開始させます。これは、タスクがメモリその他のリソースをリークし得るときや、ワーカをとても大きくしてしまうようなタスクがあるときに便利です。 (Contributed by Charles Cazabon; bpo-6963.)

- `nntplib` モジュールは、IPv6 アドレスをサポートするようになりました。 (Contributed by Derek Morr; bpo-1664.)

- 新しい関数: `os` モジュールは、以下の POSIX システムコールをラップします: real, effective, および saved GID と UID を返す、 `getresgid()` と `getresuid()` 、 real, effective, および saved GID と UID を新しく設定する、 `setresgid()` と `setresuid()` 、現在のプロセスにグループアクセスリストを初期化する `initgroups()` 。 (GID/UID functions contributed by Travis H.; bpo-6508. Support for initgroups added by Jean-Paul Calderone; bpo-7333.)

  `os.fork()` 関数は、子プロセス中で import ロックを再初期化するようになりました。これは、Solaris における `fork()` がスレッドから呼び出された時の問題を修正します。(Fixed by Zsolt Cserna; bpo-7242.)

- `os.path` モジュールの、 `normpath()` および `abspath()` 関数は、Unicode を保存するようになりました。入力パスが Unicode なら、戻り値も Unicode 文字列になります。 (`normpath()` fixed by Matt Giuca in bpo-5827; `abspath()` fixed by Ezio Melotti in bpo-3426.)

- `pydoc` モジュールは、Python が使う様々なシンボルのヘルプを追加しました。例えば、 `help('<<')` や `help('@')` とできるようになりました。(Contributed by David Laban; bpo-4739.)

- `re` モジュールの `split()`, `sub()`, および `subn()` は、モジュールの他の関数との一貫性のため、オプションの flags 引数を受け付けるようになりました。 (Added by Gregory P. Smith.)

- 新しい関数: `runpy` モジュールの `run_path()` は、与えられた path 引数のコードを実行します。 path は Python ソースファイルのパス (`example.py`)、コンパイル済みバイトコードファイル (`example.pyc`)、ディレクトリ (`./package/`)、または zip アーカイブ (`example.zip`) にできます。ディレクトリか zip パスが与えられると、それが `sys.path` の最初に加えられ、モジュール `__main__` が import されます。これは、ディレクトリや zip が `__main__.py` を含むことを期待します。なければ、他の `__main__.py` が `sys.path` の後の部分から import されることがあります。これにより、Python のコマンドラインが明示的なパス名を処理する方法を真似たいようなスクリプトに、 `runpy` のより多くの機構が利用できるようになります。 (Added by Nick Coghlan; bpo-6816.)

- 新しい関数: `shutil` モジュールの `make_archive()` は、ファイル名、アーカイブ型 (zip または tar-format)、およびディレクトリパスを取って、そのディレクトリの内容を含むアーカイブを生成します。(Added by Tarek Ziadé.)

  `shutil` の `copyfile()` および `copytree()` 関数は、名前付きパイプのコピーを求められたときに `SpecialFileError` 例外を送出する様になりました。以前は、コードは、名前付きパイプを、通常のファイルのように読み込み用に開いて扱い、いつまでもブロックしていました。 (Fixed by Antoine Pitrou; bpo-3002.)

- `signal` モジュールは、シグナルハンドラを本当に必要でない限り再インストールしなくなりました。これで、EINTR シグナルを確実に捕えられないバグが修正されました。(Fixed by Charles-Francois Natali; bpo-8354.)

- 新しい関数: `site` モジュールの、新しい関数群は様々なサイトおよびユーザに特有のパスを返します。 `getsitepackages()` は、全てのグローバル site-packages ディレクトリを含むリストを返します。 `getusersitepackages()` は、ユーザの site-packages ディレクトリのパスを返します。そして、 `getuserbase()` は、データの保存に使えるディレクトリへのパスを与える、 `USER_BASE` 環境変数の値を返します。 (Contributed by Tarek Ziadé; bpo-6693.)

  `site` モジュールは `sitecustomize` モジュールが import されたときに例外を報告するようになり、 `KeyboardInterrupt` 例外が捕捉されて飲み込まれることはなくなりました。 (Fixed by Victor Stinner; bpo-3137.)

- `create_connection()` 関数は、接続に使われるソースアドレスを与える `(host, port)` の 2-タプル、 source_address パラメタを追加しました。 (Contributed by Eldon Ziegler; bpo-3972.)

  `recv_into()` および `recvfrom_into()` メソッドは、バッファ API をサポートするオブジェクト、最も便利なのは `bytearray` や `memoryview` 、に書きこむようになりました。 (Implemented by Antoine Pitrou; bpo-8104.)

- `SocketServer` モジュールの `TCPServer` クラスは、ソケットタイムアウトと Nagle アルゴリズムの無効化をサポートするようになりました。 `disable_nagle_algorithm` クラス属性は、デフォルトで `False` です。上書きされて真になると、新しいリクエスト接続は、TCP_NODELAY オプションを設定され、一つの TCP パケットにたくさんの小さな送信がバッファリングされることを防ぎます。 `timeout` クラス属性は、リクエストソケットに適用されるタイムアウトを秒で保持できます。その時間内にリクエストが受け付けられなければ、 `handle_timeout()` が呼び出され、 `handle_request()` が返されます。(Contributed by Kristján Valur Jónsson; bpo-6192 and bpo-6267.)

- 更新されたモジュール: `sqlite3` モジュールが pysqlite パッケージ のバージョン 2.6.0 にアップデートされました。バージョン 2.6.0 はいくつかのバグ修正を含み、共有ライブラリから SQLite 拡張をロードできるようになりました。拡張を有効にするには `enable_load_extension(True)` メソッドを呼び出し、そして特定の共有ライブラリをロードするには `load_extension()` を呼び出してください。 (Updated by Gerhard Häring.)

- `ssl` モジュールの `SSLSocket` オブジェクトは、バッファ API をサポートするようになりました。これは、テストスイートの障害を修正します (fix by Antoine Pitrou; bpo-7133)。また、OpenSSL の `SSL_MODE_AUTO_RETRY` を自動的に設定することで、 `recv()` 演算によって SSL 再ネゴシエーションを引き起こすエラーコードが返されるのを防ぎます (fix by Antoine Pitrou; bpo-8222)。

  `ssl.wrap_socket()` コンストラクタ関数は、許可される暗号化アルゴリズムを列挙する文字列である ciphers 引数を取るようになりました。この文字列の書式は、 OpenSSL ドキュメント で解説されています。 (Added by Antoine Pitrou; bpo-8322.)

  その他の変更により、拡張はOpenSSL の全ての暗号とメッセージダイジェストアルゴリズムをロードし、それらすべてが利用できるようにします。SSL 証明書の中には検証できないものもあり、"unknown algorithm" エラーを報告します。 (Reported by Beda Kosata, and fixed by Antoine Pitrou; bpo-8484.)

  OpenSSL の、使われるバージョンは、モジュール属性 `ssl.OPENSSL_VERSION` (文字列)、 `ssl.OPENSSL_VERSION_INFO` (5-タプル)、および `ssl.OPENSSL_VERSION_NUMBER` (整数) として利用できるようになりました。 (Added by Antoin Pitrou; bpo-8321.)

- `struct` モジュールは、値が特定の整数フォーマットコード (`bBhHiIlLqQ` のいずれか) に対して大きすぎるときに、オーバーフローエラーを静かに無視しなくなりました。これは必ず `struct.error` 例外を送出するようになりました。 (Changed by Mark Dickinson; bpo-1523.) `pack()` 関数は、非整数を変換してパックするのに、 `__int__()` メソッドを試したりエラーを報告したりする前に、 `__index__()` の使用も試すようになりました。 (Changed by Mark Dickinson; bpo-8300.)

- 新しい関数: `subprocess` モジュールの `check_output()` は、指定された引数群でコマンドを実行し、コマンドがエラーを起こさずに実行したらコマンドの出力を文字列として返し、そうでなければ `CalledProcessError` 例外を送出します。

      >>> 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

  (Contributed by Gregory P. Smith.)

  `subprocess` モジュールは、 `EINTR` シグナルを受け取り次第内部システムコールを最施行するようになりました。(Reported by several people; final patch by Gregory P. Smith in bpo-1068268.)

- 新しい関数: `symtable` モジュールの `is_declared_global()` は、明示的に global と宣言された引数には真、暗示的に global である引数には偽を返します。(Contributed by Jeremy Hylton.)

- `syslog` モジュールは、識別子として、以前デフォルトであった `'python'` の値ではなく、 `sys.argv[0]` の値を使うようになりました。 (Changed by Sean Reifschneider; bpo-8451.)

- `sys.version_info` の値は、属性名 `major`, `minor`, `micro`, `releaselevel`, および `serial` を持つ名前付きタプルになりました。 (Contributed by Ross Light; bpo-4285.)

  `sys.getwindowsversion()` もまた、属性名 `major`, `minor`, `build`, `platform`, `service_pack`, `service_pack_major`, `service_pack_minor`, `suite_mask`, および `product_type` を持つ名前付きタプルを返します。(Contributed by Brian Curtin; bpo-7766.)

- `tarfile` モジュールのデフォルトエラー処理が変更され、致命的なエラーを抑制しないようになりました。デフォルトのエラーレベルは以前は 0 で、エラーはメッセージとしてデバッグログに書き込まれるだけでしたが、デバッグログはデフォルトでは活性化されていないため、エラーは顧みられませんでした。デフォルトのエラーレベルは 1 になり、エラーがあれば例外が送出されます。 (Changed by Lars Gustäbel; bpo-7357.)

  `tarfile` は、tar ファイルに追加される `TarInfo` オブジェクトのフィルタリングをサポートするようになりました。 `add()` を呼び出したとき、オプションの呼び出し可能オブジェクトである filter 引数を与えることができます。 filter オブジェクトには、ファイルが追加される度に `TarInfo` を渡され、これを変形して返せます。このオブジェクトが `None` を返したら、そのファイルは結果のアーカイブから除かれます。これは既存の exclude 引数より強力で、それゆえこれは非推奨となります。(Added by Lars Gustäbel; bpo-6856.) `TarFile` クラスはまた、コンテキストマネージャプロトコルもサポートするようになりました。(Added by Lars Gustäbel; bpo-7232.)

- `threading.Event` クラスの `wait()` メソッドは、終了時に内部フラグを返すようになりました。 `wait()` は内部フラグが真になるまでブロックすることを想定されているため、この関数は通常真を返すことになります。この戻り値は、タイムアウトが与えられ、オペレーションがタイムアウトした時のみ偽になります。 (Contributed by Tim Lesher; bpo-1674032.)

- `unicodedata` モジュールに提供される Unicode データベースは、どの文字が数字や空白文字か、または改行を表すかを決定するために、内部で使われるようになりました。このデータベースはまた、 `Unihan.txt` データファイルからの情報も含みます (patch by Anders Chrigström and Amaury Forgeot d'Arc; bpo-1571184)。また、バージョン 5.2.0 にアップデートされました (updated by Florent Xicluna; bpo-8024)。

- `urlparse` モジュールの `urlsplit()` は、未知の URL スキームを RFC 3986 に応じた方法で処理します。 URL が `"<something>://..."` の形式なら、 `://` の前のテキストを、それがモジュールの知らない作り物のスキームであってさえ、スキームとして扱います。この変更は、古い働きを使って動作していたコードを破壊することがあります。例えば、Python 2.6.4 や 2.5 は以下を返します:

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

  Python 2.7 (や Python 2.6.5) は以下を返します:

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

  (Python 2.7 では、これは普通のタプルではなく名前付きタプルを返すので、実際は微妙に異なる出力をします。)

  `urlparse` モジュールは、 RFC 2732 で定義された IPv6 リテラルアドレスもサポートします (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='')

- 新しいクラス: `weakref` モジュールの `WeakSet` クラスは、その要素の弱参照だけを保持する集合です。要素は、それを指す参照がなくなり次第除去されます。 (Originally implemented in Python 3.x by Raymond Hettinger, and backported to 2.7 by Michael Foord.)

- エレメントツリーライブラリ、 `xml.etree` は、 (`<?xml-stylesheet href="#style1"?>` のような) 命令や (`<!-- comment -->` のような) コメントを処理する XML を出力するとき、アンパサンドや山括弧をエスケープしなくなりました。 (Patch by Neil Muller; bpo-2746.)

- `xmlrpclib` と `SimpleXMLRPCServer` によって提供される XML-RPC クライアントおよびサーバは、HTTP/1.1 keep-alive をサポートし、場合によっては gzip エンコーディングを使って XML の送受を圧縮することで、パフォーマンスが向上しました。gzip 圧縮は `SimpleXMLRPCRequestHandler` の `encode_threshold` 属性によって制御されます。これはバイト数で、これより大きな応答は圧縮されます。 (Contributed by Kristján Valur Jónsson; bpo-6267.)

- `zipfile` モジュールの `ZipFile` は、コンテキストマネジメントプロトコルをサポートし、 `with zipfile.ZipFile(...) as f:` と書けるようになりました。 (Contributed by Brian Curtin; bpo-5511.)

  `zipfile` は、空のディレクトリのアーカイブ化をサポートするようになり、これを正しく解凍します。(Fixed by Kuba Wieczorek; bpo-4710.) アーカイブ内のファイルの読み込みが速くなり、 `read()` および `readline()` の割り込みが正しく働くようになりました。(Contributed by Nir Aides; bpo-7610.)

  `is_zipfile()` 関数は、以前受け付けられていたパス名に加え、ファイルオブジェクトも受け付けるようになりました。 (Contributed by Gabriel Genellina; bpo-4756.)

  `writestr()` メソッドは、 `ZipFile` コンストラクタで指定されたデフォルトの圧縮メソッドをオーバライドする、オプションの compress_type パラメタを追加しました。 (Contributed by Ronald Oussoren; bpo-6003.)

### 新しいモジュール: importlib

Python 3.1 は、根底の Python の `import` 文のロジックの最実装である `importlib` パッケージを含みます。 `importlib` は、Python インタプリタの実装者や、import プロセスに関与する新しいインポータを書きたいと願うユーザにとって便利です。 Python 2.7 は `importlib` パッケージを完全には含みませんが、代わりに 1 つの関数 `import_module()` を含む小さなサブセットがあります。

`import_module(name, package=None)` はモジュールを import します。 name はモジュールまたはパッケージの名前を含む文字列です。 `..utils.errors` のように `.` 文字で始まる文字列を与えることで、相対 import も可能です。相対 import では、 package 引数は必ず与えられなければならず、相対 import のアンカーとして使われるパッケージの名前でなければなりません。 `import_module()` は、 import されたモジュールを `sys.modules` に挿入し、モジュールオブジェクトを返すこともします。

ここに例があります:

    >>> 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` は、Brett Cannon によって実装され、 Python 3.1 に導入されました。

### 新しいモジュール: sysconfig

`sysconfig` モジュールが Distutils パッケージから引き抜かれ、新しいトップレベルモジュールになりました。 `sysconfig` は、Python のビルドプロセスについての以下の情報を得るための関数群を提供しています。コンパイラスイッチ、インストレーションパス、プラットフォーム名、そして Python がソースディレクトリから実行されているかどうかです。

モジュールの関数のいくつかを紹介すると:

- `get_config_var()` は、Python の Makefile と `pyconfig.h` ファイルから変数を返します。

- `get_config_vars()` は、すべての環境設定変数を含む辞書を返します。

- `get_path()` は、特定のタイプのモジュール、つまり標準ライブラリ、サイト特有のモジュール、プラットフォーム特有のライブフラリなど、への設定されたパスを返します。

- `is_python_build()` は、Python ソースツリーからバイナリを起動していれば真を、そうでなければ偽を返します。

詳細と関数の完全な一覧は `sysconfig` ドキュメントを参照してください。

Distutils パッケージと `sysconfig` は Tarek Ziadé によってメンテナンスされていて、彼は Distutils の新世代版を開発するために Distutils2 パッケージ (source repository at https://hg.python.org/distutils2/) も開始しました。

### ttk: Tk のテーマ付きウィジェット

Tcl/Tk 8.5 は、基本的な Tk ウィジェットを最実装しながらより自由な外観のカスタマイズが広がり、よりネイティブなプラットフォームのウィジェットに似たテーマ付きウィジェット群を含みます。このウィジェット群は、元は Tile と呼ばれていましたが、Tcl/Tck リリース 8.5 への追加の際に ("themed Tk" を略して) Ttk に改名されました。

詳しく知るには、 `ttk` モジュールのドキュメントをお読みください。 https://www.tcl.tk/man/tcl8.5/TkCmd/ttk_intro.htm にある、Ttk テーマエンジンを解説した Tcl/Tk マニュアルページを読むのもいいでしょう。 Python/Ttk コードを動かしているスクリーンショットは https://code.google.com/archive/p/python-ttk/wikis/Screenshots.wiki にあります。

`ttk` モジュールは Guilherme Polo によって書かれ、 bpo-2983 に追加されました。 `Tile.py` と呼ばれる別バージョン `Tile.py` は、 Martin Franklin によって書かれ、Kevin Walzer によってメンテナンスされているもので、組み込みが bpo-2618 で提案されましたが、著者は Guilherme Polo の作品のほうがより包括的であると主張しました。

### 更新されたモジュール: unittest

`unittest` モジュールが大幅に改善されました。多くの新機能が追加されました。それらの機能のほとんどは、特に注釈のない限り、 Michael Foord によって実装されました。このモジュールの改善された版は、 Python バージョン 2.4 から 2.6 で使うために、 https://pypi.org/project/unittest2 から `unittest2` パッケージとして別にダウンロードできます。

コマンドラインから使われるとき、このモジュールはテストを自動的に発見します。これは py.test や nose ほど派手ではありませんが、テストをパッケージディレクトリに保持されたテストを簡潔に実行する方法を提供します。例えば、以下のコマンドは `test/` サブディレクトリから `test*.py` という名前の import できるテストファイル検索します:

    python -m unittest discover -s test

詳細は、 `unittest` モジュールのドキュメントを参照してください。 (Developed in bpo-6001.)

`main()` 関数は、その他幾つかの新しいオプションを提供します:

- `-b` や `--buffer` は、標準出力や標準エラーストリームをそれぞれのテストの間バッファに入れます。テストが通れば、結果の出力は全て捨てられます。失敗したら、バッファに入れられた出力が表示されます。

- `-c` や `--catch` は、control-C による中断をより上品にします。テストプロセスを即座に中断するのではなく、現在実行中のテストは完了させ、中断までの部分的な結果は報告されます。待ちきれなければ、control-C をもう一度押せば、即座に中断されます。

  この control-C ハンドラは、コードがテストされているときや、実行されているテストが独自のシグナルハンドラを定義したとき、シグナルハンドラがすでに設定されていてそして呼び出されたということを知らせることで、問題を起こさないようにします。これがまずいなら、 `removeHandler()` デコレータを使って、テストが control-C ハンドリングを無効にするべきであると示せます。

- `-f` や `--failfast` は、テストが失敗したとき、他のテストを続けるのではなく、テストの実行を即座に停止します。 (Suggested by Cliff Dyer and implemented by Michael Foord; bpo-8074.)

進捗メッセージは、verbose モードで実行したとき、期待された失敗に 'x' を、期待されない成功に 'u' を表示するようになりました。(Contributed by Benjamin Peterson.)

テストケースは、テストをスキップするために `SkipTest` 例外を送出します。(bpo-1034053).

`assertEqual()`, `assertTrue()`, および `assertFalse()` 失敗のメッセージは、提供する情報量が増えました。 `TestCase` クラスの `longMessage` 属性を真に設定すると、失敗時に、標準のエラーメッセージと追加して提供したメッセージの両方が表示されます。(Added by Michael Foord; bpo-5663.)

`assertRaises()` メソッドは、実行する呼び出し可能オブジェクトを与えずに呼び出されたとき、コンテキストハンドラを返すようになりました。例えば、こう書くことができます:

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

(Implemented by Antoine Pitrou; bpo-4444.)

モジュールレベルおよびクラスレベルの設定と、ティアダウンフィクスチャがサポートされました。モジュールは、 `setUpModule()` および `tearDownModule()` 関数を含むことができます。クラスは `setUpClass()` および `tearDownClass()` メソッドを含むことができ、これらは (`@classmethod` や透過なものを使って) クラスメソッドとして定義しなければなりません。これらの関数とメソッドは、テストランナーが別のモジュールやクラスのテストケースに切り替えるときに呼び出されます。

メソッド `addCleanup()` および `doCleanups()` が追加されました。 `addCleanup()` で、無条件に呼び出されるクリーンアップ関数を (`setUp()` が失敗したら `setUp()` の後に、そうでなければ `tearDown()` の後に) 追加できるようにします。これにより、テスト中のリソースの配置と解放が簡潔になります。(bpo-5679).

より特化したテストを提供するメソッドがいくつか追加されました。これらのメソッドの多くは、Google のエンジニアたちによってそのテストスイートのために書かれました。Gregory P. Smith, Michael Foord, and GvR が、これを `unittest` の Python 版にマージしました。

- `assertIsNone()` および `assertIsNotNone()` はひとつの式を取り、その結果が `None` であるか、またはないかを確かめます。

- `assertIs()` および `assertIsNot()` は、2 つの値を取り、その評価が同一のオブジェクトであるか、またはないかを確かめます。 (Added by Michael Foord; bpo-2578.)

- `assertIsInstance()` および `assertNotIsInstance()` は、結果のオブジェクトが特定のクラス、またはタプルにあるクラスのいずれかのインスタンスであるかを調べます。(Added by Georg Brandl; bpo-7031.)

- `assertGreater()`, `assertGreaterEqual()`, `assertLess()`, および `assertLessEqual()` は、二つの量を比較します。

- `assertMultiLineEqual()` は 2 つの文字列を比較し、等しくなければ、2 文字列の差分をハイライトする有益な比較を表示します。この比較は、Unicode 文字列が `assertEqual()` で比較されるときのデフォルトに使われるようになりました。

- `assertRegexpMatches()` および `assertNotRegexpMatches()` は、第一引数が第二引数として与えられた正規表現にマッチする、またはしない文字列であるかどうかを調べます。 (bpo-8038)

- `assertRaisesRegexp()` は、特定の式が送出されるかを調べ、そしてまたその式の文字列表現が与えられた正規表現にマッチするかを調べます。

- `assertIn()` および `assertNotIn()` は、 first が second に属するか、または属さないかを調べます。

- `assertItemsEqual()` は、2 つの与えられたシーケンスが同じ要素を含むかを調べます。

- `assertSetEqual()` は、2 つの集合が等しいか比較し、エラーの場合のみ、集合間の差分を報告します。

- 同様に、 `assertListEqual()` および `assertTupleEqual()` は、指定された型を比較し、差分を説明しますが、完全な値を表示するとはかぎりません。これらのメソッドは、リストやタプルを `assertEqual()` で比較するときにデフォルトで使われるようになりました。より一般的には、 `assertSequenceEqual()` は 2 つのシーケンスを比較し、必要なら両方のシーケンスが特定の型であるかを調べます。

- `assertDictEqual()` は、二つの辞書を比較し、差分を報告します。これは、辞書を `assertEqual()` で比較するときにデフォルトで使われるようになりました。 `assertDictContainsSubset()` は、 first に属するキー/値の対の全てが second に現れるかを調べます。

- `assertAlmostEqual()` および `assertNotAlmostEqual()` は、 first と second がほぼ等しいかを判定します。このメソッドは、オプションで指定された places (デフォルトは 7) の数に差を丸めてそれをゼロと比べるか、差が与えられた delta の値より小さいことを要求します。

- `loadTestsFromName()` は、 `TestLoader` の `suiteClass` 属性を適切に受け入れます。(Fixed by Mark Roddy; bpo-6866.)

- 新しいフックにより、 `assertEqual()` メソッドを拡張して新しいデータ型を扱わせられます。 `addTypeEqualityFunc()` メソッドは型オブジェクトと関数を取ります。この関数は、比較される両方のオブジェクトが特定の型であるときに使われます。この関数は、2 つのオブジェクトを比較し、マッチしなければ例外を送出するべきです。この関数が、新しいシーケンス比較メソッドがするように、2 つのオブジェクトがなぜマッチしないのかについて追加の情報を提供するのがいいアイデアです。

`unittest.main()` はオプションの `exit` 引数を取るようになりました。偽の場合、 `main()` は `sys.exit()` を呼び出さず、これにより対話型インタプリタから `main()` が使えるようになります。(Contributed by J. Pablo Fernández; bpo-3379.)

`TestResult` に、テストランの直前と直後に呼び出される `startTestRun()` および `stopTestRun()` が追加されました。 (Contributed by Robert Collins; bpo-5728.)

これら一連の変更により、 `unittest.py` は無様に大きくなったので、モジュールはパッケージとなり、コードは複数のファイルに分割されました (by Benjamin Peterson)。これは、モジュールをインポートして使う方法には影響しません。

参考

http://www.voidspace.org.uk/python/articles/unittest2.shtml

  Describes the new features, how to use them, and the rationale for various design decisions. (By Michael Foord.)

### 更新されたモジュール: ElementTree 1.3

Python に同梱される ElementTree ライブラリのバージョンが、バージョン 1.3 にアップデートされました。新機能の一部は:

- 様々な解析関数が、使われる `XMLParser` インスタンスを与える parser キーワード引数を取るようになりました。これにより、ファイルの内部エンコーディングをオーバーライドできるようになりました:

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

  XML を解析するときのエラーは、 `ParseError` 例外を送出するようになりました。この例外のインスタンスは、問題の位置を与える (line, column) タプルを含む `position` 属性を持ちます。

- ツリーを文字列に変換する ElementTree のコードが大幅に改善され、多くの場合でおおよそ 2 倍速くなりました。 `ElementTree.write()` および `Element.write()` メソッドは、 method パラメタを追加し、これは "xml" (デフォルト), "html", または "text" にできます。HTML モードは、空の要素を `<empty/>` ではなく `<empty></empty>` として出力し、text モードは要素を無視し、テキストのチャンクのみ出力します。要素の `tag` 属性を `None` に設定してその子はそのままにすると、ツリーが書き出されるとき、その要素は省かれるので、それ以上再編成することなく要素を一つ取り除けます。

  名前空間の操作も改善されました。すべての `xmlns:<whatever>` 宣言は、結果の XML に散らばるのではなく、ルート要素に出力されます。 `default_namespace` 属性を設定することでデフォルトの名前空間を設定でき、 `register_namespace()` で新しい接頭辞を登録できます。XML モードでは、XML 宣言を抑制するために真/偽の xml_declaration パラメタを使えます。

- 新しい `Element` メソッド: `extend()` はシーケンスから項目の子に要素を追加します。要素それ自体はシーケンスのように振る舞うので、子をある要素から別の要素に移すのが簡単です:

      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)

- 新しい `Element` メソッド: `iter()` は、要素の子をジェネレータとして与えます。また、 `for child in elem:` と書いて要素の子に渡ってループできます。既存のメソッド `getiterator()` と、子のリストを構成して返す `getchildren()` は、非推奨になりました。

- 新しい `Element` メソッド: `itertext()` は、その要素の子孫であるテキストのチャンクを全て与えます。例えば:

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

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

- 非推奨: 要素をブール値として使う (すなわち、 `if elem:`) と、要素が子を持てば真を、子を持たなければ偽を返します。この振る舞いは紛らわしいです -- `None` は偽、では子を持たない要素は? -- ですから、 `FutureWarning` を引き起こすようになりました。コードでは、明示するべきです。子の数に興味があるなら `len(elem) != 0` と、または `elem is not None` と書いてください。

Fredrik Lundh は ElementTree を開発し、1.3 バージョンを作成しました。 1.3 を解説した彼の記事を http://effbot.org/zone/elementtree-13-intro.htm で読めます。 Florent Xicluna は、python-dev および bpo-6472 での議論の後、 Python に含まれるバージョンをアップデートしました。

## ビルドならびに C API の変更

Python のビルド過程と C API の変更は以下の通りです:

- GNU デバッガ、GDB 7、の最新のリリースは Python を使って書けます 実行可能なプログラム P のデバッグを始めるとき、GDB は `P-gdb.py` という名前のファイルをロックし、それを自動的に読み込みます。Dave Malcolm は Python 自体をデバッグするときに便利ないくつかのコマンドを加える `python-gdb.py` に貢献しました。例えば、 `py-up` および `py-down` は、通常いくつかの C スタックフレームに対応する、 Python のスタックフレームを上がったり下がったりします。 `py-print` は、Python 変数の値を表示し、 `py-bt` は、 Python スタックトレースを表示します。(Added as a result of bpo-8032.)

- Python に備え付けの `.gdbinit` ファイルを使うと、デバッグされているスレッドが GIL をほじしていないとき、2.7 バージョンの "pyo" マクロが正常に動くようになりました。このマクロは、表示の前にこれを取得するようになりました。 (Contributed by Victor Stinner; bpo-3632.)

- `Py_AddPendingCall()` はスレッドセーフになり、ワーカスレッドがメイン Python スレッドに通知を投入することができるようになりました。これは特に、非同時性の IO 処理に便利です。(Contributed by Kristján Valur Jónsson; bpo-4293.)

- 新しい関数: `PyCode_NewEmpty()` は、空のコードオブジェクトを生成します。要求されるのは、ファイル名、関数名、そして最初の行番号だけです。これは、より便利なトレースバックスタックを構成しようとする拡張モジュールに便利です。以前は、このような拡張はより多くの引数を必要とする `PyCode_New()` を呼び出す必要がありました。(Added by Jeffrey Yasskin.)

- 新しい関数: `PyErr_NewExceptionWithDoc()` は、既存の `PyErr_NewException()` と同じように新しい例外クラスを生成しますが、新しい例外クラスの docstring を含む、追加の `char *` 引数を取ります。(Added by 'lekma' on the Python bug tracker; bpo-7033.)

- 新しい関数: `PyFrame_GetLineNumber()` はフレームオブジェクトを取り、そのフレームが現在実行している行番号を返します。以前は、コードは現在実行しているバイトコード命令のインデクスを得て、それからそのアドレスに対応する行番号を探索する必要がありました。(Added by Jeffrey Yasskin.)

- 新しい関数: `PyLong_AsLongAndOverflow()` および `PyLong_AsLongLongAndOverflow()` は、C の `long` や `long long` のような Python の長整数に近いです。この数が出力型に適合するには大きすぎるなら、 overflow フラグが設定され、呼び出し元に返されます。(Contributed by Case Van Horsen; bpo-7528 and bpo-7767.)

- 新しい関数: 文字列から浮動小数点数への変換から由来する、新しい `PyOS_string_to_double()` 関数が追加されました。古い `PyOS_ascii_strtod()` および `PyOS_ascii_atof()` は、非推奨となりました。

- 新しい関数: `PySys_SetArgvEx()` は、 `sys.argv` の値を設定し、 updatepath に依ってオプションで `sys.path` を更新して `sys.argv[0]` で指名されたスクリプトを含むディレクトリを含めることができます。

  この関数は、Python を埋め込んだアプリケーションのセキュリティホールを塞ぐために追加されました。古い関数 `PySys_SetArgv()` は、必ず `sys.path` を更新し、これはカレントディレクトリを追加することがあります。これにより、Python を埋め込んだアプリケーションを別の誰かが制御するディレクトリで実行すると、攻撃者がディレクトリにトロイの木馬モジュール(例えば、 `os.py` という名前のファイル) を仕込み、インポートさせ実行させる事ができました。

  Python を埋め込んだ C/C++ アプリケーションを保守しているなら、 `PySys_SetArgv()` を呼び出していないか調べ、 updatepath を偽に設定した `PySys_SetArgvEx()` を使うべきかよく考えてください。

  bpo-5753 で CVE-2008-5983 として報告され、Antoine Pitrou によって修正されたたセキュリティ問題です。

- 新しいマクロ: Python ヘッダファイルは、以下のマクロを定義しました: `Py_ISALNUM`, `Py_ISALPHA`, `Py_ISDIGIT`, `Py_ISLOWER`, `Py_ISSPACE`, `Py_ISUPPER`, `Py_ISXDIGIT`, `Py_TOLOWER`, および `Py_TOUPPER` 。これらすべての関数は、文字を分類する C の標準マクロと類似ですが、Python は文字をロケールに依らず文字を分析したいときがあるため、現在のロケール設定を無視します。(Added by Eric Smith; bpo-5793.)

- 取り除かれた関数: `PyEval_CallObject` は、マクロとしてのみ利用できるようになりました。関数版は、ABI リンク互換性を保つために残されましたが、それは 1997 年のことです。今となっては削除するべきです。(Removed by Antoine Pitrou; bpo-8276.)

- 新しいフォーマットコード: `PyFormat_FromString()`, `PyFormat_FromStringV()`, および `PyErr_Format()` 関数は、C の `long long` 型を表示する `%lld` および `%llu` フォーマットを受け付けるようになりました。(Contributed by Mark Dickinson; bpo-7228.)

- スレッドとプロセスのフォークの間の複雑な相互関係が変更されました。以前は、 `os.fork()` によって生成された子プロセスは失敗していました。これは、子は動作しているスレッド 1 つだけで生成され、そのスレッドが `os.fork()` を処理するからです。他のスレッドが、Python のインポートロックのような、ロックを保持していたら、フォークが実行されたとき、ロックは新しいプロセスでも "held" としてマークされたままです。しかし、子プロセスでは、他のスレッドは複製されないため、ロックを解放するものは何もないので、子プロセスは import の実行を続けることができません。

  Python 2.7 は、 `os.fork()` を実行する前に import ロックを取得し、また `threading` モジュールを使って生成された全てのロックをクリーンアップします。内部ロックを持っていたり、自身で `fork()` を呼び出したりするような C 拡張モジュールは、このクリーンアップの恩恵を受けません。

  (Fixed by Thomas Wouters; bpo-1590864.)

- `Py_Finalize()` 関数は、内部の `threading._shutdown()` 関数を呼び出します。これにより、インタプリタがシャトダウンするときに送出が防がれる例外があります。(Patch by Adam Olsen; bpo-1722344.)

- `PyMemberDef` 構造を使って型の属性を定義する際、Python はもはや `T_STRING_INPLACE` 属性を削除または設定させようとはしません。

- `ctypes` によって定義されたグローバルシンボルには、 `Py` または `_ctypes` が接頭されるようになりました。(Implemented by Thomas Heller; bpo-3102.)

- 新しい設定オプション: `--with-system-expat` スイッチにより、 `pyexpat` モジュールをビルドして、システム Expat ライブラリを使えます。 (Contributed by Arfrever Frehtes Taifersar Arahesis; bpo-7609.)

- 新しい設定オプション: `--with-valgrind` オプションは、 Valgrind メモリエラー検出器が正しく分析するのが難しい pymalloc アロケータを無効にするようになりました。ですから Valgrind は、メモリリークやオーバーランをより検出できます。 (Contributed by James Henstridge; bpo-2422.)

- 新しい設定オプション: `--with-dbmliborder=` に空の文字列を与えて様々な DBM モジュールを全て無効にできます。 (Added by Arfrever Frehtes Taifersar Arahesis; bpo-6491.)

- configure スクリプトは、ある種の 32-bit Intel チップ上の浮動小数点丸めバグを調べ、 `X87_DOUBLE_ROUNDING` プリプロセッサ定義を定義します。現在この定義を使うコードはありませんが、使うことを望む人がいたら使えます。(Added by Mark Dickinson; bpo-2937.)

  configure はまた、C++ リンクをサポートする `LDCXXSHARED` Makefile を設定するようになりました。 (Contributed by Arfrever Frehtes Taifersar Arahesis; bpo-1222585.)

- ビルドプロセスは、pkg-config サポートに必要なファイルを生成するようになりました。(Contributed by Clinton Roy; bpo-3585.)

- ビルドプロセスは、Subversion 1.7 をサポートするようになりました。 (Contributed by Arfrever Frehtes Taifersar Arahesis; bpo-6094.)

### カプセル

Python 3.1 は、拡張モジュールに C API を提供する新しい C データ型 `PyCapsule` を追加しました。カプセルは、本質的には C の `void *` ポインタのホルダであり、モジュール属性として利用できるようになります。例えば、 `socket` モジュールの API は `socket.CAPI` として公開されていて、 `unicodedata` は `ucnhash_CAPI` を公開しています。その他の拡張はモジュールを import し、辞書にアクセスしてカプセルオブジェクトを取得し、そしてモジュールの様々な API 関数へのポインタの配列を指す `void *` ポインタを取得できます。

これに使われる既存のデータ型 `PyCObject` がありますが、これは型安全性を提供しません。pure Python で書かれた邪悪なコードは、 `PyCObject` をモジュール A から取り、どうにかしてそれをモジュール B の `PyCObject` で代えることで、セグメンテーション違反を起こし得ます。カプセルは自身の名前を知っていて、ポインタを得るには名前を提供しなければなりません:

    void *vtable;

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

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

`vtable` が期待どおりのものを指すことが保証されます。異なるカプセルが渡されたら、 `PyCapsule_IsValid()` は不適合な名前を検知し、偽を返します。これらのオブジェクトの使用について、より詳しい情報は、 拡張モジュールに C API を提供する を参照してください。

Python 2.7 は、様々な拡張モジュール API を提供するためにカプセルを内部的に使うようになりましたが、カプセルを処理するために `PyCObject_AsVoidPtr()` が `CObject` インタフェースとのコンパイル時互換性は保ったまま変更されました。 `PyCObject_AsVoidPtr()` を使うと `PendingDeprecationWarning` が合図されますが、デフォルトでは言及されません。

Implemented in Python 3.1 and backported to 2.7 by Larry Hastings; discussed in bpo-5630.

### ポート特有の変更: Windows

- `msvcrt` モジュールは、 `crtassem.h` からのいくつかの定数を追加しました。 `CRT_ASSEMBLY_VERSION`, `VC_ASSEMBLY_PUBLICKEYTOKEN`, および `LIBRARIES_ASSEMBLY_NAME_PREFIX`. (Contributed by David Cournapeau; bpo-4365.)

- レジストリへのアクセスのための `_winreg` モジュールは、以前サポートされていた関数群の引数を増やした拡張版である `CreateKeyEx()` および `DeleteKeyEx()` を実装しました。 `DisableReflectionKey()`, `EnableReflectionKey()`, および `QueryReflectionKey()` もテストされ、ドキュメント化されました。(Implemented by Brian Curtin: bpo-7347.)

- 新しい `_beginthreadex()` API がスレッドの開始に使われ、ネイティブのスレッドローカルストレージ間数が使われるようになりました。(Contributed by Kristján Valur Jónsson; bpo-3582.)

- `os.kill()` 関数が Windows で働くようになりました。このシグナル値は定数 `CTRL_C_EVENT`, `CTRL_BREAK_EVENT`, その他の整数にできます。最初の 2 定数は `Control-C` および `Control-Break` 打鍵イベントをサブプロセスに送ります。その他の値は、 `TerminateProcess()` API を使います。(Contributed by Miki Tebeka; bpo-1220212.)

- `os.listdir()` 関数は、空のパスに対してちゃんと失敗するようになりました。 (Fixed by Hirokazu Yamamoto; bpo-5913.)

- `mimelib` モジュールは、初期化の際に Windows レジストリから MIME データベースを正しく読みこむようになりました。 (Patch by Gabriel Genellina; bpo-4969.)

### ポート特有の変更: Mac OS X

- 追加されたパッケージを、システムインストレーションとユーザがインストールした同じバージョンのコピーで共有するために、 `sys.path` に `/Library/Python/2.7/site-packages` が追加されました。 (Changed by Ronald Oussoren; bpo-4865.)

  > バージョン 2.7.13 で変更: As of 2.7.13, this change was removed. `/Library/Python/2.7/site-packages`, the site-packages directory used by the Apple-supplied system Python 2.7 is no longer appended to `sys.path` for user-installed Pythons such as from the python.org installers. As of macOS 10.12, Apple changed how the system site-packages directory is configured, which could cause installation of pip components, like setuptools, to fail. Packages installed for the system Python will no longer be shared with user-installed Pythons. (bpo-28440)

### ポート特有の変更: FreeBSD

- FreeBSD 7.1 の、他のルーティングテーブルを選択するための `getsockopt()`/`setsockopt()` で使われている `SO_SETFIB` 定数が、 `socket` モジュールで使えるようになりました。(Added by Kyle VanderBeek; bpo-8235.)

## その他の変更と修正

- ベンチマークスクリプトの 2 つ、 `iobench` および `ccbench`, が `Tools` ディレクトリに追加されました。 `iobench` は、様々な演算を実行している間 `open()` によって返された組み込みファイル I/O オブジェクトの速度を計測し、 `ccbench` は、変化する数のスレッドを使っていくつかのタスクを処理するときの計算スループット、スレッド切り替えレイテンシ、IO 処理バンド幅の計測を試みる同時実行ベンチマークです。

- `Tools/i18n/msgfmt.py` スクリプトは、複数の形式の `.po` ファイルを理解できるようになりました。(Fixed by Martin von Löwis; bpo-5464.)

- 既存の対応する `.py` が存在する `.pyc` または `.pyo` ファイルからモジュールを import するとき、結果のコードオブジェクトの `co_filename` 属性は、元のファイル名が古くなったとき、上書きされます。これは、ファイルがリネーム、移動、異なるパスを通したアクセスをされたときに起こりえます。(Patch by Ziga Seilnacht and Jean-Paul Calderone; bpo-1180193.)

- `regrtest.py` スクリプトは、テストを乱順に実行する `-r` オプションの、ランダムシードに使われる整数を取る `--randseed=` スイッチを取るようになりました。 `-r` オプションは、使われたシードも報告します。 (Added by Collin Winter.)

- もう一つの `regrtest.py` スイッチは `-j` で、いくつのテストを並行して実行するかを指定する整数です。これにより、マルチコア機での合計実行時間を短縮できます。このオプションは、実行時間を長くすることで知られている `-R` スイッチなど、いくつかの他のオプションと互換です。 (Added by Antoine Pitrou, bpo-6152.) これはまた、選ばれたテストを失敗するまでループして実行する `-F` スイッチとも同時に使えます。(Added by Antoine Pitrou; bpo-7312.)

- スクリプトとして実行されるとき、 `py_compile.py` モジュールは標準入力を読み込んでコンパイルするファイル名のリストとする `'-'` を引数として受け付けるようになりました。(Contributed by Piotr Ożarowski; bpo-8233.)

## Python 2.7 への移植

このセクションでは前述の変更とバグフィックスにより必要となるかもしれないコードの変更を列挙します:

- `range()` 関数は、引数をより一貫して処理するようになりました。浮動小数点数でもなく整数でもない引数が与えられたら、その `__int__()` を呼び出すようになりました。(Fixed by Alexander Belopolsky; bpo-1533.)

- 文字列 `format()` メソッドは浮動小数点数および複素数に使われるデフォルトの精度を、 `str()` で使われる精度に合わせ、小数第 6 位から 12 位に変更しました。 (Changed by Eric Smith; bpo-5920.)

- `with` 文の最適化のため、特殊メソッド `__enter__()` および `__exit__()` はオブジェクトの型に属さなければならず、オブジェクトのインスタンスには直接取り付けられません。これは (`object` から導出された) 新スタイルクラスと C 拡張型に影響します。 (bpo-6101.)

- Python 2.6 におけるバグのため、 `__exit__()` の exc_value パラメタははよく、例外のインスタンスではなく文字列表現になっていました。これは 2.7 では修正され、 exc_value は期待通りインスタンスになります。 (Fixed by Florent Xicluna; bpo-7853.)

- `__slots__` を利用して属性を制限した場合に、設定されていない属性を del したときに `AttributeError` にならなかったのを修正しました。 (Fixed by Benjamin Peterson; bpo-7604.)

標準ライブラリでは:

- 年がサポートされている範囲外にはみ出るような `datetime` インスタンスの演算が、 `OverflowError` を送出しないことがありました。このようなエラーはより注意深く調べられ、例外を送出するようになりました。(Reported by Mark Leander, patch by Anand B. Pillai and Alexander Belopolsky; bpo-7150.)

- `Decimal` インスタンスを文字列の `format()` メソッドに使うとき、デフォルトの揃えは以前は左揃えでした。これは右揃えに変更され、プログラムの出力が変わるかもしれません。(Changed by Mark Dickinson; bpo-6857.)

  signaling NaN (あるいは `sNAN`) との比較は、暗黙に比較演算に応じて真偽値を返すのではなく、 `InvalidOperation` 例外を発生させるようになりました。 Quiet NaN (あるいは `NAN`) はハッシュ可能になりました。 (Fixed by Mark Dickinson; bpo-7279.)

- ElementTree ライブラリ `xml.etree` は、 (<?xml-stylesheet href="#style1"?> のような) 命令や (<!-- comment --> のような) コメントを処理する XML を出力するときにアンパサンドおよび角括弧をエスケープしなくなりました。 (Patch by Neil Muller; bpo-2746.)

- `StringIO` オブジェクトの `readline()` メソッドは負の長さが要求されたとき、ほかのファイル風オブジェクトと同じように、何もしなくなりました。(bpo-7348)

- `syslog` モジュールは、識別子として、以前デフォルトであった `'python'` の値ではなく、 `sys.argv[0]` の値を使うようになりました。 (Changed by Sean Reifschneider; bpo-8451.)

- `tarfile` モジュールのデフォルトエラー処理が変更され、致命的なエラーを抑制しないようになりました。デフォルトのエラーレベルは以前は 0 で、エラーはメッセージとしてデバッグログに書き込まれるだけでしたが、デバッグログはデフォルトでは活性化されていないため、エラーは顧みられませんでした。デフォルトのエラーレベルは 1 になり、エラーがあれば例外が送出されます。 (Changed by Lars Gustäbel; bpo-7357.)

- `urlparse` モジュールの `urlsplit()` は、未知の URL スキームを RFC 3986 に応じた方法で処理します。 URL が `"<something>://..."` の形式なら、 `://` の前のテキストを、それがモジュールの知らない作り物のスキームであってさえ、スキームとして扱います。この変更は、古い働きを使って動作していたコードを破壊することがあります。例えば、Python 2.6.4 や 2.5 は以下を返します:

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

  Python 2.7 (や Python 2.6.5) は以下を返します:

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

  (Python 2.7 では、これは普通のタプルではなく名前付きタプルを返すので、実際は微妙に異なる出力をします。)

C 拡張では:

- `PyArg_Parse*` 系統の関数で整数フォーマットコードを使う C 拡張は、 `DeprecationWarning` を引き起こすのではなく、 `TypeError` 例外を送出するようになりました。(bpo-5080)

- 非推奨となった古い `PyOS_ascii_strtod()` および `PyOS_ascii_atof()` 関数の代わりに、新しい `PyOS_string_to_double()` 関数を使ってください。

Python を埋め込んだアプリケーションでは:

- `PySys_SetArgvEx()` 関数が追加され、既存の `PySys_SetArgv()` 関数が使われた時のセキュリティホールを塞ぐことができるようになりました。 `PySys_SetArgv()` を呼び出していないか調べ、 updatepath を偽に設定した `PySys_SetArgvEx()` を使うべきかよく考えてください。

## Python 2.7 メンテナンスリリースで追加された新機能

Python 2.7 メンテナンスリリースでは、正真正銘それが求められる状況では、新しい機能が追加される場合があります。そのような追加のどんなものでも Python Enhancement Proposal プロセスを通過しなければなりません。Python 3 だけに新しい機能を追加することによっても Python Package Index に公開することによってもいずれでも十分ではないと言えるだけのやむにやまれない理由付けが必要です。

個別の提案は以下にリストしますが、全ての Python 2.7 メンテナンスリリースに追加される新しい `-3` 警告は除いています。

### デバッグモード用の2つの新しい環境変数

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.)

バージョン 2.7.15 で追加.

### PEP 434: IDLE 拡張についての全てのブランチにおける例外的な扱い

PEP 434 は、Pythonと一緒に出荷されるIDLE開発環境に変更を加えるための一般的な免除事項を説明します。これは、IDLE の開発者 が Python 2 と 3 のすべてのサポートされているバージョン間でより一貫したユーザーエクスペリエンスを提供するためのものです。

全ての IDLE の変更についての詳細は、個別のリリースについてのNEWS ファイルを参照してください。

### PEP 466: Python 2.7 のためのネットワークセキュリティ拡張

PEP 466 は、 Python 2.7 メンテナンスリリースに含めることを認められた数多くのネットワークセキュリティ強化についての提案を記述しています。それら変更の最初のものは Python 2.7.7 に初めて登場しました。

Python 2.7.7 に PEP 466 関連で追加された機能:

- `hmac.compare_digest()` が Python 3 からバックポートされました。これにより Python 2 アプリケーションで timing attack resistant comparison operation が利用可能になります (Contributed by Alex Gaynor; bpo-21306.)

- python.org で公開される公式 Windows インストーラのビルドに使う OpenSSL が 1.0.1g にアップグレードされました . (Contributed by Zachary Ware; bpo-21462.)

Python 2.7.8 に PEP 466 関連で追加された機能:

- `hashlib.pbkdf2_hmac()` が Python 3 からバックポートされました。これにより Python 2 アプリケーションでも、安全なパスワード格納に広範に使うのに相応しいハッシュアルゴリズムが利用できます (Contributed by Alex Gaynor; bpo-21304.)

- python.org で公開される公式 Windows インストーラのビルドに使う OpenSSL が 1.0.1h にアップグレードされました (contributed by Zachary Ware in bpo-21671 for CVE-2014-0224)

Python 2.7.9 に PEP 466 関連で追加された機能:

- Python 3.4 の `ssl` モジュールのほとんどがバックポートされました。つまり `ssl` は今や、Server Name Indication, TLS1.x 設定, platform certificate store へのアクセス, `SSLContext` クラス, その他機能が使えます (Contributed by Alex Gaynor and David Reid; bpo-21308.)

  個別の詳細については、モジュールのドキュメンテーション内の "バージョン 2.7.9 で追加" の注釈を参照してください。

- `os.urandom()` は、呼び出しのたびに `/dev/urandom` を開きなおす代わりに `/dev/urandom` のファイル記述子をキャッシュするように変更されました。(Contributed by Alex Gaynor; bpo-21305.)

- `hashlib.algorithms_guaranteed` と `hashlib.algorithms_available` が Python 3 からバックポートされました。これにより Python 2 アプリケーションが可能な限り最強のハッシュアルゴリズムを選択するのが容易になります (Contributed by Alex Gaynor in bpo-21307)

### PEP 477: Python 2.7 への ensurepip (PEP 453) バックポート

PEP 477 が Python 2.7 メンテナンスリリースに PEP 453 ensurepip モジュール, それによって可能になるドキュメンテーションの改善を含めることを認め、Python 2.7.9 リリースではじめてお披露目されました。

#### デフォルトでの pip のブートストラッピング

新しい `ensurepip` モジュール( PEP 453 で定義されています)は標準のクロスプラットフォームのメカニズムで、Python インストールに pip インストーラをブートストラップします。Python 2.7.9 に含まれる `pip` のバージョンは `pip` 1.5.6 で、将来の 2.7.x メンテナンスリリースでは Python のリリース候補の作成時点で入手出来る最新バージョンの `pip` がバンドルされる予定です。

デフォルトでは `pip` , `pipX` , `pipX.Y` コマンドが全てのプラットフォームに、Python パッケージ `pip` とその依存物とともにインストールされます(X. Y はインストールされる Python のバージョン)。

CPython の source builds on POSIX systems では `make install`, `make altinstall` コマンドはデフォルトでは `pip` ブートストラップを行いません。この振る舞いは configure のオプションを変更して Makefile を作ることで変更できます。

Windows と Mac OS X では CPython インストーラはそれ自身と一緒に `pip` をデフォルトでインストールするようになっています(ユーザはインストールプロセスで除外するかもしれませんが)。Windows ユーザは `pip` がコマンドラインからデフォルトで利用可能なように `PATH` の自動修正するかの選択を求められます。そうしない場合でも Windows のための Python ランチャで `py -m pip` のようにすれば良いです。

discussed in the PEP の通りプラットフォームのパッケージャは、プラットフォームでのそれらインストールの単純明快な手段を自身が提供する(普通システムのパッケージマネージャ)からと言う理由で、デフォルトでのこれらコマンドのインストールを選択しないかもしれません。

#### ドキュメントの変更

この変更の一部は、 Python モジュールのインストール と Python モジュールの配布 セクションがより手短な始め方として完全にデザインし直されたことと、FAQ ドキュメントです。ほとんどのパッケージングについてのドキュメンテーションは Python Packaging User Guide が保守している Python Packaging Authority に移動されて、独立したプロジェクトのドキュメンテーションになっています。

ですが、この移行は現在のところまだ少し不完全ですので、これらのガイドのレガシーなバージョンは Python モジュールのインストール (旧版) と Python モジュールの配布 (レガシーバージョン) に残してあります。

参考

PEP 453 -- Python インストールの際の明示的なpipのブートストラッピング

  PEP は Donald Stufft と Nick Coghlan によって書かれ、Donald Stufft, Nick Coghlan, Martin von Löwis, Ned Deily により実装されました。

### PEP 476: stdlib http クライアントが証明書の検証を行うのをデフォルトで有効化

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.

以前の古い振る舞いが必要なアプリケーションでは、代わりとなるコンテキストを渡せます:

    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: HTTPS verification migration tools for Python 2.7

PEP 493 provides additional migration tools to support a more incremental infrastructure upgrade process for environments containing applications and services relying on the historically permissive processing of server certificates when establishing client HTTPS connections. These additions were made in the Python 2.7.12 release.

These tools are intended for use in cases where affected applications and services can't be modified to explicitly pass a more permissive SSL context when establishing the connection.

For applications and services which can't be modified at all, the new `PYTHONHTTPSVERIFY` environment variable may be set to `0` to revert an entire Python process back to the default permissive behaviour of Python 2.7.8 and earlier.

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.

### New `make regen-all` build target

To simplify cross-compilation, and to ensure that CPython can reliably be compiled without requiring an existing version of Python to already be available, the autotools-based build system no longer attempts to implicitly recompile generated files based on file modification times.

Instead, a new `make regen-all` command has been added to force regeneration of these files when desired (e.g. after an initial version of Python has already been built based on the pregenerated versions).

More selective regeneration targets are also defined - see Makefile.pre.in for details.

(Victor Stinner の貢献による bpo-23404)

バージョン 2.7.14 で追加.

### Removal of `make touch` build target

The `make touch` build target previously used to request implicit regeneration of generated files by updating their modification times has been removed.

It has been replaced by the new `make regen-all` target.

(Victor Stinner の貢献による bpo-23404)

バージョン 2.7.14 で変更.

## 謝辞

著者は、以下の方々がこの記事の多くの草稿に提案、修正、そして助力を差し伸べてくださったことに感謝の意を表したいと思います: Nick Coghlan, Philip Jenvey, Ryan Lovett, R. David Murray, Hugh Secker-Walker.