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 だけが比較されます。

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

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

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

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

* The "json" module's "JSONDecoder" class constructor was extended
  with an *object_pairs_hook* parameter to allow "OrderedDict"
  instances to be built by the decoder. Support was also added for
  third-party tools like 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" クラスに  "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.)

* Long integers are now stored internally either in base "2**15" or in
  base "2**30", the base being determined at build time.  Previously,
  they were always stored in base "2**15".  Using base "2**30" gives
  significant performance improvements on 64-bit machines, but
  benchmark results on 32-bit machines have been mixed.  Therefore,
  the default is to use base "2**30" on 64-bit machines and base
  "2**15" on 32-bit machines; on Unix, there's a new configure option
  "--enable-big-digits" that can be used to override this default.

  この変更はパフォーマンスの向上以外の形ではユーザーに見えないはずです
  が、 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.)

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

* "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.1000000000000000055
  511151231257827021181583404541015625')" を返します。 (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)。

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

  その他の変更により、拡張は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" パッケージとして別にダウンロードできます。

When used from the command line, the module can automatically discover
tests.  It's not as fancy as py.test or nose, but provides a simple
way to run tests kept within a set of package directories.  For
example, the following command will search the "test/" subdirectory
for any importable test files named "test*.py":

   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()" and "assertNotAlmostEqual()" test whether
  *first* and *second* are approximately equal.  This method can
  either round their difference to an optionally specified number of
  *places* (the default is 7) and compare it to zero, or require the
  difference to be smaller than a supplied *delta* value.

* "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)。これは、モジュールをインポートして使う方法には影響
しません。

参考:

  https://web.archive.org/web/20210619163128/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 develops ElementTree and produced the 1.3 version; you
can read his article describing 1.3 at https://web.archive.org/web/20
200703234532/http://effbot.org/zone/elementtree-13-intro.htm. Florent
Xicluna updated the version included with Python, after discussions on
python-dev and in bpo-6472.)


ビルドならびに 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.)

* New functions: "PyLong_AsLongAndOverflow()" and
  "PyLong_AsLongLongAndOverflow()"  approximates a Python long integer
  as a C "long" or "long long". If the number is too large to fit into
  the output type, an *overflow* flag is set and returned to the
  caller. (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.)

* New format codes: the "PyFormat_FromString()",
  "PyFormat_FromStringV()", and "PyErr_Format()" functions now accept
  "%lld" and "%llu" format codes for displaying C's "long long" types.
  (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.)

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

* 新しい "_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.)

* エレメントツリーライブラリ、 "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.
