pytho****@googl*****
pytho****@googl*****
2011年 11月 5日 (土) 19:03:20 JST
Revision: bdd9e6842573 Author: Naoki INADA <inada****@klab*****> Date: Sat Nov 5 03:02:28 2011 Log: Update 2.7.2: textwrap, simplehttpserver, timeit, weakref, nntplib http://code.google.com/p/python-doc-ja/source/detail?r=bdd9e6842573 Modified: /library/nntplib.rst /library/simplehttpserver.rst /library/textwrap.rst /library/timeit.rst /library/timeit.rst.diff /library/weakref.rst ======================================= --- /library/nntplib.rst Wed Apr 20 03:07:25 2011 +++ /library/nntplib.rst Sat Nov 5 03:02:28 2011 @@ -17,34 +17,36 @@ 以下にこのモジュールの使い方の小さな例を二つ示します。ニュースグループに関 する統計情報を列挙し、最新 10 件の記事を出力するには以下のようにします:: - >>> s = NNTP('news.cwi.nl') - >>> resp, count, first, last, name = s.group('comp.lang.python') + >>> s = NNTP('news.gmane.org') + >>> resp, count, first, last, name = s.group('gmane.comp.python.committers') >>> print 'Group', name, 'has', count, 'articles, range', first, 'to', last - Group comp.lang.python has 59 articles, range 3742 to 3803 + Group gmane.comp.python.committers has 1071 articles, range 1 to 1071 >>> resp, subs = s.xhdr('subject', first + '-' + last) >>> for id, sub in subs[-10:]: print id, sub ... - 3792 Re: Removing elements from a list while iterating... - 3793 Re: Who likes Info files? - 3794 Emacs and doc strings - 3795 a few questions about the Mac implementation - 3796 Re: executable python scripts - 3797 Re: executable python scripts - 3798 Re: a few questions about the Mac implementation - 3799 Re: PROPOSAL: A Generic Python Object Interface for Python C Modules - 3802 Re: executable python scripts - 3803 Re: \POSIX{} wait and SIGCHLD + 1062 Re: Mercurial Status? + 1063 Re: [python-committers] (Windows) buildbots on 3.x + 1064 Re: Mercurial Status? + 1065 Re: Mercurial Status? + 1066 Python 2.6.6 status + 1067 Commit Privileges for Ask Solem + 1068 Re: Commit Privileges for Ask Solem + 1069 Re: Commit Privileges for Ask Solem + 1070 Re: Commit Privileges for Ask Solem + 1071 2.6.6 rc 2 >>> s.quit() - '205 news.cwi.nl closing connection. Goodbye.' - -ファイルから記事を投稿するには、以下のようにします (この例では記事番号は有 効な番号を指定していると仮定しています):: - - >>> s = NNTP('news.cwi.nl') + '205 Bye!' + +ファイルから記事を投稿するには、以下のようにします。 +(この例では記事番号は有効な番号を指定していて、あなたがそのニュースグループ に投稿する +権限を持っていると仮定しています) :: + + >>> s = NNTP('news.gmane.org') >>> f = open('/tmp/article') >>> s.post(f) '240 Article posted successfully.' >>> s.quit() - '205 news.cwi.nl closing connection. Goodbye.' + '205 Bye!' このモジュール自体では以下の内容を定義しています: ======================================= --- /library/simplehttpserver.rst Sun Feb 20 05:31:42 2011 +++ /library/simplehttpserver.rst Sat Nov 5 03:02:28 2011 @@ -78,24 +78,27 @@ .. versionadded:: 2.5 ``'Last-Modified'`` ヘッダ. -:mod:`SimpleHTTPServer` モジュールを使って現在のディレクトリ以下にあるファ イルにアクセスできるだけの、非常に初歩的な Web サーバを立ち上げる方法は以下 の通りです。:: - - import SimpleHTTPServer - import SocketServer - - PORT = 8000 - - Handler = SimpleHTTPServer.SimpleHTTPRequestHandler - - httpd = SocketServer.TCPServer(("", PORT), Handler) - - print "serving at port", PORT - httpd.serve_forever() - -インタプリタの ``-m`` スイッチで :mod:`SimpleHTTPServer` モジュールと ``ポート番号`` を指定して直接実行することもできます。 -上の例と同じように、ここで立ち上がったサーバは現在のディレクトリ以下のファ イルへのアクセスを提供します。:: - - python -m SimpleHTTPServer 8000 +:mod:`SimpleHTTPServer` モジュールを使って現在のディレクトリ以下にあるファ イルに +アクセスできるだけの、非常に初歩的な Web サーバを立ち上げる方法は以下の通り です。 :: + + import SimpleHTTPServer + import SocketServer + + PORT = 8000 + + Handler = SimpleHTTPServer.SimpleHTTPRequestHandler + + httpd = SocketServer.TCPServer(("", PORT), Handler) + + print "serving at port", PORT + httpd.serve_forever() + +インタプリタの ``-m`` スイッチで :mod:`SimpleHTTPServer` モジュールと ``ポート番号`` +を指定して直接実行することもできます。 +上の例と同じように、ここで立ち上がったサーバは現在のディレクトリ以下のファ イルへの +アクセスを提供します。 :: + + python -m SimpleHTTPServer 8000 .. seealso:: ======================================= --- /library/textwrap.rst Sat Apr 16 17:12:19 2011 +++ /library/textwrap.rst Sat Nov 5 03:02:28 2011 @@ -15,6 +15,10 @@ を提供しています。単に一つや二つのテキスト文字列の折り返しまたは詰め込みを 行っているならば、簡易関数で十分間に合います。そうでなければ、 効率のために :class:`TextWrapper` のインスタンスを使った方が良いでしょう。 +.. seealso:: + + 最新バージョンの `textwrap モジュールの Python ソースコード + <http://svn.python.org/view/python/branches/release27-maint/Lib/textwrap.py?view=markup>`_ .. function:: wrap(text[, width[, ...]]) @@ -115,6 +119,13 @@ :attr:`expand_tabs` が偽で :attr:`replace_whitespace` が真ならば、 \ 各タブ文字は1つの空白に置き換えられます。それはタブ展開と同じでは *ありません* 。 + .. note:: + + :attr:`replace_whitespace` が偽の場合、改行が行の途中で現れること で + 出力がおかしくなることがあります。 + このため、テキストを(:meth:`str.splitlines` などを使って)段落ごと に + 分けて別々に wrap する必要があります。 + .. attribute:: drop_whitespace .. (default: ``True``) If true, whitespace that, after wrapping, happens to ======================================= --- /library/timeit.rst Sat Mar 5 04:24:16 2011 +++ /library/timeit.rst Sat Nov 5 03:02:28 2011 @@ -125,25 +125,34 @@ 以下のオプションが使用できます。 --n N/ :option:`--number` =N +.. program:: timeit + +.. cmdoption:: -n N, --number=N + 'statement' を何回実行するか --r N/ :option:`--repeat` =N +.. cmdoption:: -r N, --repeat=N + タイマを何回リピートするか(デフォルトは 3) --s S/ :option:`--setup` =S - 最初に1回だけ実行する文 (デフォルトは ``'pass'``) - --t/ :option:`--time` +.. cmdoption:: -s S, --setup=S + + 最初に1回だけ実行する文 (デフォルトは ``pass``) + +.. cmdoption:: -t, --time + :func:`time.time` を使用する (Windows を除くすべてのプラットフォームのデ フォルト) --c/ :option:`--clock` +.. cmdoption:: -c, --clock + :func:`time.clock` を使用する(Windows のデフォルト) --v/ :option:`--verbose` +.. cmdoption:: -v, --verbose + 時間計測の結果をそのまま詳細な数値でくり返し表示する --h/ :option:`--help` +.. cmdoption:: -h, --help + 簡単な使い方を表示して終了する 文は複数行指定することもできます。 ======================================= --- /library/timeit.rst.diff Sun Oct 30 17:04:23 2011 +++ /library/timeit.rst.diff Sat Nov 5 03:02:28 2011 @@ -29,10 +29,10 @@ --s S/:option:`--setup=S` - statement to be executed once initially (default ``'pass'``) +.. cmdoption:: -s S, --setup=S ++ ++ statement to be executed once initially (default ``pass``) --t/:option:`--time` -+ statement to be executed once initially (default ``pass``) -+ +.. cmdoption:: -t, --time + use :func:`time.time` (default on all platforms but Windows) ======================================= --- /library/weakref.rst Wed Apr 20 03:07:25 2011 +++ /library/weakref.rst Sat Nov 5 03:02:28 2011 @@ -60,11 +60,14 @@ メソッド、 :class:`set` と :class:`frozenset` 型、ファイルオブジェクト、 ジェネレータ(:term:`generator`)、 type オブジェクト、 :mod:`bsddb` モジュー ルの :class:`DBcursor` 型、ソケット型、 :class:`array` 型、 :class:`deque` 型、 -正規表現パターンオブジェクトです。 +正規表現パターンオブジェクト, code オブジェクトです。 .. versionchanged:: 2.4 ファイル、ソケット、 :class:`array` 、および正規表現パターンのサポートを 追加しました. +.. versionchanged:: 2.7 + thread.lock, threading.Lock, code オブジェクトのサポートを追加しました。 + :class:`list` や :class:`dict` など、いくつかの組み込み型は弱参照を 直接サポートしませんが、以下のようにサブクラス化を行えばサポートを追加でき ます:: @@ -219,6 +222,14 @@ .. versionadded:: 2.5 +.. class:: WeakSet([elements]) + + 要素への弱参照を持つ集合型。 + 要素への強参照が無くなったときに、その要素は削除されます。 + + .. versionadded:: 2.7 + + .. data:: ReferenceType 弱参照オブジェクトのための型オブジェクト。
