pytho****@googl*****
pytho****@googl*****
2011年 3月 27日 (日) 02:01:45 JST
3 new revisions: Revision: 432bd7688a99 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:56:32 2011 Log: 原文を追加更新: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=432bd7688a99 Revision: 6909e5fd1187 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:57:09 2011 Log: 2.6.6: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=6909e5fd1187 Revision: 19ebd9702fde Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:59:10 2011 Log: 翻訳見直し: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=19ebd9702fde ============================================================================== Revision: 432bd7688a99 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:56:32 2011 Log: 原文を追加更新: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=432bd7688a99 Modified: /library/tarfile.rst /library/zlib.rst ======================================= --- /library/tarfile.rst Sun Mar 20 19:52:28 2011 +++ /library/tarfile.rst Sat Mar 26 09:56:32 2011 @@ -9,39 +9,96 @@ .. versionadded:: 2.3 -.. moduleauthor:: Lars Gustabel <lars****@gusta*****> -.. sectionauthor:: Lars Gustabel <lars****@gusta*****> +.. moduleauthor:: Lars Gustäbel <lars****@gusta*****> +.. sectionauthor:: Lars Gustäbel <lars****@gusta*****> +.. The :mod:`tarfile` module makes it possible to read and write tar +.. archives, including those using gzip or bz2 compression. +.. (:file:`.zip` files can be read and written using the :mod:`zipfile` module.) + :mod:`tarfile` モジュールは、gzipやbz2圧縮されたものも含めて、tarアーカイブ の読み書きができます。 (:file:`.zip` ファイルの読み書きは :mod:`zipfile` モジュールで可能です。) + +.. Some facts and figures: + いくつかの事実と外観： + +.. * reads and writes :mod:`gzip` and :mod:`bz2` compressed archives. + * :mod:`gzip` と :mod:`bz2` で圧縮されたアーカイブを読み書きします。 + +.. * read/write support for the POSIX.1-1988 (ustar) format. + * POSIX.1-1988 (ustar) フォーマットの読み書きをサポートしています。 + +.. * read/write support for the GNU tar format including *longname* and *longlink* +.. extensions, read-only support for the *sparse* extension. + * *longname*, *longlink* 拡張を含めた、GNU tarフォーマットの読み書きをサ ポートしています。 *sparse* 拡張は読み込みのみサポートしています。 + +.. * read/write support for the POSIX.1-2001 (pax) format. + * POSIX.1-2001 (pax) フォーマットの読み書きをサポートしています。 .. versionadded:: 2.6 + +.. * handles directories, regular files, hardlinks, symbolic links, fifos, +.. character devices and block devices and is able to acquire and restore file +.. information like timestamp, access permissions and owner. + * ディレクトリ、普通のファイル、ハードリンク、シンボリックリンク、fifo、キ ャラクタデバイスおよびブロックデバイスを処理します。また、タイムスタンプ、 アクセス許可およびオーナーのようなファイル情報の取得および保存が可能で す。 .. function:: open(name=None, mode='r', fileobj=None, bufsize=10240, \*\*kwargs) + .. Return a :class:`TarFile` object for the pathname *name*. For detailed + .. information on :class:`TarFile` objects and the keyword arguments that are + .. allowed, see :ref:`tarfile-objects`. + パス名 *name* の :class:`TarFile` オブジェクトを返します。 :class:`TarFile` オブジェクトと、利用出来るキーワード引数に関する詳細な 情報については、 :ref:`tarfile-objects` 節を参照してください。 + + .. *mode* has to be a string of the form ``'filemode[:compression]'``, it defaults + .. to ``'r'``. Here is a full list of mode combinations: + *mode* は ``'filemode[:compression]'`` の形式をとる文字列でなければなり ません。デフォルトの値は ``'r'`` です。以下に *mode* のとりうる組み合わせ全てを示します。 + + .. +------------------+---------------------------------------------+ + .. | mode | action | + .. +==================+=============================================+ + .. | ``'r' or 'r:*'`` | Open for reading with transparent | + .. | | compression (recommended). | + .. +------------------+---------------------------------------------+ + .. | ``'r:'`` | Open for reading exclusively without | + .. | | compression. | + .. +------------------+---------------------------------------------+ + .. | ``'r:gz'`` | Open for reading with gzip compression. | + .. +------------------+---------------------------------------------+ + .. | ``'r:bz2'`` | Open for reading with bzip2 compression. | + .. +------------------+---------------------------------------------+ + .. | ``'a' or 'a:'`` | Open for appending with no compression. The | + .. | | file is created if it does not exist. | + .. +------------------+---------------------------------------------+ + .. | ``'w' or 'w:'`` | Open for uncompressed writing. | + .. +------------------+---------------------------------------------+ + .. | ``'w:gz'`` | Open for gzip compressed writing. | + .. +------------------+---------------------------------------------+ + .. | ``'w:bz2'`` | Open for bzip2 compressed writing. | + .. +------------------+---------------------------------------------+ + +----------------------+-----------------------------------------------------------------+ | mode | 動 作 | +======================+=================================================================+ @@ -63,13 +120,35 @@ | ``'w:bz2'`` | bzip2 圧縮で書き込むためにオープンしま す。 | +----------------------+-----------------------------------------------------------------+ + + .. Note that ``'a:gz'`` or ``'a:bz2'`` is not possible. If *mode* is not suitable + .. to open a certain (compressed) file for reading, :exc:`ReadError` is raised. Use + .. *mode* ``'r'`` to avoid this. If a compression method is not supported, + .. :exc:`CompressionError` is raised. + ``'a:gz'`` あるいは ``'a:bz2'`` は可能ではないことに注意して下さい。もし *mode* が、ある(圧縮した)ファイルを読み込み用にオープンするのに、適して いないなら、 :exc:`ReadError` が発生します。これを防ぐには *mode* ``'r'`` を使って下さい。もし圧縮メソッドがサポートされていなけれ ば、 :exc:`CompressionError` が発生します。 + + .. If *fileobj* is specified, it is used as an alternative to a file object opened + .. for *name*. It is supposed to be at position 0. + もし *fileobj* が指定されていれば、それは *name* でオープンされたファイ ルオブジェクトの代替として使うことができます。 そのファイルオブジェクトの、ファイルポジションが0であることを前提に動作 します。 + + .. For special purposes, there is a second format for *mode*: + .. ``'filemode|[compression]'``. :func:`tarfile.open` will return a :class:`TarFile` + .. object that processes its data as a stream of blocks. No random seeking will + .. be done on the file. If given, *fileobj* may be any object that has a + .. :meth:`read` or :meth:`write` method (depending on the *mode*). *bufsize* + .. specifies the blocksize and defaults to ``20 * 512`` bytes. Use this variant + .. in combination with e.g. ``sys.stdin``, a socket file object or a tape + .. device. However, such a :class:`TarFile` object is limited in that it does + .. not allow to be accessed randomly, see :ref:`tar-examples`. The currently + .. possible modes: + 特別な目的のために、 *mode* の2番目の形式: ``'ファイルモード|[圧縮]'`` があります。この形式を使うと、 :func:`tarfile.open` が返すのはデータをブロックからなるストリームとして 扱う :class:`TarFile` オブジェクトになります。この場合、ファイルに対して ランダムな seek を行えなくなります。 *fileobj* を指定する場合、 ``read()`` および ``write()`` @@ -78,6 +157,31 @@ 使ってください。ただし、このような :class:`TarFile` オブジェクトにはラン ダムアクセスを行えないという制限があります。 :ref:`tar-examples` 節を参照してください。現在可能なモードは： + + .. +-------------+--------------------------------------------+ + .. | Mode | Action | + .. +=============+============================================+ + .. | ``'r|*'`` | Open a *stream* of tar blocks for reading | + .. | | with transparent compression. | + .. +-------------+--------------------------------------------+ + .. | ``'r|'`` | Open a *stream* of uncompressed tar blocks | + .. | | for reading. | + .. +-------------+--------------------------------------------+ + .. | ``'r|gz'`` | Open a gzip compressed *stream* for | + .. | | reading. | + .. +-------------+--------------------------------------------+ + .. | ``'r|bz2'`` | Open a bzip2 compressed *stream* for | + .. | | reading. | + .. +-------------+--------------------------------------------+ + .. | ``'w|'`` | Open an uncompressed *stream* for writing. | + .. +-------------+--------------------------------------------+ + .. | ``'w|gz'`` | Open an gzip compressed *stream* for | + .. | | writing. | + .. +-------------+--------------------------------------------+ + .. | ``'w|bz2'`` | Open an bzip2 compressed *stream* for | + .. | | writing. | + .. +-------------+--------------------------------------------+ + +-------------+-----------------------------------------------------------------+ | モード | 動 作 | +=============+=================================================================+ @@ -99,56 +203,88 @@ .. class:: TarFile + .. Class for reading and writing tar archives. Do not use this class directly, + .. better use :func:`tarfile.open` instead. See :ref:`tarfile-objects`. + tar アーカイブを読んだり、書いたりするためのクラスです。このクラスを直接 使わず、代わりに :func:`tarfile.open` を使ってください。 :ref:`tarfile-objects` を参照してください。 .. function:: is_tarfile(name) + .. Return :const:`True` if *name* is a tar archive file, that the :mod:`tarfile` + .. module can read. + もし *name* が tar アーカイブファイルであり、 :mod:`tarfile` モジュール で読み出せる場合に :const:`True` を返します。 .. class:: TarFileCompat(filename, mode='r', compression=TAR_PLAIN) + .. Class for limited access to tar archives with a :mod:`zipfile`\ -like interface. + .. Please consult the documentation of the :mod:`zipfile` module for more details. + .. *compression* must be one of the following constants: + ``zipfile`` \ -風なインターフェースを持つ tar アーカイブへの制限されたア クセスのためのクラスです。詳細は ``zipfile`` のドキュメントを参照してください。 *compression* は、以下の 定数のどれかでなければなりません： .. data:: TAR_PLAIN + .. Constant for an uncompressed tar archive. + 非圧縮 tar アーカイブのための定数。 .. data:: TAR_GZIPPED + .. Constant for a :mod:`gzip` compressed tar archive. + :mod:`gzip` 圧縮 tar アーカイブのための定数。 + + .. .. deprecated:: 2.6 + .. The :class:`TarFileCompat` class has been deprecated for removal in Python 3.0. + .. deprecated:: 2.6 :class:`TarFileCompat` クラスは、 Python 3.0 で削除されるので、非推奨 になりました。 .. exception:: TarError + .. Base class for all :mod:`tarfile` exceptions. + すべての :mod:`tarfile` 例外のための基本クラスです。 .. exception:: ReadError + .. Is raised when a tar archive is opened, that either cannot be handled by the + .. :mod:`tarfile` module or is somehow invalid. + tar アーカイブがオープンされた時、 :mod:`tarfile` モジュールで操作できな いか、あるいは何か無効であるとき発生します。 .. exception:: CompressionError + .. Is raised when a compression method is not supported or when the data cannot be + .. decoded properly. + 圧縮方法がサポートされていないか、あるいはデータを正しくデコードできない 時に発生します。 .. exception:: StreamError + .. Is raised for the limitations that are typical for stream-like :class:`TarFile` + .. objects. + ストリーム風の :class:`TarFile` オブジェクトで典型的な制限のために発生し ます。 .. exception:: ExtractError + .. Is raised for *non-fatal* errors when using :meth:`TarFile.extract`, but only if + .. :attr:`TarFile.errorlevel`\ ``== 2``. + :meth:`TarFile.extract` を使った時、もし :attr:`TarFile.errorlevel`\ ``== 2`` の *フェータルでない* エラーに対してだけ発生します。 @@ -163,8 +299,8 @@ .. Each of the following constants defines a tar archive format that the - :mod:`tarfile` module is able to create. See section :ref:`tar-formats` for - details. +.. :mod:`tarfile` module is able to create. See section :ref:`tar-formats` for +.. details. 以下の各定数は、 :mod:`tarfile` モジュールが作成できるtarアーカイブフォーマ ットを定義しています。 詳細は、 :ref:`tar-formats` を参照してください。 @@ -172,16 +308,22 @@ .. data:: USTAR_FORMAT + .. POSIX.1-1988 (ustar) format. + POSIX.1-1988 (ustar) フォーマット .. data:: GNU_FORMAT + .. GNU tar format. + GNU tar フォーマット .. data:: PAX_FORMAT + .. POSIX.1-2001 (pax) format. + POSIX.1-2001 (pax) フォーマット @@ -201,7 +343,7 @@ .. data:: ENCODING .. The default character encoding i.e. the value from either - :func:`sys.getfilesystemencoding` or :func:`sys.getdefaultencoding`. + .. :func:`sys.getfilesystemencoding` or :func:`sys.getdefaultencoding`. デフォルト文字エンコーディング。 :func:`sys.getfilesystemencoding` か :func:`sys.getdefaultencoding` @@ -210,9 +352,16 @@ .. seealso:: + .. Module :mod:`zipfile` + .. Documentation of the :mod:`zipfile` standard module. + Module :mod:`zipfile` :mod:`zipfile` 標準モジュールのドキュメント。 + + .. `GNU tar manual, Basic Tar Format <http://www.gnu.org/software/tar/manual/html_node/Standard.html>`_ + .. Documentation for tar archive files, including GNU tar extensions. + `GNU tar マニュアル, 基本 Tar 形式 <http://www.gnu.org/software/tar/manual/html_node/Standard.html>`_ GNU tar 拡張機能を含む、 tar アーカイブファイルのためのドキュメント。 @@ -222,6 +371,12 @@ TarFile オブジェクト -------------------- +.. The :class:`TarFile` object provides an interface to a tar archive. A tar +.. archive is a sequence of blocks. An archive member (a stored file) is made up of +.. a header block followed by data blocks. It is possible to store a file in a tar +.. archive several times. Each archive member is represented by a :class:`TarInfo` +.. object, see :ref:`tarinfo-objects` for details. + :class:`TarFile` オブジェクトは、tar アーカイブへのインターフェースを提供し ます。 tar アーカイブは一連のブロックです。アーカイブメンバー(保存されたファイル)は、 ヘッダーブロックとそれに続くデータブロックから構成されています。ある tar アーカイブにファイルを何回も保存することができます。各アーカイブメンバー は、 :class:`TarInfo` @@ -230,34 +385,48 @@ .. class:: TarFile(name=None, mode='r', fileobj=None, format=DEFAULT_FORMAT, tarinfo=TarInfo, dereference=False, ignore_zeros=False, encoding=ENCODING, errors=None, pax_headers=None, debug=0, errorlevel=0) + .. All following arguments are optional and can be accessed as instance attributes + .. as well. + 以下の全ての引数はオプションで、インスタンス属性としてもアクセスすること ができます。 + .. *name* is the pathname of the archive. It can be omitted if *fileobj* is given. - In this case, the file object's :attr:`name` attribute is used if it exists. + .. In this case, the file object's :attr:`name` attribute is used if it exists. *name* はアーカイブのパス名。 *fileobj* が渡された場合は省略可能。 その場合、ファイルオブジェクトの :attr:`name` 属性があれば、それを利用し ます。 + .. *mode* is either ``'r'`` to read from an existing archive, ``'a'`` to append - data to an existing file or ``'w'`` to create a new file overwriting an existing - one. + .. data to an existing file or ``'w'`` to create a new file overwriting an existing + .. one. *mode* は、既存のアーカイブファールから読み込むための ``'r'``, 既存のアーカイブファイルに追記するための ``'a'``, 既存のファイルがあれば上書きし、新しいファイルを作成する ``'w'`` のいずれかです。 + + .. If *fileobj* is given, it is used for reading or writing data. If it can be + .. determined, *mode* is overridden by *fileobj*'s mode. *fileobj* will be used + .. from position 0. + もし *fileobj* が与えられていれば、それを使ってデータを読み書きします。 もしそれが決定できれば、 *mode* は *fileobj* のモードで上書きされます。 *fileobj* はポジション0から利用されます。 + .. note:: + .. *fileobj* is not closed, when :class:`TarFile` is closed. + *fileobj* は、 :class:`TarFile` をクローズする時にクローズされませ ん。 + .. *format* controls the archive format. It must be one of the constants - :const:`USTAR_FORMAT`, :const:`GNU_FORMAT` or :const:`PAX_FORMAT` that are - defined at module level. + .. :const:`USTAR_FORMAT`, :const:`GNU_FORMAT` or :const:`PAX_FORMAT` that are + .. defined at module level. *format* はアーカイブのフォーマットを制御します。 モジュールレベルで定義されてい る、 :const:`USTAR_FORMAT`, :const:`GNU_FORMAT`, :const:`PAX_FORMAT` @@ -265,52 +434,59 @@ .. versionadded:: 2.6 + .. The *tarinfo* argument can be used to replace the default :class:`TarInfo` class - with a different one. + .. with a different one. *tarinfo* 引数を利用して、デフォルトの :class:`TarInfo` クラスを別のクラ スで置き換えられます。 + .. versionadded:: 2.6 .. If *dereference* is :const:`False`, add symbolic and hard links to the archive. If it - is :const:`True`, add the content of the target files to the archive. This has no - effect on systems that do not support symbolic links. + .. is :const:`True`, add the content of the target files to the archive. This has no + .. effect on systems that do not support symbolic links. *dereference* が :const:`False` だった場合、シンボリックリンクやハードリ ンクがアーカイブに追加されます。 :const:`True` だった場合、リンクのターゲットとなるファイルの内容がアーカ イブに追加されます。 シンボリックリンクをサポートしていないシステムでは効果がありません。 + .. todo:: 訳者note: ハードリンクにまで対応している？原文が間違っている可能性が あるので要確認。 + .. If *ignore_zeros* is :const:`False`, treat an empty block as the end of the archive. - If it is :const:`True`, skip empty (and invalid) blocks and try to get as many members - as possible. This is only useful for reading concatenated or damaged archives. + .. If it is :const:`True`, skip empty (and invalid) blocks and try to get as many members + .. as possible. This is only useful for reading concatenated or damaged archives. *ignore_zeros* が :const:`False` だった場合、空ブロックをアーカイブの終 端だと扱います。 :const:`True` だった場合、空の(無効な)ブロックをスキップして、可能な限り 多くのメンバを取得しようとします。 このオプションは、連結(concatenate)されたり、壊れたアーカイブファイルを 扱うときにのみ、意味があります。 + .. *debug* can be set from ``0`` (no debug messages) up to ``3`` (all debug - messages). The messages are written to ``sys.stderr``. + .. messages). The messages are written to ``sys.stderr``. *debug* は ``0`` (デバッグメッセージ無し)から ``3`` (全デバッグメッセー ジ) まで設定できます。このメッセージは ``sys.stderr`` に書き込まれます。 + .. If *errorlevel* is ``0``, all errors are ignored when using :meth:`TarFile.extract`. - Nevertheless, they appear as error messages in the debug output, when debugging - is enabled. If ``1``, all *fatal* errors are raised as :exc:`OSError` or - :exc:`IOError` exceptions. If ``2``, all *non-fatal* errors are raised as - :exc:`TarError` exceptions as well. + .. Nevertheless, they appear as error messages in the debug output, when debugging + .. is enabled. If ``1``, all *fatal* errors are raised as :exc:`OSError` or + .. :exc:`IOError` exceptions. If ``2``, all *non-fatal* errors are raised as + .. :exc:`TarError` exceptions as well. *errorlevel* が ``0`` の場合、 :meth:`TarFile.extract` 使用時に全てのエ ラーが無視されます。 エラーが無視された場合でも、 *debug* が有効であれば、エラーメッセージは 出力されます。 ``1`` の場合、全ての *致命的な(fatal)* エラーは :exc:`OSError` か :exc:`IOError` を送出します。 ``2`` の場合、全ての *致命的でない(non-fatal)* エラーも :exc:`TarError` 例外として送出されます。 + .. The *encoding* and *errors* arguments control the way strings are converted to - unicode objects and vice versa. The default settings will work for most users. - See section :ref:`tar-unicode` for in-depth information. + .. unicode objects and vice versa. The default settings will work for most users. + .. See section :ref:`tar-unicode` for in-depth information. *encoding* と *errors* 引数は、文字列と unicode オブジェクトとの間の相互 変換方法を指定します。 デフォルトの設定で、ほとんどのユーザーでうまく動作するでしょう。 @@ -318,6 +494,7 @@ .. versionadded:: 2.6 + .. The *pax_headers* argument is an optional dictionary of unicode strings which will be added as a pax global header if *format* is :const:`PAX_FORMAT`. @@ -329,44 +506,76 @@ .. method:: TarFile.open(...) + .. Alternative constructor. The :func:`tarfile.open` function is actually a + .. shortcut to this classmethod. + 代替コンストラクタです。モジュールレベルでの :func:`tarfile.open` 関数は、実際はこのクラスメソッドへのショートカットです。 .. method:: TarFile.getmember(name) + .. Return a :class:`TarInfo` object for member *name*. If *name* can not be found + .. in the archive, :exc:`KeyError` is raised. + メンバー *name* に対する :class:`TarInfo` オブジェクトを返します。もし *name* がアーカイブに見つからなければ、 :exc:`KeyError` が発生します。 + .. note:: + .. If a member occurs more than once in the archive, its last occurrence is assumed + .. to be the most up-to-date version. + もしメンバーがアーカイブに1つ以上あれば、その最後に出現するものが、最 新のバージョンであるとみなされます。 .. method:: TarFile.getmembers() + .. Return the members of the archive as a list of :class:`TarInfo` objects. The + .. list has the same order as the members in the archive. + :class:`TarInfo` オブジェクトのリストとしてアーカイブのメンバーを返しま す。このリストはアーカイブ内のメンバーと同じ順番です。 .. method:: TarFile.getnames() + .. Return the members as a list of their names. It has the same order as the list + .. returned by :meth:`getmembers`. + メンバーをその名前のリストとして返します。これは :meth:`getmembers` で返 されるリストと同じ順番です。 .. method:: TarFile.list(verbose=True) + .. Print a table of contents to ``sys.stdout``. If *verbose* is :const:`False`, + .. only the names of the members are printed. If it is :const:`True`, output + .. similar to that of :program:`ls -l` is produced. + コンテンツの表を ``sys.stdout`` に印刷します。もし *verbose* が :const:`False` であれば、メンバー名のみ印刷します。もしそれが :const:`True` であれば、 ``"ls -l"`` に似た出力を生成します。 .. method:: TarFile.next() + .. Return the next member of the archive as a :class:`TarInfo` object, when + .. :class:`TarFile` is opened for reading. Return :const:`None` if there is no more + .. available. + :class:`TarFile` が読み込み用にオープンされている時、アーカイブの次のメ ンバーを :class:`TarInfo` オブジェクトとして返します。もしそれ以上利用可能なもの がなければ、 :const:`None` を返します。 .. method:: TarFile.extractall(path=".", members=None) + .. Extract all members from the archive to the current working directory or + .. directory *path*. If optional *members* is given, it must be a subset of the + .. list returned by :meth:`getmembers`. Directory information like owner, + .. modification time and permissions are set after all members have been extracted. + .. This is done to work around two problems: A directory's modification time is + .. reset each time a file is created in it. And, if a directory's permissions do + .. not allow writing, extracting files to it will fail. + 全てのメンバーをアーカイブから現在の作業ディレクトリーまたは *path* に抽 出します。オプションの *members* が与えられるときには、 :meth:`getmembers` で返されるリストの一部でなければなりません。 所有者、変更時刻、許可のようなディレクトリー情報は全てのメンバーが抽出さ れた後にセットされます。これは二つの問題を回避するためです。一つはディレクト リー @@ -376,76 +585,120 @@ .. warning:: .. Never extract archives from untrusted sources without prior inspection. - It is possible that files are created outside of *path*, e.g. members - that have absolute filenames starting with ``"/"`` or filenames with two - dots ``".."``. + .. It is possible that files are created outside of *path*, e.g. members + .. that have absolute filenames starting with ``"/"`` or filenames with two + .. dots ``".."``. 内容を信頼できないtarアーカイブを、事前の内部チェック前に展開してはい けません。 ファイルが *path* の外側に作られる可能性があります。 例えば、 ``"/"`` で始まる絶対パスのファイル名や、2重ドット ``".."`` で始まるパスのファイル名です。 + .. versionadded:: 2.5 .. method:: TarFile.extract(member, path="") + .. Extract a member from the archive to the current working directory, using its + .. full name. Its file information is extracted as accurately as possible. *member* + .. may be a filename or a :class:`TarInfo` object. You can specify a different + .. directory using *path*. + メンバーをアーカイブから現在の作業ディレクトリに、そのフル名を使って、抽 出します。そのファイル情報はできるだけ正確に抽出されます。 *member* は、ファイル名でも :class:`TarInfo` オブジェクトでも構いませ ん。 *path* を使って、異なるディレクトリを指定することができます。 + .. note:: .. The :meth:`extract` method does not take care of several extraction issues. - In most cases you should consider using the :meth:`extractall` method. + .. In most cases you should consider using the :meth:`extractall` method. :meth:`extract` メソッドは幾つかの展開に関する問題を扱いません。 殆どの場合、 :meth:`extractall` メソッドの利用を考慮するべきです。 + .. warning:: + .. See the warning for :meth:`extractall`. + :meth:`extractall` の警告(warning)を参照 .. method:: TarFile.extractfile(member) + .. Extract a member from the archive as a file object. *member* may be a filename + .. or a :class:`TarInfo` object. If *member* is a regular file, a file-like object + .. is returned. If *member* is a link, a file-like object is constructed from the + .. link's target. If *member* is none of the above, :const:`None` is returned. + アーカイブからメンバーをオブジェクトとして抽出します。 *member* は、ファ イル名あるいは :class:`TarInfo` オブジェクトです。もし *member* が普通のファイルであれば、ファイル風のオブジェクトを返します。 もし *member* がリンクであれば、ファイル風のオブジェクトをリンクのターゲット から構成します。もし *member* が上のどれでもなければ、 :const:``None`` が返されます。 + .. note:: + .. The file-like object is read-only and provides the following methods: + .. :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`. + ファイル風のオブジェクトは読み出し専用で以下のメソッドを提供しま す： :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`. .. method:: TarFile.add(name, arcname=None, recursive=True, exclude=None) + .. Add the file *name* to the archive. *name* may be any type of file (directory, + .. fifo, symbolic link, etc.). If given, *arcname* specifies an alternative name + .. for the file in the archive. Directories are added recursively by default. This + .. can be avoided by setting *recursive* to :const:`False`. If *exclude* is given + .. it must be a function that takes one filename argument and returns a boolean + .. value. Depending on this value the respective file is either excluded + .. (:const:`True`) or added (:const:`False`). + ファイル *name* をアーカイブに追加します。 *name* は、任意のファイルタイ プ (ディレクトリ、fifo、シンボリックリンク等)です。 もし *arcname* が与えられていれば、それはアーカイブ内のファイルの代替名 を指定します。デフォールトではディレクトリは再帰的に追加されます。 これは、 *recursive* を :const:`False` に設定することで避けることができ ます。 *exclude* を指定する場合、それは1つのファイル名を引数にとって、ブール値 を返す関数である必要があります。 この関数の戻り値が :const:`True` の場合、そのファイルが除外されま す。 :const:`False` の場合、そのファイルは追加されます。 + + .. .. versionchanged:: 2.6 + .. Added the *exclude* parameter. + .. versionchanged:: 2.6 *exclude* 引数が追加されました。 .. method:: TarFile.addfile(tarinfo, fileobj=None) + .. Add the :class:`TarInfo` object *tarinfo* to the archive. If *fileobj* is given, + .. ``tarinfo.size`` bytes are read from it and added to the archive. You can + .. create :class:`TarInfo` objects using :meth:`gettarinfo`. + :class:`TarInfo` オブジェクト *tarinfo* をアーカイブに追加します。もし *fileobj* が与えられていれば、 ``tarinfo.size`` バイトがそれから読まれ、アーカイ ブに追加されます。 :meth:`gettarinfo` を使って :class:`TarInfo` オブジェクトを作成することができます。 + .. note:: + .. On Windows platforms, *fileobj* should always be opened with mode ``'rb'`` to + .. avoid irritation about the file size. + Windows プラットフォームでは、 *fileobj* は、ファイルサイズに関する問 題を避けるために、常に、モード ``'rb'`` でオープンされるべきです。 .. method:: TarFile.gettarinfo(name=None, arcname=None, fileobj=None) + .. Create a :class:`TarInfo` object for either the file *name* or the file object + .. *fileobj* (using :func:`os.fstat` on its file descriptor). You can modify some + .. of the :class:`TarInfo`'s attributes before you add it using :meth:`addfile`. + .. If given, *arcname* specifies an alternative name for the file in the archive. + :class:`TarInfo` オブジェクトをファイル *name* あるいは (そのファイル記 述子に ``os.fstat()`` を使って) ファイルオブジェクト *fileobj* のどちらか用に作成しま す。 :class:`TarInfo` の属性のいくつかは、 :meth:`addfile` を使って追加する前に修正することができます。 *arcname* がもし与えられていれば、アーカイブ内のファイルの @@ -454,23 +707,33 @@ .. method:: TarFile.close() + .. Close the :class:`TarFile`. In write mode, two finishing zero blocks are + .. appended to the archive. + :class:`TarFile` をクローズします。書き出しモードでは、完了ゼロブロック が 2つ、アーカイブに追加されます。 .. attribute:: TarFile.posix .. Setting this to :const:`True` is equivalent to setting the :attr:`format` - attribute to :const:`USTAR_FORMAT`, :const:`False` is equivalent to - :const:`GNU_FORMAT`. + .. attribute to :const:`USTAR_FORMAT`, :const:`False` is equivalent to + .. :const:`GNU_FORMAT`. この値を :const:`True` にすることは、 :attr:`format` を :const:`USTAR_FORMAT` にすることと同じです。 この値を :const:`False` にすることは、 :attr:`format` を :const:`GNU_FORMAT` にすることと同じです。 + + .. .. versionchanged:: 2.4 + .. *posix* defaults to :const:`False`. + .. versionchanged:: 2.4 *posix* のデフォルト値が :const:`False` になりました. + + .. .. deprecated:: 2.6 + .. Use the :attr:`format` attribute instead. + .. deprecated:: 2.6 - .. Use the :attr:`format` attribute instead. 代わりに :attr:`format` 属性を利用してください。 @@ -482,31 +745,50 @@ .. versionadded:: 2.6 + .. _tarinfo-objects: TarInfo オブジェクト -------------------- +.. A :class:`TarInfo` object represents one member in a :class:`TarFile`. Aside +.. from storing all required attributes of a file (like file type, size, time, +.. permissions, owner etc.), it provides some useful methods to determine its type. +.. It does *not* contain the file's data itself. + :class:`TarInfo` オブジェクトは :class:`TarFile` の一つのメンバーを表しま す。ファイルに 必要な(ファイルタイプ、ファイルサイズ、時刻、許可、所有者等のような)すべて の属性を保存する他に、 そのタイプを決定するのに役に立ついくつかのメソッドを提供します。これにはフ ァイルのデータそのものは含まれま *せん* 。 + +.. :class:`TarInfo` objects are returned by :class:`TarFile`'s methods +.. :meth:`getmember`, :meth:`getmembers` and :meth:`gettarinfo`. + :class:`TarInfo` オブジェクトは ``TarFile`` のメソッド ``getmember()`` 、 ``getmembers()`` および ``gettarinfo()`` によって返されます。 .. class:: TarInfo(name="") + .. Create a :class:`TarInfo` object. + :class:`TarInfo` オブジェクトを作成します。 .. method:: TarInfo.frombuf(buf) + .. Create and return a :class:`TarInfo` object from string buffer *buf*. + :class:`TarInfo` オブジェクトを文字列バッファ *buf* から作成して返しま す。 + + .. .. versionadded:: 2.6 + .. Raises :exc:`HeaderError` if the buffer is invalid.. + .. versionadded:: 2.6 バッファが不正な場合は、 :exc:`HeaderError` を送出します。 + .. method:: TarInfo.fromtarfile(tarfile) .. Read the next member from the :class:`TarFile` object *tarfile* and return it as @@ -517,6 +799,7 @@ .. versionadded:: 2.6 + .. method:: TarInfo.tobuf(format=DEFAULT_FORMAT, encoding=ENCODING, errors='strict') .. Create a string buffer from a :class:`TarInfo` object. For information on the @@ -525,35 +808,55 @@ :class:`TarInfo` オブジェクトから文字列バッファを作成します。 引数についての情報は、 :class:`TarFile` クラスのコンストラクタを参照して ください。 + + .. .. versionchanged:: 2.6 + .. The arguments were added. + .. versionchanged:: 2.6 引数が追加されました。 +.. A ``TarInfo`` object has the following public data attributes: + ``TarInfo`` オブジェクトには以下の public なデータ属性があります： .. attribute:: TarInfo.name + .. Name of the archive member. + アーカイブメンバーの名前。 .. attribute:: TarInfo.size + .. Size in bytes. + バイト単位でのサイズ。 .. attribute:: TarInfo.mtime + .. Time of last modification. + 最終更新時刻。 .. attribute:: TarInfo.mode + .. Permission bits. + 許可ビット。 .. attribute:: TarInfo.type + .. File type. *type* is usually one of these constants: :const:`REGTYPE`, + .. :const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, + .. :const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, + .. :const:`GNUTYPE_SPARSE`. To determine the type of a :class:`TarInfo` object + .. more conveniently, use the ``is_*()`` methods below. + ファイルタイプです。 *type* は普通、以下の定 数: :const:`REGTYPE`, :const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :const:`GNUTYPE_SPARSE` @@ -562,29 +865,41 @@ .. attribute:: TarInfo.linkname + .. Name of the target file name, which is only present in :class:`TarInfo` objects + .. of type :const:`LNKTYPE` and :const:`SYMTYPE`. + ターゲットファイル名の名前で、これはタイプ :const:`LNKTYPE` と :const:`SYMTYPE` の :class:`TarInfo` オブジェクトにだけ存在します。 .. attribute:: TarInfo.uid + .. User ID of the user who originally stored this member. + ファイルメンバを保存した元のユーザのユーザ ID です。 .. attribute:: TarInfo.gid + .. Group ID of the user who originally stored this member. + ファイルメンバを保存した元のユーザのグループ ID です。 .. attribute:: TarInfo.uname + .. User name. + ファイルメンバを保存した元のユーザのユーザ名です。 .. attribute:: TarInfo.gname + .. Group name. + ファイルメンバを保存した元のユーザのグループ名です。 + .. attribute:: TarInfo.pax_headers .. A dictionary containing key-value pairs of an associated pax extended header. @@ -594,51 +909,71 @@ .. versionadded:: 2.6 +.. A :class:`TarInfo` object also provides some convenient query methods: + :class:`TarInfo` オブジェクトは便利な照会用のメソッドもいくつか提供していま す: .. method:: TarInfo.isfile() + .. Return :const:`True` if the :class:`Tarinfo` object is a regular file. + :class:`Tarinfo` オブジェクトが普通のファイルの場合に、 :const:`True` を 返します。 .. method:: TarInfo.isreg() + .. Same as :meth:`isfile`. + :meth:`isfile` と同じです。 .. method:: TarInfo.isdir() + .. Return :const:`True` if it is a directory. + ディレクトリの場合に :const:`True` を返します。 .. method:: TarInfo.issym() + .. Return :const:`True` if it is a symbolic link. + シンボリックリンクの場合に :const:`True` を返します。 .. method:: TarInfo.islnk() + .. Return :const:`True` if it is a hard link. + ハードリンクの場合に :const:`True` を返します。 .. method:: TarInfo.ischr() + .. Return :const:`True` if it is a character device. + キャラクタデバイスの場合に :const:`True` を返します。 .. method:: TarInfo.isblk() + .. Return :const:`True` if it is a block device. + ブロックデバイスの場合に :const:`True` を返します。 .. method:: TarInfo.isfifo() + .. Return :const:`True` if it is a FIFO. + FIFO の場合に :const:`True` を返します。 .. method:: TarInfo.isdev() + .. Return :const:`True` if it is one of character device, block device or FIFO. + キャラクタデバイス、ブロックデバイスあるいは FIFOのいずれかの場合 に :const:`True` を返します。 @@ -647,18 +982,28 @@ 例 -- -tar アーカイブから現在のディレクトリーに全て抽出する方法:: + +.. How to extract an entire tar archive to the current working directory: + +tar アーカイブから現在のディレクトリーに全て抽出する方法 + + +:: import tarfile tar = tarfile.open("sample.tar.gz") tar.extractall() tar.close() + .. How to extract a subset of a tar archive with :meth:`TarFile.extractall` using - a generator function instead of a list:: +.. a generator function instead of a list: tarアーカイブの一部を、リストの代わりにジェネレータ関数を利用して、 -:meth:`TarFile.extractall` で展開する方法:: +:meth:`TarFile.extractall` で展開する方法 + + +:: import os import tarfile @@ -672,7 +1017,13 @@ tar.extractall(members=py_files(tar)) tar.close() -非圧縮 tar アーカイブをファイル名のリストから作成する方法:: + +.. How to create an uncompressed tar archive from a list of filenames: + +非圧縮 tar アーカイブをファイル名のリストから作成する方法 + + +:: import tarfile tar = tarfile.open("sample.tar", "w") @@ -680,7 +1031,13 @@ tar.add(name) tar.close() -gzip 圧縮 tar アーカイブを作成してメンバー情報のいくつかを表示する方 法： :: + +.. How to read a gzip compressed tar archive and display some member information: + +gzip 圧縮 tar アーカイブを作成してメンバー情報のいくつかを表示する方法 + + +:: import tarfile tar = tarfile.open("sample.tar.gz", "r:gz") @@ -694,30 +1051,31 @@ print "ファイル・ディレクトリ以外のものです。" tar.close() -.. Supported tar formats ***The diff for this file has been truncated for email.*** ======================================= --- /library/zlib.rst Sat May 8 08:27:47 2010 +++ /library/zlib.rst Sat Mar 26 09:56:32 2011 @@ -6,33 +6,61 @@ :synopsis: gzip 互換の圧縮／解凍ルーチンへの低レベルインタフェース +.. For applications that require data compression, the functions in this module +.. allow compression and decompression, using the zlib library. The zlib library +.. has its own home page at http://www.zlib.net. There are known +.. incompatibilities between the Python module and versions of the zlib library +.. earlier than 1.1.3; 1.1.3 has a security vulnerability, so we recommend using +.. 1.1.4 or later. + このモジュールでは、データ圧縮を必要とするアプリケーションが zlib ライブラ リを使って圧縮および解凍を行えるようにします。 zlib ライブラリ自体の Webページは http://www.zlib.net です。 Pythonモジュールと zlib ライブラリの1.1.3より前のバージョンには互換性のない部分があることが知られて います。1.1.3にはセキュリティホールが存 在しますので、1.1.4以降のバージョンを利用することをお勧めします。 + +.. zlib's functions have many options and often need to be used in a particular +.. order. This documentation doesn't attempt to cover all of the permutations; +.. consult the zlib manual at http://www.zlib.net/manual.html for authoritative +.. information. + zlib の関数にはたくさんのオプションがあり、しばしば特定の順番で使う必要があ ります。 このドキュメントでは順番のことについて全てを説明し尽くそうとはしていませ ん。信頼できる情報が必要ならば http://www.zlib.net/manual.html にある zlib のマニュアルを参照するようにし てください。 + .. For reading and writing ``.gz`` files see the :mod:`gzip` module. For - other archive formats, see the :mod:`bz2`, :mod:`zipfile`, and - :mod:`tarfile` modules. +.. other archive formats, see the :mod:`bz2`, :mod:`zipfile`, and +.. :mod:`tarfile` modules. ``.gz`` ファイルの読み書きのためには、 :mod:`gzip` モジュールを参照してくだ さい。 その他のアーカイブフォーマットについて は、 :mod:`bz2`, :mod:`zipfile`, :mod:`tarfile` モジュールを参照してください。 + +.. The available exception and functions in this module are: + このモジュールで利用可能な例外と関数を以下に示します: .. exception:: error + .. Exception raised on compression and decompression errors. + 圧縮および解凍時のエラーによって送出される例外。 .. function:: adler32(data[, value]) + .. Computes a Adler-32 checksum of *data*. (An Adler-32 checksum is almost as + .. reliable as a CRC32 but can be computed much more quickly.) If *value* is + .. present, it is used as the starting value of the checksum; otherwise, a fixed + .. default value is used. This allows computing a running checksum over the + .. concatenation of several inputs. The algorithm is not cryptographically + .. strong, and should not be used for authentication or digital signatures. Since + .. the algorithm is designed for use as a checksum algorithm, it is not suitable + .. for use as a general hash algorithm. + *data* のAdler-32 チェックサムを計算します。（Adler-32 チェックサムは、 おおむね CRC32 と同等の信頼性を持ちながら はるかに高速に計算することができます。） *value* が与えられていれば、 *value* はチェックサム計算の 初期値として使われます。それ以外の場合には固定のデフォルト値が使われま す。この機能によって、複数の入力を結合したデータ全体 @@ -40,39 +68,53 @@ 署名などに用いるべきではありません。このアルゴリズムはチェックサムアルゴ リズムとして用いるために設計されたものなので、汎用的な ハッシュアルゴリズムには向きません。 + .. This function always returns an integer object. この関数は常に整数オブジェクトを返します。 + .. note:: + .. To generate the same numeric value across all Python versions and - platforms use adler32(data) & 0xffffffff. If you are only using - the checksum in packed binary format this is not necessary as the - return value is the correct 32bit binary representation - regardless of sign. + .. platforms use adler32(data) & 0xffffffff. If you are only using + .. the checksum in packed binary format this is not necessary as the + .. return value is the correct 32bit binary representation + .. regardless of sign. 全てのPythonのバージョンとプラットフォームで共通な数値を正壊死するには、 ``adler32(data) & 0xffffffff`` を利用してください。 もしチェックサムをパックされたバイナリフォーマットのためにしか利用しない のであれば、 符号が関係なくなり、32bitのバイナリ値としては戻り値は正しいので、この処 理は必要ありません。 -.. versionchanged:: 2.6 - .. The return value is in the range [-2**31, 2**31-1] - regardless of platform. In older versions the value is - signed on some platforms and unsigned on others. - + +.. .. versionchanged:: 2.6 +.. The return value is in the range [-2**31, 2**31-1] +.. regardless of platform. In older versions the value is +.. signed on some platforms and unsigned on others. + +.. versionchanged:: 2.6 戻り値の範囲は、プラットフォームに関係なく [-2**31, 2**31-1] になりまし た。 古いバージョンでは、この値は幾つかのプラットフォームでは符号付き、 別のプラットフォームでは符号なしになっていました。 -.. versionchanged:: 3.0 - .. The return value is unsigned and in the range [0, 2**32-1] - regardless of platform. - + +.. .. versionchanged:: 3.0 +.. The return value is unsigned and in the range [0, 2**32-1] +.. regardless of platform. + +.. versionchanged:: 3.0 戻り値の範囲は、プラットフォームに関係なく [0, 2**32-1] です。 + .. function:: compress(string[, level]) + .. Compresses the data in *string*, returning a string contained compressed data. + .. *level* is an integer from ``1`` to ``9`` controlling the level of compression; + .. ``1`` is fastest and produces the least compression, ``9`` is slowest and + .. produces the most. The default value is ``6``. Raises the :exc:`error` + .. exception if any error occurs. + *string* で与えられた文字列を圧縮し、圧縮されたデータを含む文字列を返し ます。 *level* は ``1`` から ``9`` までの 整数をとる値で、圧縮のレベルを制御します。 ``1`` は最も高速で最小限の圧 縮を行います。 ``9`` はもっとも低速になりますが 最大限の圧縮を行います。デフォルトの値は ``6`` です。圧縮時に何らかのエ ラーが発生した場合、 :exc:`error` 例外を送出します。 @@ -80,6 +122,11 @@ .. function:: compressobj([level]) + .. Returns a compression object, to be used for compressing data streams that won't + .. fit into memory at once. *level* is an integer from ``1`` to ``9`` controlling + .. the level of compression; ``1`` is fastest and produces the least compression, + .. ``9`` is slowest and produces the most. The default value is ``6``. + 一度にメモリ上に置くことができないようなデータストリームを圧縮するための 圧縮オブジェクトを返します。 *level* は ``1`` から ``9`` までの整数で、圧縮レベルを制御します。 ``1`` はもっとも高速で最小限の圧 縮を、 ``9`` はもっとも低速になりますが 最大限の圧縮を行います。デフォルトの値は ``6`` です。 @@ -91,54 +138,93 @@ single: Cyclic Redundancy Check single: checksum; Cyclic Redundancy Check + + .. Computes a CRC (Cyclic Redundancy Check) checksum of *data*. If *value* is + .. present, it is used as the starting value of the checksum; otherwise, a fixed + .. default value is used. This allows computing a running checksum over the + .. concatenation of several inputs. The algorithm is not cryptographically + .. strong, and should not be used for authentication or digital signatures. Since + .. the algorithm is designed for use as a checksum algorithm, it is not suitable + .. for use as a general hash algorithm. + *data* の CRC (Cyclic Redundancy Check, 巡回符号方式) チェックサムを計 算します。 *value* が与えられていれば、チェックサム計算の初期値として使われます。与えられて いなければデフォルトの初期値が使われます。 *value* を与えることで、複数の入力を結合したデータ全体にわたり、通しのチェックサ ムを計算することができます。 このアルゴリズムは暗号法論的には強力ではなく、認証やデジタル署名に用いる べきではありません。アルゴリズムはチェックサムアルゴリズムと して設計されてえいるので、汎用のハッシュアルゴリズムには向きません。 + + .. This function always returns an integer object. + この関数は常に整数オブジェクトを返します。 + .. note:: + .. To generate the same numeric value across all Python versions and - platforms use crc32(data) & 0xffffffff. If you are only using - the checksum in packed binary format this is not necessary as the - return value is the correct 32bit binary representation - regardless of sign. + .. platforms use crc32(data) & 0xffffffff. If you are only using + .. the checksum in packed binary format this is not necessary as the + .. return value is the correct 32bit binary representation + .. regardless of sign. 全てのPythonのバージョンとプラットフォームで共通な数値を正壊死するには、 ``crc32(data) & 0xffffffff`` を利用してください。 もしチェックサムをパックされたバイナリフォーマットのためにしか利用しない のであれば、 符号が関係なくなり、32bitのバイナリ値としては戻り値は正しいので、この処 理は必要ありません。 -.. versionchanged:: 2.6 - .. The return value is in the range [-2**31, 2**31-1] - regardless of platform. In older versions the value is - signed on some platforms and unsigned on others. - + +.. .. versionchanged:: 2.6 +.. The return value is in the range [-2**31, 2**31-1] +.. regardless of platform. In older versions the value would be +.. signed on some platforms and unsigned on others. + +.. versionchanged:: 2.6 戻り値の範囲は、プラットフォームに関係なく [-2**31, 2**31-1] になりまし た。 古いバージョンでは、この値は幾つかのプラットフォームでは符号付き、 別のプラットフォームでは符号なしになっていました。 -.. versionchanged:: 3.0 - .. The return value is unsigned and in the range [0, 2**32-1] - regardless of platform. - + +.. .. versionchanged:: 3.0 +.. The return value is unsigned and in the range [0, 2**32-1] +.. regardless of platform. + +.. versionchanged:: 3.0 戻り値の範囲は、プラットフォームに関係なく [0, 2**32-1] です。 .. function:: decompress(string[, wbits[, bufsize]]) + .. Decompresses the data in *string*, returning a string containing the + .. uncompressed data. The *wbits* parameter controls the size of the window + .. buffer. If *bufsize* is given, it is used as the initial size of the output + .. buffer. Raises the :exc:`error` exception if any error occurs. + *string* 内のデータを解凍して、解凍されたデータを含む文字列を返します。 *wbits* パラメタはウィンドウバッファの大きさを制御します。 *bufsize* が与えられていれば、出力バッファの書記サイズとして使われます。 解凍処理に何らかのエラーが生じた場合、 :exc:`error` 例外を送出します。 + + .. The absolute value of *wbits* is the base two logarithm of the size of the + .. history buffer (the "window size") used when compressing data. Its absolute + .. value should be between 8 and 15 for the most recent versions of the zlib + .. library, larger values resulting in better compression at the expense of greater + .. memory usage. The default value is 15. When *wbits* is negative, the standard + .. :program:`gzip` header is suppressed; this is an undocumented feature of the + .. zlib library, used for compatibility with :program:`unzip`'s compression file + .. format. + *wbits* の絶対値は、データを圧縮する際に用いられるヒストリバッファのサイ ズ (ウィンドウサイズ) に対し、 2 を底とする対数を とったものです。最近のほとんどのバージョンの zlib ライブラリを使っている なら、 *wbits* の絶対値は 8 から 15 とするべきです。 より大きな値はより良好な圧縮につながりますが、より多くのメモリを必要とし ます。デフォルトの値は 15 です。 *wbits* の値が負の場合、標準的な :program:`gzip` ヘッダを出力しません。これは zlib ライブラリの非公開仕様 であり、 :program:`unzip` の 圧縮ファイル形式に対する互換性のためのものです。 + + .. *bufsize* is the initial size of the buffer used to hold decompressed data. If + .. more space is required, the buffer size will be increased as needed, so you + .. don't have to get this value exactly right; tuning it will only save a few calls + .. to :cfunc:`malloc`. The default size is 16384. + *bufsize* は解凍されたデータを保持するためのバッファサイズの初期値です。 バッファの空きは必要に応じて必要なだけ増加するので、 なれば、必ずしも正確な値を指定する必要はありません。この値のチューニング でできることは、 :cfunc:`malloc` が呼ばれる回数を 数回減らすことぐらいです。デフォルトのサイズは 16384 です。 @@ -146,20 +232,42 @@ .. function:: decompressobj([wbits]) + .. Returns a decompression object, to be used for decompressing data streams that + .. won't fit into memory at once. The *wbits* parameter controls the size of the + .. window buffer. + メモリ上に一度に展開できないようなデータストリームを解凍するために用いら れる解凍オブジェクトを返します。 *wbits* パラメタは ウィンドウバッファのサイズを制御します。 + +.. Compression objects support the following methods: + 圧縮オブジェクトは以下のメソッドをサポートします: .. method:: Compress.compress(string) + .. Compress *string*, returning a string containing compressed data for at least + .. part of the data in *string*. This data should be concatenated to the output + .. produced by any preceding calls to the :meth:`compress` method. Some input may + .. be kept in internal buffers for later processing. + *string* を圧縮し、圧縮されたデータを含む文字列を返します。この文字列は 少なくとも *string* に相当します。このデータは以前に呼んだ :meth:`compress` が返した出力と結合することができます。入力の一部は以後 の処理のために内部バッファに保存されることもあります。 .. method:: Compress.flush([mode]) + .. All pending input is processed, and a string containing the remaining compressed + .. output is returned. *mode* can be selected from the constants + .. :const:`Z_SYNC_FLUSH`, :const:`Z_FULL_FLUSH`, or :const:`Z_FINISH`, + .. defaulting to :const:`Z_FINISH`. :const:`Z_SYNC_FLUSH` and + .. :const:`Z_FULL_FLUSH` allow compressing further strings of data, while + .. :const:`Z_FINISH` finishes the compressed stream and prevents compressing any + .. more data. After calling :meth:`flush` with *mode* set to :const:`Z_FINISH`, + .. the :meth:`compress` method cannot be called again; the only realistic action is + .. to delete the object. + 未処理の入力データが処理され、この未処理部分を圧縮したデータを含む文字列 が返されます。 *mode* は定数 :const:`Z_SYNC_FLUSH` 、 :const:`Z_FULL_FLUSH` 、または :const:`Z_FINISH` のいずれかをとり、デフ ォルト値は :const:`Z_FINISH` です。 :const:`Z_SYNC_FLUSH` および :const:`Z_FULL_FLUSH` ではこれ以後に もデータ文字列を圧縮できる @@ -170,18 +278,37 @@ .. method:: Compress.copy() + .. Returns a copy of the compression object. This can be used to efficiently + .. compress a set of data that share a common initial prefix. + 圧縮オブジェクトのコピーを返します。これを使うと先頭部分が共通している複 数のデータを効率的に圧縮することができます。 .. versionadded:: 2.5 + +.. Decompression objects support the following methods, and two attributes: + 解凍オブジェクトは以下のメソッドと 2 つの属性をサポートします: .. attribute:: Decompress.unused_data + .. A string which contains any bytes past the end of the compressed data. That is, + .. this remains ``""`` until the last byte that contains compression data is + .. available. If the whole string turned out to contain compressed data, this is + .. ``""``, the empty string. + 圧縮データの末尾までのバイト列が入った文字列です。すなわち、この値は圧縮 データの入っているバイト列の最後の文字までが読み出せるかぎり ``""`` となります。入力文字列全てが圧縮データを含んでいた場合、この属性は ``""`` 、すなわち空文字列になります。 + + .. The only way to determine where a string of compressed data ends is by actually + .. decompressing it. This means that when compressed data is contained part of a + .. larger file, you can only find the end of it by reading data and feeding it + .. followed by some non-empty string into a decompression object's + .. :meth:`decompress` method until the :attr:`unused_data` attribute is no longer + .. the empty string. + 圧縮データ文字列がどこで終了しているかを決定する唯一の方法は、実際にそれ を解凍することです。つまり、大きなファイル の一部分に圧縮データが含まれているときに、その末端を調べるためには、デー タをファイルから読み出し、空でない文字列を後ろに続けて、 :attr:`unused_data` が空文字列でなくなるまで、解凍オブジェクト の :meth:`decompress` @@ -190,6 +317,12 @@ .. attribute:: Decompress.unconsumed_tail + .. A string that contains any data that was not consumed by the last + .. :meth:`decompress` call because it exceeded the limit for the uncompressed data + .. buffer. This data has not yet been seen by the zlib machinery, so you must feed + .. it (possibly with further data concatenated to it) back to a subsequent + .. :meth:`decompress` method call in order to get correct output. + 解凍されたデータを収めるバッファの長さ制限を超えたために、最も最近 の :meth:`decompress` 呼び出しで処理しきれなかったデータを含む文字列です。 このデータはまだ zlib 側からは見えていないので、正しい解凍出力を得るには 以降の :meth:`decompress` メソッド呼び出しに (場合によっては後続のデータが追加された) データを差し戻さなければなりま せん。 @@ -197,10 +330,25 @@ .. method:: Decompress.decompress(string[, max_length]) + .. Decompress *string*, returning a string containing the uncompressed data + .. corresponding to at least part of the data in *string*. This data should be + .. concatenated to the output produced by any preceding calls to the + .. :meth:`decompress` method. Some of the input data may be preserved in internal + .. buffers for later processing. + *string* を解凍し、少なくとも *string* の一部分に対応する解凍されたデー タを含む文字列を返します。このデータは以前に :meth:`decompress` メソッドを呼んだ時に返された出力と結合することができ ます。入力データの一部分が以後の処理のために内部バッファに 保存されることもあります。 + + .. If the optional parameter *max_length* is supplied then the return value will be + .. no longer than *max_length*. This may mean that not all of the compressed input + .. can be processed; and unconsumed data will be stored in the attribute + .. :attr:`unconsumed_tail`. This string must be passed to a subsequent call to + .. :meth:`decompress` if decompression is to continue. If *max_length* is not + .. supplied then the whole input is decompressed, and :attr:`unconsumed_tail` is an + .. empty string. + オプションパラメタ *max_length* が与えられると、返される解凍データの長さ が *max_length* 以下に制限されます。このことは入力した圧縮 データの全てが処理されるとは限らないことを意味し、処理されなかったデータ は :attr:`unconsumed_tail` 属性に保存されます。 解凍処理を継続したいならば、この保存されたデータを以降 の :meth:`decompress` 呼び出しに渡さなくてはなりません。 *max_length* @@ -209,14 +357,26 @@ .. method:: Decompress.flush([length]) + .. All pending input is processed, and a string containing the remaining + .. uncompressed output is returned. After calling :meth:`flush`, the + .. :meth:`decompress` method cannot be called again; the only realistic action is + .. to delete the object. + 未処理の入力データを全て処理し、最終的に圧縮されなかった残りの出力文字列 を返します。 :meth:`flush` を呼んだ後、 :meth:`decompress` を再度呼ぶべきではありません。このときできる唯一現実 的な操作はオブジェクトの削除だけです。 + + .. The optional parameter *length* sets the initial size of the output buffer. + オプション引数 *length* は出力バッファの初期サイズを決めます。 .. method:: Decompress.copy() + .. Returns a copy of the decompression object. This can be used to save the state + .. of the decompressor midway through the data stream in order to speed up random + .. seeks into the stream at a future point. + 解凍オブジェクトのコピーを返します。これを使うとデータストリームの途中に ある解凍オブジェクトの状態を保存でき、未来のある時点で行なわれるストリームの ランダムなシークをスピードアップするのに利用できます。 @@ -229,8 +389,11 @@ Reading and writing :program:`gzip` \ -format files. http://www.zlib.net + .. The zlib library home page. zlib ライブラリホームページ http://www.zlib.net/manual.html + .. The zlib manual explains the semantics and usage of the library's many + .. functions. zlib ライブラリの多くの関数の意味と使い方を解説したマニュアル ============================================================================== Revision: 6909e5fd1187 Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:57:09 2011 Log: 2.6.6: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=6909e5fd1187 Modified: /library/tarfile.rst /library/zlib.rst ======================================= --- /library/tarfile.rst Sat Mar 26 09:56:32 2011 +++ /library/tarfile.rst Sat Mar 26 09:57:09 2011 @@ -641,11 +641,14 @@ .. note:: - .. The file-like object is read-only and provides the following methods: - .. :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`. - - ファイル風のオブジェクトは読み出し専用で以下のメソッドを提供しま す： :meth:`read`, :meth:`readline`, - :meth:`readlines`, :meth:`seek`, :meth:`tell`. + .. The file-like object is read-only. It provides the methods + .. :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`, + .. and :meth:`close`, and also supports iteration over its lines. + + ファイル風のオブジェクトは読み出し専用です。このオブジェクトは + :meth:`read`, :meth:`readline`, :meth:`readlines`, :meth:`seek`, + :meth:`tell`, :meth:`close`. の各メソッドを提供し、 + 行に対するイテレーションをサポートします。 .. method:: TarFile.add(name, arcname=None, recursive=True, exclude=None) ======================================= --- /library/zlib.rst Sat Mar 26 09:56:32 2011 +++ /library/zlib.rst Sat Mar 26 09:57:09 2011 @@ -196,10 +196,11 @@ .. Decompresses the data in *string*, returning a string containing the .. uncompressed data. The *wbits* parameter controls the size of the window - .. buffer. If *bufsize* is given, it is used as the initial size of the output + .. buffer, and is discussed further below. + .. If *bufsize* is given, it is used as the initial size of the output .. buffer. Raises the :exc:`error` exception if any error occurs. - *string* 内のデータを解凍して、解凍されたデータを含む文字列を返します。 *wbits* パラメタはウィンドウバッファの大きさを制御します。 + *string* 内のデータを解凍して、解凍されたデータを含む文字列を返します。 *wbits* パラメタはウィンドウバッファの大きさを制御します。詳細は以下で議論さ れています。 *bufsize* が与えられていれば、出力バッファの書記サイズとして使われます。 解凍処理に何らかのエラーが生じた場合、 :exc:`error` 例外を送出します。 @@ -208,16 +209,19 @@ .. history buffer (the "window size") used when compressing data. Its absolute .. value should be between 8 and 15 for the most recent versions of the zlib .. library, larger values resulting in better compression at the expense of greater - .. memory usage. The default value is 15. When *wbits* is negative, the standard - .. :program:`gzip` header is suppressed; this is an undocumented feature of the - .. zlib library, used for compatibility with :program:`unzip`'s compression file - .. format. + .. memory usage. When decompressing a stream, *wbits* must not be smaller + .. than the size originally used to compress the stream; using a too-small + .. value will result in an exception. The default value is therefore the + .. highest value, 15. When *wbits* is negative, the standard + .. :program:`gzip` header is suppressed. *wbits* の絶対値は、データを圧縮する際に用いられるヒストリバッファのサイ ズ (ウィンドウサイズ) に対し、 2 を底とする対数を とったものです。最近のほとんどのバージョンの zlib ライブラリを使っている なら、 *wbits* の絶対値は 8 から 15 とするべきです。 - より大きな値はより良好な圧縮につながりますが、より多くのメモリを必要とし ます。デフォルトの値は 15 です。 *wbits* の値が負の場合、標準的な - :program:`gzip` ヘッダを出力しません。これは zlib ライブラリの非公開仕様 であり、 :program:`unzip` の - 圧縮ファイル形式に対する互換性のためのものです。 + より大きな値はより良好な圧縮につながりますが、より多くのメモリを必要とし ます。 + ストリームを解凍するとき、 *wbits* は元のストリームを圧縮するために使用 した + サイズより小さくしてはいけません。小さすぎる値を使用すると例外が発生しま す。 + そのため、デフォルトの値は 15 です。 *wbits* の値が負の場合、標準的な + :program:`gzip` ヘッダを出力しません。 .. *bufsize* is the initial size of the buffer used to hold decompressed data. If ============================================================================== Revision: 19ebd9702fde Author: Nozomu Kaneko <nozom****@gmail*****> Date: Sat Mar 26 09:59:10 2011 Log: 翻訳見直し: library/{zlib.rst,tarfile.rst} http://code.google.com/p/python-doc-ja/source/detail?r=19ebd9702fde Modified: /library/tarfile.rst /library/zlib.rst ======================================= --- /library/tarfile.rst Sat Mar 26 09:57:09 2011 +++ /library/tarfile.rst Sat Mar 26 09:59:10 2011 @@ -102,22 +102,22 @@ +----------------------+-----------------------------------------------------------------+ | mode | 動 作 | +======================+=================================================================+ - | ``'r' または 'r:*'`` | 透過な圧縮つきで読み込むためにオープンします(推 奨)。 | + | ``'r' または 'r:*'`` | 圧縮方法に関して透過的に、読み込み用にオープン します(推奨)。 | +----------------------+-----------------------------------------------------------------+ - | ``'r:'`` | 圧縮なしで排他的に読み込むためにオープンしま す。 | + | ``'r:'`` | 非圧縮で読み込み用に排他的にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'r:gz'`` | gzip 圧縮で読み込むためにオープンしま す。 | + | ``'r:gz'`` | gzip 圧縮で読み込み用にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'r:bz2'`` | bzip2 圧縮で読み込むためにオープンしま す。 | + | ``'r:bz2'`` | bzip2 圧縮で読み込み用にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'a' または 'a:'`` | 圧縮なしで追加するためにオープンします。ファイ ルが存在しない | + | ``'a' または 'a:'`` | 非圧縮で追加用にオープンします。ファイルが存在 しない | | | 場合は新たに作成されま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'w' または 'w:'`` | 非圧縮で書き込むためにオープンしま す。 | + | ``'w' または 'w:'`` | 非圧縮で書き込み用にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'w:gz'`` | gzip 圧縮で書き込むためにオープンしま す。 | + | ``'w:gz'`` | gzip 圧縮で書き込み用にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ - | ``'w:bz2'`` | bzip2 圧縮で書き込むためにオープンしま す。 | + | ``'w:bz2'`` | bzip2 圧縮で書き込み用にオープンしま す。 | +----------------------+-----------------------------------------------------------------+ @@ -127,7 +127,7 @@ .. :exc:`CompressionError` is raised. ``'a:gz'`` あるいは ``'a:bz2'`` は可能ではないことに注意して下さい。もし - *mode* が、ある(圧縮した)ファイルを読み込み用にオープンするのに、適して いないなら、 :exc:`ReadError` が発生します。これを防ぐには + *mode* が、ある(圧縮した)ファイルを読み込み用にオープンするのに適してい ないなら、 :exc:`ReadError` が発生します。これを防ぐには *mode* ``'r'`` を使って下さい。もし圧縮メソッドがサポートされていなけれ ば、 :exc:`CompressionError` が発生します。 @@ -135,7 +135,7 @@ .. for *name*. It is supposed to be at position 0. もし *fileobj* が指定されていれば、それは *name* でオープンされたファイ ルオブジェクトの代替として使うことができます。 - そのファイルオブジェクトの、ファイルポジションが0であることを前提に動作 します。 + そのファイルオブジェクトの位置が0にあることを前提に動作します。 .. For special purposes, there is a second format for *mode*: @@ -182,23 +182,24 @@ .. | | writing. | .. +-------------+--------------------------------------------+ - +-------------+-----------------------------------------------------------------+ - | モード | 動 作 | - +=============+=================================================================+ - | ``'r|*'`` | tar ブロックの *ストリーム* を透過な読み込みにオープンし ます。 | - +-------------+-----------------------------------------------------------------+ - | ``'r|'`` | 非圧縮 tar ブロックの *ストリーム* を読み込みにオープン します。 | - +-------------+-----------------------------------------------------------------+ - | ``'r|gz'`` | gzip 圧縮 *ストリーム* を読み込みにオープンしま す。 | - +-------------+-----------------------------------------------------------------+ - | ``'r|bz2'`` | bzip2 圧縮 *ストリーム* を読み込みにオープンしま す。 | - +-------------+-----------------------------------------------------------------+ - | ``'w|'`` | 非圧縮 *ストリーム* を書き込みにオープンしま す。 | - +-------------+-----------------------------------------------------------------+ - | ``'w|gz'`` | gzip 圧縮 *ストリーム* を書き込みにオープンしま す。 | - +-------------+-----------------------------------------------------------------+ - | ``'w|bz2'`` | bzip2 圧縮 *ストリーム* を書き込みにオープンしま す。 | - +-------------+-----------------------------------------------------------------+ + +-------------+-------------------------------------------------------------------+ + | モード | 動 作 | + +=============+===================================================================+ + | ``'r|*'`` | tar ブロックの *ストリーム* を 圧縮方法に関して透過的 に | + | | 読み込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ + | ``'r|'`` | 非圧縮 tar ブロックの *ストリーム* を読み込み用にオープ ンします。 | + +-------------+-------------------------------------------------------------------+ + | ``'r|gz'`` | gzip 圧縮の *ストリーム* を読み込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ + | ``'r|bz2'`` | bzip2 圧縮の *ストリーム* を読み込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ + | ``'w|'`` | 非圧縮の *ストリーム* を書き込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ + | ``'w|gz'`` | gzip 圧縮の *ストリーム* を書き込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ + | ``'w|bz2'`` | bzip2 圧縮の *ストリーム* を書き込み用にオープンしま す。 | + +-------------+-------------------------------------------------------------------+ .. class:: TarFile @@ -224,8 +225,8 @@ .. Please consult the documentation of the :mod:`zipfile` module for more details. .. *compression* must be one of the following constants: - ``zipfile`` \ -風なインターフェースを持つ tar アーカイブへの制限されたア クセスのためのクラスです。詳細は - ``zipfile`` のドキュメントを参照してください。 *compression* は、以下の 定数のどれかでなければなりません： + :mod:`zipfile` 風なインターフェースを持つ tar アーカイブへの制限されたア クセスのためのクラスです。詳細は + :mod:`zipfile` のドキュメントを参照してください。 *compression* は、以下 の定数のどれかでなければなりません： .. data:: TAR_PLAIN @@ -285,8 +286,8 @@ .. Is raised for *non-fatal* errors when using :meth:`TarFile.extract`, but only if .. :attr:`TarFile.errorlevel`\ ``== 2``. - :meth:`TarFile.extract` を使った時、もし :attr:`TarFile.errorlevel`\ ``== 2`` の *フェータルでない* - エラーに対してだけ発生します。 + :meth:`TarFile.extract` を使った時に *致命的でない* エラーに対して発生し ます。 + ただし :attr:`TarFile.errorlevel`\ ``== 2`` の場合に限ります。 .. exception:: HeaderError @@ -404,7 +405,7 @@ *mode* は、既存のアーカイブファールから読み込むための ``'r'``, 既存のアーカイブファイルに追記するための ``'a'``, - 既存のファイルがあれば上書きし、新しいファイルを作成する ``'w'`` + 既存のファイルがあれば上書きして新しいファイルを作成する ``'w'`` のいずれかです。 @@ -414,14 +415,14 @@ もし *fileobj* が与えられていれば、それを使ってデータを読み書きします。 もしそれが決定できれば、 *mode* は *fileobj* のモードで上書きされます。 - *fileobj* はポジション0から利用されます。 + *fileobj* は位置0から利用されます。 .. note:: .. *fileobj* is not closed, when :class:`TarFile` is closed. - *fileobj* は、 :class:`TarFile` をクローズする時にクローズされませ ん。 + :class:`TarFile` をクローズする時に、 *fileobj* はクローズされませ ん。 .. *format* controls the archive format. It must be one of the constants @@ -527,7 +528,7 @@ .. If a member occurs more than once in the archive, its last occurrence is assumed .. to be the most up-to-date version. - もしメンバーがアーカイブに1つ以上あれば、その最後に出現するものが、最 新のバージョンであるとみなされます。 + アーカイブ内にメンバーが複数ある場合は、最後に出現するものが最新の バージョンとみなされます。 .. method:: TarFile.getmembers() @@ -535,7 +536,7 @@ .. Return the members of the archive as a list of :class:`TarInfo` objects. The .. list has the same order as the members in the archive. - :class:`TarInfo` オブジェクトのリストとしてアーカイブのメンバーを返しま す。このリストはアーカイブ内のメンバーと同じ順番です。 + :class:`TarInfo` アーカイブのメンバーをオブジェクトのリストとして返しま す。このリストはアーカイブ内のメンバーと同じ順番です。 .. method:: TarFile.getnames() @@ -552,8 +553,8 @@ .. only the names of the members are printed. If it is :const:`True`, output .. similar to that of :program:`ls -l` is produced. - コンテンツの表を ``sys.stdout`` に印刷します。もし *verbose* が :const:`False` - であれば、メンバー名のみ印刷します。もしそれが :const:`True` であれば、 ``"ls -l"`` に似た出力を生成します。 + 目次を ``sys.stdout`` に表示します。もし *verbose* が :const:`False` + であれば、メンバー名のみ表示します。 :const:`True` であれば、 ``"ls -l"`` に似た出力を生成します。 .. method:: TarFile.next() @@ -578,7 +579,7 @@ 全てのメンバーをアーカイブから現在の作業ディレクトリーまたは *path* に抽 出します。オプションの *members* が与えられるときには、 :meth:`getmembers` で返されるリストの一部でなければなりません。 - 所有者、変更時刻、許可のようなディレクトリー情報は全てのメンバーが抽出さ れた後にセットされます。これは二つの問題を回避するためです。一つはディレクト リー + 所有者、変更時刻、パーミッションのようなディレクトリー情報は全てのメン バーが抽出された後にセットされます。これは二つの問題を回避するためです。一つ はディレクトリー の変更時刻はその中にファイルが作成されるたびにリセットされるということ。 もう一つは、ディレクトリーに書き込み許可がなければその中のファイル抽出は 失敗してしまうということです。 @@ -605,7 +606,7 @@ .. may be a filename or a :class:`TarInfo` object. You can specify a different .. directory using *path*. - メンバーをアーカイブから現在の作業ディレクトリに、そのフル名を使って、抽 出します。そのファイル情報はできるだけ正確に抽出されます。 + メンバーをアーカイブから現在の作業ディレクトリに、その完全名を使って抽出 します。ファイル情報はできるだけ正確に抽出されます。 *member* は、ファイル名でも :class:`TarInfo` オブジェクトでも構いませ ん。 *path* を使って、異なるディレクトリを指定することができます。 @@ -636,7 +637,7 @@ アーカイブからメンバーをオブジェクトとして抽出します。 *member* は、ファ イル名あるいは :class:`TarInfo` オブジェクトです。もし *member* が普通のファイルであれば、ファイル風のオブジェクトを返します。 もし *member* がリンクであれば、ファイル風のオブジェクトをリンクのターゲット から構成します。もし *member* が上のどれでもなければ、 - :const:``None`` が返されます。 + :const:`None` が返されます。 .. note:: @@ -662,9 +663,9 @@ .. (:const:`True`) or added (:const:`False`). ファイル *name* をアーカイブに追加します。 *name* は、任意のファイルタイ プ (ディレクトリ、fifo、シンボリックリンク等)です。 - もし *arcname* が与えられていれば、それはアーカイブ内のファイルの代替名 を指定します。デフォールトではディレクトリは再帰的に追加されます。 + もし *arcname* が与えられていれば、それはアーカイブ内のファイルの代替名 を指定します。デフォルトではディレクトリは再帰的に追加されます。 これは、 *recursive* を :const:`False` に設定することで避けることができ ます。 - *exclude* を指定する場合、それは1つのファイル名を引数にとって、ブール値 を返す関数である必要があります。 + *exclude* を指定する場合、それは1つのファイル名を引数にとってブール値を 返す関数である必要があります。 この関数の戻り値が :const:`True` の場合、そのファイルが除外されま す。 :const:`False` の場合、そのファイルは追加されます。 @@ -702,10 +703,10 @@ .. of the :class:`TarInfo`'s attributes before you add it using :meth:`addfile`. .. If given, *arcname* specifies an alternative name for the file in the archive. - :class:`TarInfo` オブジェクトをファイル *name* あるいは (そのファイル記 述子に ``os.fstat()`` を使って) - ファイルオブジェクト *fileobj* のどちらか用に作成しま す。 :class:`TarInfo` の属性のいくつかは、 - :meth:`addfile` を使って追加する前に修正することができます。 *arcname* がもし与えられていれば、アーカイブ内のファイルの - 代替名を指定します。 + ファイル *name* あるいはファイルオブジェクト *fileobj* のどちらかに対し て + (そのファイル記述子に ``os.fstat()`` を使って) :class:`TarInfo` オブジェ クトを作成します。 + :class:`TarInfo` の属性のいくつかは、 :meth:`addfile` を使って追加する前 に修正することができます。 + もし *arcname* が与えられていれば、アーカイブ内のファイルの代替名を指定 します。 .. method:: TarFile.close() @@ -760,8 +761,8 @@ .. It does *not* contain the file's data itself. :class:`TarInfo` オブジェクトは :class:`TarFile` の一つのメンバーを表しま す。ファイルに -必要な(ファイルタイプ、ファイルサイズ、時刻、許可、所有者等のような)すべて の属性を保存する他に、 -そのタイプを決定するのに役に立ついくつかのメソッドを提供します。これにはフ ァイルのデータそのものは含まれま *せん* 。 +必要な(ファイルタイプ、ファイルサイズ、時刻、パーミッション、所有者等のよう な)すべての属性を保存する他に、 +そのタイプを決定するのに役に立ついくつかのメソッドを提供します。これにはフ ァイルのデータそのものは *含まれません* 。 .. :class:`TarInfo` objects are returned by :class:`TarFile`'s methods @@ -863,7 +864,7 @@ ファイルタイプです。 *type* は普通、以下の定 数: :const:`REGTYPE`, :const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :const:`GNUTYPE_SPARSE` - のいずれかです。 :class:`TarInfo` オブジェクトのタイプをもっと便利に決定 するには、下記の ``is_*()`` メソッドを使って下さい。 + のいずれかです。 :class:`TarInfo` オブジェクトのタイプをもっと簡単に決定 するには、下記の ``is_*()`` メソッドを使って下さい。 .. attribute:: TarInfo.linkname ======================================= --- /library/zlib.rst Sat Mar 26 09:57:09 2011 +++ /library/zlib.rst Sat Mar 26 09:59:10 2011 @@ -64,7 +64,7 @@ *data* のAdler-32 チェックサムを計算します。（Adler-32 チェックサムは、 おおむね CRC32 と同等の信頼性を持ちながら はるかに高速に計算することができます。） *value* が与えられていれば、 *value* はチェックサム計算の 初期値として使われます。それ以外の場合には固定のデフォルト値が使われま す。この機能によって、複数の入力を結合したデータ全体 - にわたり、通しのチェックサムを計算することができます。このアルゴリズムは 暗号法論的には強力とはいえないので、認証やデジタル + にわたり、通しのチェックサムを計算することができます。このアルゴリズムは 暗号論的には強力とはいえないので、認証やデジタル 署名などに用いるべきではありません。このアルゴリズムはチェックサムアルゴ リズムとして用いるために設計されたものなので、汎用的な ハッシュアルゴリズムには向きません。 @@ -82,7 +82,7 @@ .. return value is the correct 32bit binary representation .. regardless of sign. - 全てのPythonのバージョンとプラットフォームで共通な数値を正壊死するには、 + 全てのPythonのバージョンとプラットフォームで共通な数値を生成するには、 ``adler32(data) & 0xffffffff`` を利用してください。 もしチェックサムをパックされたバイナリフォーマットのためにしか利用しない のであれば、 符号が関係なくなり、32bitのバイナリ値としては戻り値は正しいので、この処 理は必要ありません。 @@ -150,8 +150,8 @@ *data* の CRC (Cyclic Redundancy Check, 巡回符号方式) チェックサムを計 算します。 *value* が与えられていれば、チェックサム計算の初期値として使われます。与えられて いなければデフォルトの初期値が使われます。 *value* を与えることで、複数の入力を結合したデータ全体にわたり、通しのチェックサ ムを計算することができます。 - このアルゴリズムは暗号法論的には強力ではなく、認証やデジタル署名に用いる べきではありません。アルゴリズムはチェックサムアルゴリズムと - して設計されてえいるので、汎用のハッシュアルゴリズムには向きません。 + このアルゴリズムは暗号論的には強力ではなく、認証やデジタル署名に用いるべ きではありません。アルゴリズムはチェックサムアルゴリズムと + して設計されているので、汎用のハッシュアルゴリズムには向きません。 .. This function always returns an integer object. @@ -167,7 +167,7 @@ .. return value is the correct 32bit binary representation .. regardless of sign. - 全てのPythonのバージョンとプラットフォームで共通な数値を正壊死するには、 + 全てのPythonのバージョンとプラットフォームで共通な数値を生成するには、 ``crc32(data) & 0xffffffff`` を利用してください。 もしチェックサムをパックされたバイナリフォーマットのためにしか利用しない のであれば、 符号が関係なくなり、32bitのバイナリ値としては戻り値は正しいので、この処 理は必要ありません。 @@ -200,8 +200,8 @@ .. If *bufsize* is given, it is used as the initial size of the output .. buffer. Raises the :exc:`error` exception if any error occurs. - *string* 内のデータを解凍して、解凍されたデータを含む文字列を返します。 *wbits* パラメタはウィンドウバッファの大きさを制御します。詳細は以下で議論さ れています。 - *bufsize* が与えられていれば、出力バッファの書記サイズとして使われます。 解凍処理に何らかのエラーが生じた場合、 :exc:`error` + *string* 内のデータを解凍して、解凍されたデータを含む文字列を返します。 *wbits* パラメータはウィンドウバッファの大きさを制御します。より詳しい説明は 後で行います。 + *bufsize* が与えられていれば、出力バッファの初期サイズとして使われます。 解凍処理に何らかのエラーが生じた場合、 :exc:`error` 例外を送出します。 @@ -230,7 +230,7 @@ .. to :cfunc:`malloc`. The default size is 16384. *bufsize* は解凍されたデータを保持するためのバッファサイズの初期値です。 バッファの空きは必要に応じて必要なだけ増加するので、 - なれば、必ずしも正確な値を指定する必要はありません。この値のチューニング でできることは、 :cfunc:`malloc` が呼ばれる回数を + 必ずしも正確な値を指定する必要はありません。この値のチューニングでできる ことは、 :cfunc:`malloc` が呼ばれる回数を 数回減らすことぐらいです。デフォルトのサイズは 16384 です。 @@ -240,7 +240,7 @@ .. won't fit into memory at once. The *wbits* parameter controls the size of the .. window buffer. - メモリ上に一度に展開できないようなデータストリームを解凍するために用いら れる解凍オブジェクトを返します。 *wbits* パラメタは + メモリ上に一度に展開できないようなデータストリームを解凍するために用いら れる解凍オブジェクトを返します。 *wbits* パラメータは ウィンドウバッファのサイズを制御します。 @@ -256,7 +256,7 @@ .. produced by any preceding calls to the :meth:`compress` method. Some input may .. be kept in internal buffers for later processing. - *string* を圧縮し、圧縮されたデータを含む文字列を返します。この文字列は 少なくとも *string* に相当します。このデータは以前に呼んだ + *string* を圧縮し、圧縮されたデータを含む文字列を返します。この文字列は 少なくとも *string* の一部分のデータに対する圧縮データを含みます。このデータ は以前に呼んだ :meth:`compress` が返した出力と結合することができます。入力の一部は以後 の処理のために内部バッファに保存されることもあります。 @@ -302,8 +302,8 @@ .. available. If the whole string turned out to contain compressed data, this is .. ``""``, the empty string. - 圧縮データの末尾までのバイト列が入った文字列です。すなわち、この値は圧縮 データの入っているバイト列の最後の文字までが読み出せるかぎり ``""`` - となります。入力文字列全てが圧縮データを含んでいた場合、この属性は ``""`` 、すなわち空文字列になります。 + 圧縮データの末尾より後のバイト列が入った文字列です。すなわち、この値は圧 縮データの入っているバイト列の最後の文字が利用可能になるまでは ``""`` + のままとなります。入力文字列全てが圧縮データを含んでいた場合、この属性 は ``""`` 、すなわち空文字列になります。 .. The only way to determine where a string of compressed data ends is by actually @@ -353,7 +353,7 @@ .. supplied then the whole input is decompressed, and :attr:`unconsumed_tail` is an .. empty string. - オプションパラメタ *max_length* が与えられると、返される解凍データの長さ が *max_length* 以下に制限されます。このことは入力した圧縮 + オプションパラメータ *max_length* が与えられると、返される解凍データの長 さが *max_length* 以下に制限されます。このことは入力した圧縮 データの全てが処理されるとは限らないことを意味し、処理されなかったデータ は :attr:`unconsumed_tail` 属性に保存されます。 解凍処理を継続したいならば、この保存されたデータを以降 の :meth:`decompress` 呼び出しに渡さなくてはなりません。 *max_length* が与えられなかった場合、全ての入力が解凍され、 :attr:`unconsumed_tail` 属性は空文字列になります。 @@ -367,7 +367,7 @@ .. to delete the object. 未処理の入力データを全て処理し、最終的に圧縮されなかった残りの出力文字列 を返します。 :meth:`flush` を呼んだ後、 - :meth:`decompress` を再度呼ぶべきではありません。このときできる唯一現実 的な操作はオブジェクトの削除だけです。 + :meth:`decompress` を再度呼ぶべきではありません。このときできる唯一の現 実的な操作はオブジェクトの削除だけです。 .. The optional parameter *length* sets the initial size of the output buffer.
