Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit67a53e5

Browse files
committed
docs(library/pickle.po): First iteration of translation done
1 parent1b458e7 commit67a53e5

File tree

1 file changed

+135
-14
lines changed

1 file changed

+135
-14
lines changed

‎library/pickle.po

Lines changed: 135 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1988,6 +1988,10 @@ msgid ""
19881988
"graph. Buffers accumulated by the *buffer_callback* will not see their data "
19891989
"copied into the pickle stream, only a cheap marker will be inserted."
19901990
msgstr""
1991+
"傳送端需要傳遞一個調用緩衝區的回呼函數給 :class:`Pickler`（或 :func:`dump` "
1992+
"或 :func:`dumps` 函數）的 *buffer_callback* 引數，使每次生成 :class:"
1993+
"`PickleBuffer` 時，該物件在處理物件圖時能被呼叫。除了一個簡易標記以外，由 "
1994+
"*buffer_callback* 累積的緩衝區資料不會被複製到 pickle 串流中。"
19911995

19921996
#:../../library/pickle.rst:991
19931997
msgid""
@@ -1999,6 +2003,12 @@ msgid ""
19992003
"reconstructors of the objects whose pickling produced the original :class:"
20002004
"`PickleBuffer` objects."
20012005
msgstr""
2006+
"接收端需要傳遞一個緩衝區物件給 :class:`Unpickler`（或 :func:`load` 或 :func:"
2007+
"`loads` 函式）的 *buffers* 引數。該物件須是一個可疊代的（iterable）緩衝區"
2008+
"（buffer）物件，其中包含傳遞給 *buffer_callback* 的緩衝區物件。這個可疊代物件"
2009+
"的緩衝區順序應該與它們當初被封裝時傳遞給 *buffer_callback* 的順序相同。這些緩"
2010+
"衝區將提供物件重建所需的資料，以使重建器能還原出那個當時產生了 :class:"
2011+
"`PickleBuffer` 的物件。"
20022012

20032013
#:../../library/pickle.rst:999
20042014
msgid""
@@ -2007,6 +2017,8 @@ msgid ""
20072017
"Potential optimizations include the use of shared memory or datatype-"
20082018
"dependent compression."
20092019
msgstr""
2020+
"在傳送與接收端之間，通訊系統可以自由實作轉移帶外緩衝區資料的機制。該機制可能"
2021+
"可以利用共用記憶體機制或根據資料類型特定的壓縮方式來最佳化執行速度。"
20102022

20112023
#:../../library/pickle.rst:1005
20122024
msgid"Example"
@@ -2017,6 +2029,8 @@ msgid ""
20172029
"Here is a trivial example where we implement a :class:`bytearray` subclass "
20182030
"able to participate in out-of-band buffer pickling::"
20192031
msgstr""
2032+
"這一個簡單的範例展示了如何實作一個可以參與帶外緩衝區封裝的 :class:"
2033+
"`bytearray` 子類別：::"
20202034

20212035
#:../../library/pickle.rst:1010
20222036
msgid""
@@ -2041,19 +2055,42 @@ msgid ""
20412055
" else:\n"
20422056
" return cls(obj)"
20432057
msgstr""
2058+
"class ZeroCopyByteArray(bytearray):\n"
2059+
"\n"
2060+
" def __reduce_ex__(self, protocol):\n"
2061+
" if protocol >= 5:\n"
2062+
" return type(self)._reconstruct, (PickleBuffer(self),), None\n"
2063+
" else:\n"
2064+
" # PickleBuffer 在 pickle 協定 <= 4 時禁止使用。\n"
2065+
" return type(self)._reconstruct, (bytearray(self),)\n"
2066+
"\n"
2067+
" @classmethod\n"
2068+
" def _reconstruct(cls, obj):\n"
2069+
" with memoryview(obj) as m:\n"
2070+
" # 取得對原始緩衝區物件的控制\n"
2071+
" obj = m.obj\n"
2072+
" if type(obj) is cls:\n"
2073+
" # 若原本的緩衝區物件是 ZeroCopyByteArray，則直接回傳。\n"
2074+
" return obj\n"
2075+
" else:\n"
2076+
" return cls(obj)"
20442077

20452078
#:../../library/pickle.rst:1031
20462079
msgid""
20472080
"The reconstructor (the ``_reconstruct`` class method) returns the buffer's "
20482081
"providing object if it has the right type. This is an easy way to simulate "
20492082
"zero-copy behaviour on this toy example."
20502083
msgstr""
2084+
"如果型別正確，重建器（``_reconstruct`` 類別方法）會返回當時提供緩衝區的物件。"
2085+
"這個簡易實作可以模擬一個無複製行為的重建器。"
20512086

20522087
#:../../library/pickle.rst:1035
20532088
msgid""
20542089
"On the consumer side, we can pickle those objects the usual way, which when "
20552090
"unserialized will give us a copy of the original object::"
20562091
msgstr""
2092+
"在使用端，我們可以用一般的方式封裝這些物件，當我們拆封時會得到一個原始物件的"
2093+
"副本：::"
20572094

20582095
#:../../library/pickle.rst:1038
20592096
msgid""
@@ -2063,12 +2100,19 @@ msgid ""
20632100
"print(b == new_b) # True\n"
20642101
"print(b is new_b) # False: a copy was made"
20652102
msgstr""
2103+
"b = ZeroCopyByteArray(b\"abc\")\n"
2104+
"data = pickle.dumps(b, protocol=5)\n"
2105+
"new_b = pickle.loads(data)\n"
2106+
"print(b == new_b) # True\n"
2107+
"print(b is new_b) # False: 曾進行過複製運算"
20662108

20672109
#:../../library/pickle.rst:1044
20682110
msgid""
20692111
"But if we pass a *buffer_callback* and then give back the accumulated "
20702112
"buffers when unserializing, we are able to get back the original object::"
20712113
msgstr""
2114+
"但如果我們傳一個 *buffer_callback* 並在去序列化時正確返回積累的緩衝資料，我們"
2115+
"就能拿回原始的物件：::"
20722116

20732117
#:../../library/pickle.rst:1047
20742118
msgid""
@@ -2079,6 +2123,12 @@ msgid ""
20792123
"print(b == new_b) # True\n"
20802124
"print(b is new_b) # True: no copy was made"
20812125
msgstr""
2126+
"b = ZeroCopyByteArray(b\"abc\")\n"
2127+
"buffers = []\n"
2128+
"data = pickle.dumps(b, protocol=5, buffer_callback=buffers.append)\n"
2129+
"new_b = pickle.loads(data, buffers=buffers)\n"
2130+
"print(b == new_b) # True\n"
2131+
"print(b is new_b) # True: 沒有進行過複製"
20822132

20832133
#:../../library/pickle.rst:1054
20842134
msgid""
@@ -2089,14 +2139,18 @@ msgid ""
20892139
"making as few copies as possible) when transferring between distinct "
20902140
"processes or systems."
20912141
msgstr""
2142+
"此範例是因為受限於 :class:`bytearray` 會自行分配記憶體：您無法創建以其他物件"
2143+
"的記憶體為基礎的 :class:`bytearray` 實例。不過第三方資料型態（如 NumPy 陣列）"
2144+
"則可能沒有這個限制，而允許在不同程序或系統之間傳輸資料時使用零拷貝封裝（或儘"
2145+
"可能地減少拷貝次數）。"
20922146

20932147
#:../../library/pickle.rst:1061
20942148
msgid":pep:`574` -- Pickle protocol 5 with out-of-band data"
2095-
msgstr""
2149+
msgstr":pep:`574` -- 第 5 版 Pickle 協定的帶外資料（out-of-band data）處裡"
20962150

20972151
#:../../library/pickle.rst:1067
20982152
msgid"Restricting Globals"
2099-
msgstr""
2153+
msgstr"限制全域物件"
21002154

21012155
#:../../library/pickle.rst:1072
21022156
msgid""
@@ -2105,6 +2159,9 @@ msgid ""
21052159
"it permits the unpickler to import and invoke arbitrary code. Just consider "
21062160
"what this hand-crafted pickle data stream does when loaded::"
21072161
msgstr""
2162+
"預設情況下，拆封過程將會引入任何在 pickle 資料中找到的類別或函式。對於許多應"
2163+
"用程式來說，這種行為是不可接受的，因為它讓拆封器能夠引入並執行任意程式碼。請"
2164+
"參見以下 pickle 資料流在載入時的行為：::"
21082165

21092166
#:../../library/pickle.rst:1077
21102167
msgid""
@@ -2125,6 +2182,9 @@ msgid ""
21252182
"is inoffensive, it is not difficult to imagine one that could damage your "
21262183
"system."
21272184
msgstr""
2185+
"在這個例子中，拆封器會引入 :func:`os.system` 函式，然後執行命令「echo hello "
2186+
"world」。雖然這個例子是無害的，但不難想像可以這個方式輕易執行任意可能對系統造"
2187+
"成損害的命令。"
21282188

21292189
#:../../library/pickle.rst:1086
21302190
msgid""
@@ -2134,12 +2194,18 @@ msgid ""
21342194
"requested. Thus it is possible to either completely forbid globals or "
21352195
"restrict them to a safe subset."
21362196
msgstr""
2197+
"基於以上原因，您可能會希望透過自訂 :meth:`Unpickler.find_class` 來控制哪些是"
2198+
"能夠被拆封的內容。與其名稱字面意義暗示的不同，實際上每當你請求一個全域物件"
2199+
"（例如，類別或函式）時，就會調用 :meth:`Unpickler.find_class`。因此，可以透過"
2200+
"這個方法完全禁止全域物件或將其限制在安全的子集合。"
21372201

21382202
#:../../library/pickle.rst:1092
21392203
msgid""
21402204
"Here is an example of an unpickler allowing only few safe classes from the :"
21412205
"mod:`builtins` module to be loaded::"
21422206
msgstr""
2207+
"以下是一個僅允許從 :mod:`builtins` 模組中載入少數安全類別的拆封器"
2208+
"（unpickler）的例子：::"
21432209

21442210
#:../../library/pickle.rst:1095
21452211
msgid""
@@ -2169,10 +2235,35 @@ msgid ""
21692235
"\"\"\"Helper function analogous to pickle.loads().\"\"\"\n"
21702236
" return RestrictedUnpickler(io.BytesIO(s)).load()"
21712237
msgstr""
2238+
"import builtins\n"
2239+
"import io\n"
2240+
"import pickle\n"
2241+
"\n"
2242+
"safe_builtins = {\n"
2243+
" 'range',\n"
2244+
" 'complex',\n"
2245+
" 'set',\n"
2246+
" 'frozenset',\n"
2247+
" 'slice',\n"
2248+
"}\n"
2249+
"\n"
2250+
"class RestrictedUnpickler(pickle.Unpickler):\n"
2251+
"\n"
2252+
" def find_class(self, module, name):\n"
2253+
" # 只允許幾個內建的安全類別\n"
2254+
" if module ==\"builtins\" and name in safe_builtins:\n"
2255+
" return getattr(builtins, name)\n"
2256+
" # 完全禁止任何其他類別\n"
2257+
" raise pickle.UnpicklingError(\"global '%s.%s' is forbidden\" %\n"
2258+
" (module, name))\n"
2259+
"\n"
2260+
"def restricted_loads(s):\n"
2261+
"\"\"\"一個模擬 pickle.loads() 的輔助函數\"\"\"\n"
2262+
" return RestrictedUnpickler(io.BytesIO(s)).load()"
21722263

21732264
#:../../library/pickle.rst:1121
21742265
msgid"A sample usage of our unpickler working as intended::"
2175-
msgstr""
2266+
msgstr"我們剛才實作的的拆封器範例正常運作的樣子：::"
21762267

21772268
#:../../library/pickle.rst:1123
21782269
msgid""
@@ -2209,17 +2300,23 @@ msgid ""
22092300
"alternatives such as the marshalling API in :mod:`xmlrpc.client` or third-"
22102301
"party solutions."
22112302
msgstr""
2303+
"正如我們的範例所示，必須謹慎審視能被拆封的內容。因此，如果您的應用場景非常關"
2304+
"心安全性，您可能需要考慮其他選擇，例如 :mod:`xmlrpc.client` 中的 marshalling "
2305+
"API 或其他第三方解決方案。"
22122306

22132307
#:../../library/pickle.rst:1147
22142308
msgid"Performance"
2215-
msgstr""
2309+
msgstr"效能"
22162310

22172311
#:../../library/pickle.rst:1149
22182312
msgid""
22192313
"Recent versions of the pickle protocol (from protocol 2 and upwards) feature "
22202314
"efficient binary encodings for several common features and built-in types. "
22212315
"Also, the :mod:`pickle` module has a transparent optimizer written in C."
22222316
msgstr""
2317+
"較近期的 pickle 協定版本（從 2 版協定開始）為多種常見功能和內建型別提供了高效"
2318+
"率的二進位編碼。此外，:mod:`pickle` 模組還具備一個透明化的、以 C 語言編寫的最"
2319+
"佳化工具。"
22232320

22242321
#:../../library/pickle.rst:1157
22252322
msgid"Examples"
@@ -2228,7 +2325,7 @@ msgstr "範例"
22282325
#:../../library/pickle.rst:1159
22292326
msgid""
22302327
"For the simplest code, use the :func:`dump` and :func:`load` functions. ::"
2231-
msgstr""
2328+
msgstr"最簡單的使用方式，調用 :func:`dump` 和 :func:`load` 函式。::"
22322329

22332330
#:../../library/pickle.rst:1161
22342331
msgid""
@@ -2245,10 +2342,22 @@ msgid ""
22452342
" # Pickle the 'data' dictionary using the highest protocol available.\n"
22462343
" pickle.dump(data, f, pickle.HIGHEST_PROTOCOL)"
22472344
msgstr""
2345+
"import pickle\n"
2346+
"\n"
2347+
"# 任意 pickle 支援的物件。\n"
2348+
"data = {\n"
2349+
" 'a': [1, 2.0, 3+4j],\n"
2350+
" 'b': (\"string\", b\"byte string\"),\n"
2351+
" 'c': {None, True, False}\n"
2352+
"}\n"
2353+
"\n"
2354+
"with open('data.pickle', 'wb') as f:\n"
2355+
" # 使用可用的最高協定來封裝 'data' 字典。\n"
2356+
" pickle.dump(data, f, pickle.HIGHEST_PROTOCOL)\n"
22482357

22492358
#:../../library/pickle.rst:1175
22502359
msgid"The following example reads the resulting pickled data. ::"
2251-
msgstr""
2360+
msgstr"以下範例可以讀取前述程式所封裝的 pickle 資料。::"
22522361

22532362
#:../../library/pickle.rst:1177
22542363
msgid""
@@ -2259,72 +2368,81 @@ msgid ""
22592368
" # have to specify it.\n"
22602369
" data = pickle.load(f)"
22612370
msgstr""
2371+
"import pickle\n"
2372+
"\n"
2373+
"with open('data.pickle', 'rb') as f:\n"
2374+
" # 會自動檢測資料使用的協定版本，因此我們不需要手動指定。\n"
2375+
" data = pickle.load(f)"
22622376

22632377
#:../../library/pickle.rst:1191
22642378
msgid"Module :mod:`copyreg`"
22652379
msgstr":mod:`copyreg` 模組"
22662380

22672381
#:../../library/pickle.rst:1192
22682382
msgid"Pickle interface constructor registration for extension types."
2269-
msgstr""
2383+
msgstr"註冊擴充型別的 Pickle 介面建構子。"
22702384

22712385
#:../../library/pickle.rst:1194
22722386
msgid"Module :mod:`pickletools`"
22732387
msgstr":mod:`pickletools` 模組"
22742388

22752389
#:../../library/pickle.rst:1195
22762390
msgid"Tools for working with and analyzing pickled data."
2277-
msgstr""
2391+
msgstr"用於分析或處裡被封裝資料的工具。"
22782392

22792393
#:../../library/pickle.rst:1197
22802394
msgid"Module :mod:`shelve`"
22812395
msgstr":mod:`shelve` 模組"
22822396

22832397
#:../../library/pickle.rst:1198
22842398
msgid"Indexed databases of objects; uses :mod:`pickle`."
2285-
msgstr""
2399+
msgstr"索引式資料庫；使用 :mod:`pickle` 實作。"
22862400

22872401
#:../../library/pickle.rst:1200
22882402
msgid"Module :mod:`copy`"
22892403
msgstr":mod:`copy` 模組"
22902404

22912405
#:../../library/pickle.rst:1201
22922406
msgid"Shallow and deep object copying."
2293-
msgstr""
2407+
msgstr"物件的淺層或深度拷貝。"
22942408

22952409
#:../../library/pickle.rst:1203
22962410
msgid"Module :mod:`marshal`"
22972411
msgstr":mod:`marshal` 模組"
22982412

22992413
#:../../library/pickle.rst:1204
23002414
msgid"High-performance serialization of built-in types."
2301-
msgstr""
2415+
msgstr"內建型別的高效能序列化。"
23022416

23032417
#:../../library/pickle.rst:1208
23042418
msgid"Footnotes"
23052419
msgstr"註解"
23062420

23072421
#:../../library/pickle.rst:1209
23082422
msgid"Don't confuse this with the :mod:`marshal` module"
2309-
msgstr""
2423+
msgstr"不要將此模組與 :mod:`marshal` 模組混淆"
23102424

23112425
#:../../library/pickle.rst:1211
23122426
msgid""
23132427
"This is why :keyword:`lambda` functions cannot be pickled: all :keyword:`!"
23142428
"lambda` functions share the same name: ``<lambda>``."
23152429
msgstr""
2430+
"這就是為什麼 :keyword:`lambda` 函式無法被封裝：所有 :keyword:`!lambda` 函式共"
2431+
"享相同的名稱：``<lambda>``。"
23162432

23172433
#:../../library/pickle.rst:1214
23182434
msgid""
23192435
"The exception raised will likely be an :exc:`ImportError` or an :exc:"
23202436
"`AttributeError` but it could be something else."
23212437
msgstr""
2438+
"拋出的例外應該是 :exc:`ImportError` 或 :exc:`AttributeError`，但也可能是其他"
2439+
"例外。"
23222440

23232441
#:../../library/pickle.rst:1217
23242442
msgid""
23252443
"The :mod:`copy` module uses this protocol for shallow and deep copying "
23262444
"operations."
2327-
msgstr""
2445+
msgstr":mod:`copy` 模組使用此協定進行淺層及深層複製操作。"
23282446

23292447
#:../../library/pickle.rst:1220
23302448
msgid""
@@ -2333,6 +2451,9 @@ msgid ""
23332451
"kind of newline characters occurs in persistent IDs, the resulting pickled "
23342452
"data will become unreadable."
23352453
msgstr""
2454+
"協定 0 中限制僅能使用英文字母或數字字元來分配持久化 ID 是因為持久化 ID 是由換"
2455+
"行符號所分隔的。因此，如果持久化 ID 中出現任何形式的換行字元，將導致封裝資料"
2456+
"變得無法讀取。"
23362457

23372458
#:../../library/pickle.rst:12
23382459
msgid"persistence"
@@ -2364,7 +2485,7 @@ msgstr "pickling"
23642485

23652486
#:../../library/pickle.rst:123
23662487
msgid"External Data Representation"
2367-
msgstr"External Data Representation（外部資料表示法）"
2488+
msgstr"External Data Representation（外部資料表現）"
23682489

23692490
#:../../library/pickle.rst:664
23702491
msgid"copy"

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp