python-docs-es/library/asyncio-sync.po at update-tutorialpyar · sofide/python-docs-es

352 lines (285 loc) · 9.77 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2019, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/asyncio-sync.rst:7
msgid "Synchronization Primitives"
#: ../Doc/library/asyncio-sync.rst:9
"asyncio synchronization primitives are designed to be similar to those of "
"the :mod:`threading` module with two important caveats:"
#: ../Doc/library/asyncio-sync.rst:12
"asyncio primitives are not thread-safe, therefore they should not be used "
"for OS thread synchronization (use :mod:`threading` for that);"
#: ../Doc/library/asyncio-sync.rst:16
"methods of these synchronization primitives do not accept the *timeout* "
"argument; use the :func:`asyncio.wait_for` function to perform operations "
"with timeouts."
#: ../Doc/library/asyncio-sync.rst:20
msgid "asyncio has the following basic synchronization primitives:"
#: ../Doc/library/asyncio-sync.rst:22
msgid ":class:`Lock`"
#: ../Doc/library/asyncio-sync.rst:23
msgid ":class:`Event`"
#: ../Doc/library/asyncio-sync.rst:24
msgid ":class:`Condition`"
#: ../Doc/library/asyncio-sync.rst:25
msgid ":class:`Semaphore`"
#: ../Doc/library/asyncio-sync.rst:26
msgid ":class:`BoundedSemaphore`"
#: ../Doc/library/asyncio-sync.rst:33
msgid "Lock"
#: ../Doc/library/asyncio-sync.rst:37
msgid "Implements a mutex lock for asyncio tasks.  Not thread-safe."
#: ../Doc/library/asyncio-sync.rst:39
"An asyncio lock can be used to guarantee exclusive access to a shared "
"resource."
#: ../Doc/library/asyncio-sync.rst:42
msgid "The preferred way to use a Lock is an :keyword:`async with` statement::"
#: ../Doc/library/asyncio-sync.rst:51 ../Doc/library/asyncio-sync.rst:178
#: ../Doc/library/asyncio-sync.rst:274
msgid "which is equivalent to::"
#: ../Doc/library/asyncio-sync.rst:64
msgid "Acquire the lock."
#: ../Doc/library/asyncio-sync.rst:66
"This method waits until the lock is *unlocked*, sets it to *locked* and "
"returns ``True``."
#: ../Doc/library/asyncio-sync.rst:71
msgid "Release the lock."
#: ../Doc/library/asyncio-sync.rst:73
msgid "When the lock is *locked*, reset it to *unlocked* and return."
#: ../Doc/library/asyncio-sync.rst:75
msgid "If the lock is *unlocked*, a :exc:`RuntimeError` is raised."
#: ../Doc/library/asyncio-sync.rst:79
msgid "Return ``True`` if the lock is *locked*."
#: ../Doc/library/asyncio-sync.rst:83
msgid "Event"
#: ../Doc/library/asyncio-sync.rst:87
msgid "An event object.  Not thread-safe."
#: ../Doc/library/asyncio-sync.rst:89
"An asyncio event can be used to notify multiple asyncio tasks that some "
"event has happened."
#: ../Doc/library/asyncio-sync.rst:92
"An Event object manages an internal flag that can be set to *true* with the :"
"meth:`set` method and reset to *false* with the :meth:`clear` method.  The :"
"meth:`wait` method blocks until the flag is set to *true*.  The flag is set "
"to *false* initially."
#: ../Doc/library/asyncio-sync.rst:99
msgid "Example::"
#: ../Doc/library/asyncio-sync.rst:124
msgid "Wait until the event is set."
#: ../Doc/library/asyncio-sync.rst:126
"If the event is set, return ``True`` immediately. Otherwise block until "
"another task calls :meth:`set`."
#: ../Doc/library/asyncio-sync.rst:131
msgid "Set the event."
#: ../Doc/library/asyncio-sync.rst:133
msgid "All tasks waiting for event to be set will be immediately awakened."
#: ../Doc/library/asyncio-sync.rst:138
msgid "Clear (unset) the event."
#: ../Doc/library/asyncio-sync.rst:140
"Tasks awaiting on :meth:`wait` will now block until the :meth:`set` method "
"is called again."
#: ../Doc/library/asyncio-sync.rst:145
msgid "Return ``True`` if the event is set."
#: ../Doc/library/asyncio-sync.rst:149
msgid "Condition"
#: ../Doc/library/asyncio-sync.rst:153
msgid "A Condition object.  Not thread-safe."
#: ../Doc/library/asyncio-sync.rst:155
"An asyncio condition primitive can be used by a task to wait for some event "
"to happen and then get exclusive access to a shared resource."
#: ../Doc/library/asyncio-sync.rst:159
"In essence, a Condition object combines the functionality of an :class:"
"`Event` and a :class:`Lock`.  It is possible to have multiple Condition "
"objects share one Lock, which allows coordinating exclusive access to a "
"shared resource between different tasks interested in particular states of "
"that shared resource."
#: ../Doc/library/asyncio-sync.rst:165
"The optional *lock* argument must be a :class:`Lock` object or ``None``.  In "
"the latter case a new Lock object is created automatically."
#: ../Doc/library/asyncio-sync.rst:169
"The preferred way to use a Condition is an :keyword:`async with` statement::"
#: ../Doc/library/asyncio-sync.rst:191
msgid "Acquire the underlying lock."
#: ../Doc/library/asyncio-sync.rst:193
"This method waits until the underlying lock is *unlocked*, sets it to "
"*locked* and returns ``True``."
#: ../Doc/library/asyncio-sync.rst:198
"Wake up at most *n* tasks (1 by default) waiting on this condition.  The "
"method is no-op if no tasks are waiting."
#: ../Doc/library/asyncio-sync.rst:201 ../Doc/library/asyncio-sync.rst:216
"The lock must be acquired before this method is called and released shortly "
"after.  If called with an *unlocked* lock a :exc:`RuntimeError` error is "
#: ../Doc/library/asyncio-sync.rst:207
msgid "Return ``True`` if the underlying lock is acquired."
#: ../Doc/library/asyncio-sync.rst:211
msgid "Wake up all tasks waiting on this condition."
#: ../Doc/library/asyncio-sync.rst:213
msgid "This method acts like :meth:`notify`, but wakes up all waiting tasks."
#: ../Doc/library/asyncio-sync.rst:222
msgid "Release the underlying lock."
#: ../Doc/library/asyncio-sync.rst:224
msgid "When invoked on an unlocked lock, a :exc:`RuntimeError` is raised."
#: ../Doc/library/asyncio-sync.rst:229
msgid "Wait until notified."
#: ../Doc/library/asyncio-sync.rst:231
"If the calling task has not acquired the lock when this method is called, a :"
"exc:`RuntimeError` is raised."
#: ../Doc/library/asyncio-sync.rst:234
"This method releases the underlying lock, and then blocks until it is "
"awakened by a :meth:`notify` or :meth:`notify_all` call. Once awakened, the "
"Condition re-acquires its lock and this method returns ``True``."
#: ../Doc/library/asyncio-sync.rst:241
msgid "Wait until a predicate becomes *true*."
#: ../Doc/library/asyncio-sync.rst:243
"The predicate must be a callable which result will be interpreted as a "
"boolean value.  The final value is the return value."
#: ../Doc/library/asyncio-sync.rst:249
msgid "Semaphore"
#: ../Doc/library/asyncio-sync.rst:253
msgid "A Semaphore object.  Not thread-safe."
#: ../Doc/library/asyncio-sync.rst:255
"A semaphore manages an internal counter which is decremented by each :meth:"
"`acquire` call and incremented by each :meth:`release` call. The counter can "
"never go below zero; when :meth:`acquire` finds that it is zero, it blocks, "
"waiting until some task calls :meth:`release`."
#: ../Doc/library/asyncio-sync.rst:261
"The optional *value* argument gives the initial value for the internal "
"counter (``1`` by default). If the given value is less than ``0`` a :exc:"
"`ValueError` is raised."
#: ../Doc/library/asyncio-sync.rst:265
"The preferred way to use a Semaphore is an :keyword:`async with` statement::"
#: ../Doc/library/asyncio-sync.rst:287
msgid "Acquire a semaphore."
#: ../Doc/library/asyncio-sync.rst:289
"If the internal counter is greater than zero, decrement it by one and return "
"``True`` immediately.  If it is zero, wait until a :meth:`release` is called "
"and return ``True``."
#: ../Doc/library/asyncio-sync.rst:295
msgid "Returns ``True`` if semaphore can not be acquired immediately."
#: ../Doc/library/asyncio-sync.rst:299
"Release a semaphore, incrementing the internal counter by one. Can wake up a "
"task waiting to acquire the semaphore."
#: ../Doc/library/asyncio-sync.rst:302
"Unlike :class:`BoundedSemaphore`, :class:`Semaphore` allows making more "
"``release()`` calls than ``acquire()`` calls."
#: ../Doc/library/asyncio-sync.rst:307
msgid "BoundedSemaphore"
#: ../Doc/library/asyncio-sync.rst:311
msgid "A bounded semaphore object.  Not thread-safe."
#: ../Doc/library/asyncio-sync.rst:313
"Bounded Semaphore is a version of :class:`Semaphore` that raises a :exc:"
"`ValueError` in :meth:`~Semaphore.release` if it increases the internal "
"counter above the initial *value*."
#: ../Doc/library/asyncio-sync.rst:323
"Acquiring a lock using ``await lock`` or ``yield from lock`` and/or :keyword:"
"`with` statement (``with await lock``, ``with (yield from lock)``) is "
"deprecated.  Use ``async with lock`` instead."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

asyncio-sync.po

Latest commit

History

asyncio-sync.po

File metadata and controls
