Commits

Anonymous committed 31835f6

translated functools into Japanese
translated recent history

Comments (0)

Files changed (4)

PyMOTW/functools/index.rst

-=====================================================================
-functools -- Tools for making decorators and other function wrappers.
-=====================================================================
+..
+    =====================================================================
+    functools -- Tools for making decorators and other function wrappers.
+    =====================================================================
+
+=============================================================
+functools -- デコレータを作るためのツールとその他の関数ラッパ
+=============================================================
+
+..
+    :synopsis: Tools for making decorators and other function wrappers.
 
 .. module:: functools
-    :synopsis: Tools for making decorators and other function wrappers.
+    :synopsis: デコレータを作るためのツールとその他の関数ラッパ
 
-:Purpose: 
-    The functools module includes tools for wrapping functions and other
-    callable objects.
-:Python Version: new in 2.5
+..
+    :Purpose: 
+        The functools module includes tools for wrapping functions and other
+        callable objects.
+    :Python Version: new in 2.5
 
-The primary tool supplied by the functools module is the class
-``partial``, which can be used to "wrap" a callable with default
-arguments. The resulting object is itself callable and can be treated
-as though it is the original function.  It takes all of the same
-arguments as the original callable and can be invoked with extra
-positional or named arguments as well.
+:目的: functools モジュールは関数やその他の呼び出し可能オブジェクトをラップするためのツールを提供します
+:Python バージョン: 2.5 で新規追加
+
+..
+    The primary tool supplied by the functools module is the class
+    ``partial``, which can be used to "wrap" a callable with default
+    arguments. The resulting object is itself callable and can be treated
+    as though it is the original function.  It takes all of the same
+    arguments as the original callable and can be invoked with extra
+    positional or named arguments as well.
+
+functools モジュールで提供される主なツールは、デフォルト引数で呼び出し可能オブジェクトを "ラップ" するために使用される ``partial`` クラスです。その結果として返されるオブジェクトはそれ自身が呼び出し可能でオリジナルの関数を経由するように扱われます。オリジナルの呼び出し可能オブジェクトと同じ全ての引数を取り、さらに追加の位置引数やキーワード引数を受け取って実行することができます。
 
 partial
 =======
 
-This example shows two simple partial objects for the function
-``myfunc()``.  Notice that ``show_details()`` prints the func, args,
-and keywords attributes of the partial object.
+..
+    This example shows two simple partial objects for the function
+    ``myfunc()``.  Notice that ``show_details()`` prints the func, args,
+    and keywords attributes of the partial object.
+
+このサンプルは ``myfunc()`` 関数のために2つの単純な partial オブジェクトの説明をします。 ``show_details()`` は渡された関数、その引数と partial オブジェクトの keywords 属性を表示することに注目してください。
 
 .. include:: functools_partial.py
     :literal:
     :start-after: #end_pymotw_header
 
-At the end of the example, the first partial created is invoked without
-passing a value for *a*, causing an exception.
+..
+    At the end of the example, the first partial created is invoked without
+    passing a value for *a*, causing an exception.
+
+このサンプルの最後で、最初に作成した partial オブジェクトの仮引数 *a* に値を渡さずに実行するので例外が発生します。
 
 ::
 
 update_wrapper
 ==============
 
-The partial object does not have ``__name__`` or ``__doc__``
-attributes by default. Losing those attributes for decorated functions
-makes them more difficult to debug. By using ``update_wrapper``, you
-can copy or add attributes from the original function to the partial
-object.
+..
+    The partial object does not have ``__name__`` or ``__doc__``
+    attributes by default. Losing those attributes for decorated functions
+    makes them more difficult to debug. By using ``update_wrapper``, you
+    can copy or add attributes from the original function to the partial
+    object.
+
+partial オブジェクトはデフォルトで ``__name__`` や ``__doc__`` 属性を持っていません。デコレートされた関数のそういった属性をなくしてしまうことはデバッグをより難しくしてしまいます。 ``update_wrapper`` を使用することでオリジナルの関数から partial オブジェクトに渡された属性をコピー又は追加することができます。
 
 .. include:: functools_update_wrapper.py
     :literal:
     :start-after: #end_pymotw_header
 
-The attributes added to the wrapper are defined in
-``functools.WRAPPER_ASSIGNMENTS``, while ``functools.WRAPPER_UPDATES``
-lists values to be modified.
+..
+    The attributes added to the wrapper are defined in
+    ``functools.WRAPPER_ASSIGNMENTS``, while ``functools.WRAPPER_UPDATES``
+    lists values to be modified.
+
+そのラッパへ追加される属性は ``functools.WRAPPER_ASSIGNMENTS`` で定義されます。一方 ``functools.WRAPPER_UPDATES`` は変更される値を表示します。
 
 ::
 
 		__name__: myfunc
 		__doc__ 'Docstring for myfunc().'
 
-Methods and Other Callables
-===========================
+..
+    Methods and Other Callables
+    ===========================
 
-Partials work with any callable object, including methods and instances.
+メソッドとその他の呼び出し可能オブジェクト
+==========================================
+
+..
+    Partials work with any callable object, including methods and instances.
+
+partial はメソッドやインスタンスも含め、どのような呼び出し可能オブジェクトでも動作します。
 
 .. include:: functools_method.py
     :literal:
 wraps
 =====
 
-Updating the properties of a wrapped callable is especially useful
-when used in a decorator, since the decorated function ends up with
-properties of the original, "raw", function. :mod:`functools` provides
-a convenience function, ``wraps()``, to be used as a decorator itself
-and to apply ``update_wrapper()`` automatically.
+..
+    Updating the properties of a wrapped callable is especially useful
+    when used in a decorator, since the decorated function ends up with
+    properties of the original, "raw", function. :mod:`functools` provides
+    a convenience function, ``wraps()``, to be used as a decorator itself
+    and to apply ``update_wrapper()`` automatically.
+
+ラップされた呼び出し可能オブジェクトのプロパティ更新は、decorated 関数が最終的にオリジナルの "raw" 関数のプロパティになるのでデコレータで行うとかなり便利です。 :mod:`functools` は ``wraps()`` という便利な関数を提供します。それはデコレータのように使用されて自動的に ``update_wrapper()`` を適用します。
 
 .. include:: functools_wraps.py
     :literal:
 .. seealso::
 
     `functools <http://docs.python.org/library/functools.html>`_
-        The standard library documentation for this module.
-    
+        .. The standard library documentation for this module.
+
+        本モジュールの標準ライブラリドキュメント

PyMOTW/history.rst

 ====
 
 ..
+  - 8 Aug 2010, :mod:`argparse`
+
+1.120
+  - 2010年8月8日, :mod:`argparse`
+
+
+..
   - 11 July 2010, :mod:`gc`
 
-1.120
-
-  - 8 Aug 2010, :mod:`argparse`
-
 1.119
-  - 2011年7月11日, :mod:`gc`
+  - 2010年7月11日, :mod:`gc`
 
 
 ..

PyMOTW/locale/index.rst

     :Python Version: 1.5, with extensions through 2.5 (this discussion assumes 2.5)
 
 :目的: POSIX 文化のローカライゼーション API
-:Python バージョン: 1.5 で追加され 2.5 で機能拡張(本稿の内容は 2.5 を想定)
+:Python バージョン: 1.5 で新規追加され 2.5 で機能拡張(本稿の内容は 2.5 を想定)
 
 ..
     The locale module is part of Python's internationalization and
 
 ここでの話題は locale モジュールの高レベル関数のみ説明します。低レベルの関数(``format_string()``)、アプリケーションでロケールを管理するために関連する関数(``resetlocale()``)といった関数群もあります。いつもの通り、あなたは Python のライブラリドキュメントでさらに詳細を確認したくなるでしょう。
 
-..
-    `locale <http://docs.python.org/library/locale.html>`_
-        The standard library documentation for this module.
-    :mod:`gettext`
-        Message catalogs for translations.
-
 .. seealso::
 
     `locale <http://docs.python.org/library/locale.html>`_
+        .. The standard library documentation for this module.
+
         本モジュールの標準ライブラリドキュメント
 
     :mod:`gettext`
+        .. Message catalogs for translations.
+
         翻訳のためのメッセージカタログ

PyMOTW/urlparse/index.rst

     :Python Version: since 1.4
 
 :目的: URL を部分文字列に分割する
-:Python バージョン: 1.4 以
+:Python バージョン: 1.4 以
 
 ..
     The :mod:`urlparse` module provides functions for breaking URLs down
 .. }}}
 .. {{{end}}}
 
-..
-    `urlparse <http://docs.python.org/lib/module-urlparse.html>`_
-        Standard library documentation for this module.
-    :mod:`urllib`
-        Retrieve the contents of a resource identified by a URL.
-    :mod:`urllib2`
-        Alternative API for accessing remote URLs.
-
 .. seealso::
 
     `urlparse <http://docs.python.org/lib/module-urlparse.html>`_
+        .. Standard library documentation for this module.
+
         本モジュールの標準ライブラリドキュメント
 
     :mod:`urllib`
+        .. Retrieve the contents of a resource identified by a URL.
+
         URL で識別されるリソースからコンテンツを取り出す
 
     :mod:`urllib2`
+        .. Alternative API for accessing remote URLs.
+
         リモート URL アクセスの代替 API