update python-newest.library--contextvars/id.po with latest contents from transifex

Author: oonid

python-newest.library--contextvars/id.po

@@ -1,28 +1,29 @@
 # SOME DESCRIPTIVE TITLE.
-# Copyright (C) 2001-2019, Python Software Foundation
+# Copyright (C) 2001 Python Software Foundation
 # This file is distributed under the same license as the Python package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 # 
 # Translators:
-# oon arfiandwi <oon.arfiandwi@gmail.com>, 2019
+# oon arfiandwi <oon.arfiandwi@gmail.com>, 2021
+# Elmo <work.elmoallistair@gmail.com>, 2024
 # 
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: Python 3.8\n"
+"Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2019-09-01 14:24+0000\n"
-"PO-Revision-Date: 2018-06-29 21:06+0000\n"
-"Last-Translator: oon arfiandwi <oon.arfiandwi@gmail.com>, 2019\n"
-"Language-Team: Indonesian (https://www.transifex.com/python-doc/teams/5390/id/)\n"
+"POT-Creation-Date: 2025-05-09 14:19+0000\n"
+"PO-Revision-Date: 2021-06-28 00:57+0000\n"
+"Last-Translator: Elmo <work.elmoallistair@gmail.com>, 2024\n"
+"Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/id/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Language: id\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
 
 #: ../../library/contextvars.rst:2
-msgid ":mod:`contextvars` --- Context Variables"
+msgid ":mod:`!contextvars` --- Context Variables"
 msgstr ""
 
 #: ../../library/contextvars.rst:11
@@ -37,8 +38,8 @@ msgstr ""
 #: ../../library/contextvars.rst:17
 msgid ""
 "Context managers that have state should use Context Variables instead of "
-":func:`threading.local()` to prevent their state from bleeding to other code"
-" unexpectedly, when used in concurrent code."
+":func:`threading.local` to prevent their state from bleeding to other code "
+"unexpectedly, when used in concurrent code."
 msgstr ""
 
 #: ../../library/contextvars.rst:21
@@ -53,6 +54,10 @@ msgstr ""
 msgid "This class is used to declare a new Context Variable, e.g.::"
 msgstr ""
 
+#: ../../library/contextvars.rst:33
+msgid "var: ContextVar[int] = ContextVar('var', default=42)"
+msgstr ""
+
 #: ../../library/contextvars.rst:35
 msgid ""
 "The required *name* parameter is used for introspection and debug purposes."
@@ -128,135 +133,297 @@ msgstr ""
 msgid "For example::"
 msgstr "Sebagai contoh::"
 
+#: ../../library/contextvars.rst:87
+msgid ""
+"var = ContextVar('var')\n"
+"\n"
+"token = var.set('new value')\n"
+"# code that uses 'var'; var.get() returns 'new value'.\n"
+"var.reset(token)\n"
+"\n"
+"# After the reset call the var has no value again, so\n"
+"# var.get() would raise a LookupError."
+msgstr ""
+
 #: ../../library/contextvars.rst:99
 msgid ""
 "*Token* objects are returned by the :meth:`ContextVar.set` method. They can "
 "be passed to the :meth:`ContextVar.reset` method to revert the value of the "
 "variable to what it was before the corresponding *set*."
 msgstr ""
 
-#: ../../library/contextvars.rst:106
+#: ../../library/contextvars.rst:104
+msgid ""
+"The token supports :ref:`context manager protocol <context-managers>` to "
+"restore the corresponding context variable value at the exit from "
+":keyword:`with` block::"
+msgstr ""
+
+#: ../../library/contextvars.rst:108
+msgid ""
+"var = ContextVar('var', default='default value')\n"
+"\n"
+"with var.set('new value'):\n"
+"    assert var.get() == 'new value'\n"
+"\n"
+"assert var.get() == 'default value'"
+msgstr ""
+
+#: ../../library/contextvars.rst:117
+msgid "Added support for usage as a context manager."
+msgstr ""
+
+#: ../../library/contextvars.rst:121
 msgid ""
 "A read-only property.  Points to the :class:`ContextVar` object that created"
 " the token."
 msgstr ""
 
-#: ../../library/contextvars.rst:111
+#: ../../library/contextvars.rst:126
 msgid ""
 "A read-only property.  Set to the value the variable had before the "
 ":meth:`ContextVar.set` method call that created the token. It points to "
-":attr:`Token.MISSING` is the variable was not set before the call."
+":attr:`Token.MISSING` if the variable was not set before the call."
 msgstr ""
 
-#: ../../library/contextvars.rst:118
+#: ../../library/contextvars.rst:133
 msgid "A marker object used by :attr:`Token.old_value`."
 msgstr ""
 
-#: ../../library/contextvars.rst:122
+#: ../../library/contextvars.rst:137
 msgid "Manual Context Management"
 msgstr ""
 
-#: ../../library/contextvars.rst:126
+#: ../../library/contextvars.rst:141
 msgid "Returns a copy of the current :class:`~contextvars.Context` object."
 msgstr ""
 
-#: ../../library/contextvars.rst:128
+#: ../../library/contextvars.rst:143
 msgid ""
 "The following snippet gets a copy of the current context and prints all "
 "variables and their values that are set in it::"
 msgstr ""
 
-#: ../../library/contextvars.rst:134
+#: ../../library/contextvars.rst:146
 msgid ""
-"The function has an O(1) complexity, i.e. works equally fast for contexts "
-"with a few context variables and for contexts that have a lot of them."
+"ctx: Context = copy_context()\n"
+"print(list(ctx.items()))"
 msgstr ""
 
-#: ../../library/contextvars.rst:141
+#: ../../library/contextvars.rst:149
+msgid ""
+"The function has an *O*\\ (1) complexity, i.e. works equally fast for "
+"contexts with a few context variables and for contexts that have a lot of "
+"them."
+msgstr ""
+
+#: ../../library/contextvars.rst:156
 msgid "A mapping of :class:`ContextVars <ContextVar>` to their values."
 msgstr ""
 
-#: ../../library/contextvars.rst:143
+#: ../../library/contextvars.rst:158
 msgid ""
 "``Context()`` creates an empty context with no values in it. To get a copy "
 "of the current context use the :func:`~contextvars.copy_context` function."
 msgstr ""
 
-#: ../../library/contextvars.rst:147
-msgid "Context implements the :class:`collections.abc.Mapping` interface."
+#: ../../library/contextvars.rst:162
+msgid ""
+"Each thread has its own effective stack of :class:`!Context` objects.  The "
+":term:`current context` is the :class:`!Context` object at the top of the "
+"current thread's stack.  All :class:`!Context` objects in the stacks are "
+"considered to be *entered*."
+msgstr ""
+
+#: ../../library/contextvars.rst:167
+msgid ""
+"*Entering* a context, which can be done by calling its :meth:`~Context.run` "
+"method, makes the context the current context by pushing it onto the top of "
+"the current thread's context stack."
 msgstr ""
 
-#: ../../library/contextvars.rst:151
+#: ../../library/contextvars.rst:171
 msgid ""
-"Execute ``callable(*args, **kwargs)`` code in the context object the *run* "
-"method is called on.  Return the result of the execution or propagate an "
-"exception if one occurred."
+"*Exiting* from the current context, which can be done by returning from the "
+"callback passed to the :meth:`~Context.run` method, restores the current "
+"context to what it was before the context was entered by popping the context"
+" off the top of the context stack."
 msgstr ""
 
-#: ../../library/contextvars.rst:155
+#: ../../library/contextvars.rst:176
 msgid ""
-"Any changes to any context variables that *callable* makes will be contained"
-" in the context object::"
+"Since each thread has its own context stack, :class:`ContextVar` objects "
+"behave in a similar fashion to :func:`threading.local` when values are "
+"assigned in different threads."
 msgstr ""
 
-#: ../../library/contextvars.rst:184
+#: ../../library/contextvars.rst:180
 msgid ""
-"The method raises a :exc:`RuntimeError` when called on the same context "
-"object from more than one OS thread, or when called recursively."
+"Attempting to enter an already entered context, including contexts entered "
+"in other threads, raises a :exc:`RuntimeError`."
 msgstr ""
 
-#: ../../library/contextvars.rst:190
+#: ../../library/contextvars.rst:183
+msgid "After exiting a context, it can later be re-entered (from any thread)."
+msgstr ""
+
+#: ../../library/contextvars.rst:185
+msgid ""
+"Any changes to :class:`ContextVar` values via the :meth:`ContextVar.set` "
+"method are recorded in the current context.  The :meth:`ContextVar.get` "
+"method returns the value associated with the current context.  Exiting a "
+"context effectively reverts any changes made to context variables while the "
+"context was entered (if needed, the values can be restored by re-entering "
+"the context)."
+msgstr ""
+
+#: ../../library/contextvars.rst:192
+msgid "Context implements the :class:`collections.abc.Mapping` interface."
+msgstr ""
+
+#: ../../library/contextvars.rst:196
+msgid ""
+"Enters the Context, executes ``callable(*args, **kwargs)``, then exits the "
+"Context.  Returns *callable*'s return value, or propagates an exception if "
+"one occurred."
+msgstr ""
+
+#: ../../library/contextvars.rst:200
+msgid "Example:"
+msgstr "Contoh:"
+
+#: ../../library/contextvars.rst:202
+msgid ""
+"import contextvars\n"
+"\n"
+"var = contextvars.ContextVar('var')\n"
+"var.set('spam')\n"
+"print(var.get())  # 'spam'\n"
+"\n"
+"ctx = contextvars.copy_context()\n"
+"\n"
+"def main():\n"
+"    # 'var' was set to 'spam' before\n"
+"    # calling 'copy_context()' and 'ctx.run(main)', so:\n"
+"    print(var.get())  # 'spam'\n"
+"    print(ctx[var])  # 'spam'\n"
+"\n"
+"    var.set('ham')\n"
+"\n"
+"    # Now, after setting 'var' to 'ham':\n"
+"    print(var.get())  # 'ham'\n"
+"    print(ctx[var])  # 'ham'\n"
+"\n"
+"# Any changes that the 'main' function makes to 'var'\n"
+"# will be contained in 'ctx'.\n"
+"ctx.run(main)\n"
+"\n"
+"# The 'main()' function was run in the 'ctx' context,\n"
+"# so changes to 'var' are contained in it:\n"
+"print(ctx[var])  # 'ham'\n"
+"\n"
+"# However, outside of 'ctx', 'var' is still set to 'spam':\n"
+"print(var.get())  # 'spam'"
+msgstr ""
+
+#: ../../library/contextvars.rst:248
 msgid "Return a shallow copy of the context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:194
+#: ../../library/contextvars.rst:252
 msgid ""
 "Return ``True`` if the *context* has a value for *var* set; return ``False``"
 " otherwise."
 msgstr ""
 
-#: ../../library/contextvars.rst:199
+#: ../../library/contextvars.rst:257
 msgid ""
 "Return the value of the *var* :class:`ContextVar` variable. If the variable "
 "is not set in the context object, a :exc:`KeyError` is raised."
 msgstr ""
 
-#: ../../library/contextvars.rst:205
+#: ../../library/contextvars.rst:263
 msgid ""
 "Return the value for *var* if *var* has the value in the context object.  "
 "Return *default* otherwise.  If *default* is not given, return ``None``."
 msgstr ""
 
-#: ../../library/contextvars.rst:211
+#: ../../library/contextvars.rst:269
 msgid "Return an iterator over the variables stored in the context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:216
+#: ../../library/contextvars.rst:274
 msgid "Return the number of variables set in the context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:220
+#: ../../library/contextvars.rst:278
 msgid "Return a list of all variables in the context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:224
+#: ../../library/contextvars.rst:282
 msgid "Return a list of all variables' values in the context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:229
+#: ../../library/contextvars.rst:287
 msgid ""
 "Return a list of 2-tuples containing all variables and their values in the "
 "context object."
 msgstr ""
 
-#: ../../library/contextvars.rst:234
+#: ../../library/contextvars.rst:292
 msgid "asyncio support"
 msgstr ""
 
-#: ../../library/contextvars.rst:236
+#: ../../library/contextvars.rst:294
 msgid ""
 "Context variables are natively supported in :mod:`asyncio` and are ready to "
 "be used without any extra configuration.  For example, here is a simple echo"
 " server, that uses a context variable to make the address of a remote client"
 " available in the Task that handles that client::"
 msgstr ""
+
+#: ../../library/contextvars.rst:300
+msgid ""
+"import asyncio\n"
+"import contextvars\n"
+"\n"
+"client_addr_var = contextvars.ContextVar('client_addr')\n"
+"\n"
+"def render_goodbye():\n"
+"    # The address of the currently handled client can be accessed\n"
+"    # without passing it explicitly to this function.\n"
+"\n"
+"    client_addr = client_addr_var.get()\n"
+"    return f'Good bye, client @ {client_addr}\\r\\n'.encode()\n"
+"\n"
+"async def handle_request(reader, writer):\n"
+"    addr = writer.transport.get_extra_info('socket').getpeername()\n"
+"    client_addr_var.set(addr)\n"
+"\n"
+"    # In any code that we call is now possible to get\n"
+"    # client's address by calling 'client_addr_var.get()'.\n"
+"\n"
+"    while True:\n"
+"        line = await reader.readline()\n"
+"        print(line)\n"
+"        if not line.strip():\n"
+"            break\n"
+"\n"
+"    writer.write(b'HTTP/1.1 200 OK\\r\\n')  # status line\n"
+"    writer.write(b'\\r\\n')  # headers\n"
+"    writer.write(render_goodbye())  # body\n"
+"    writer.close()\n"
+"\n"
+"async def main():\n"
+"    srv = await asyncio.start_server(\n"
+"        handle_request, '127.0.0.1', 8081)\n"
+"\n"
+"    async with srv:\n"
+"        await srv.serve_forever()\n"
+"\n"
+"asyncio.run(main())\n"
+"\n"
+"# To test it you can use telnet or curl:\n"
+"#     telnet 127.0.0.1 8081\n"
+"#     curl 127.0.0.1:8081"
+msgstr ""