iframe-proxy | Sunbelt Computer Software

516 lines (416 loc) · 12.9 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2025
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-01 17:31+0000\n"
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Russian (https://app.transifex.com/python-doc/teams/5390/"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ru\n"
"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || "
"(n%100>=11 && n%100<=14)? 2 : 3);\n"
msgid "Synchronization Primitives"
msgid "**Source code:** :source:`Lib/asyncio/locks.py`"
"asyncio synchronization primitives are designed to be similar to those of "
"the :mod:`threading` module with two important caveats:"
"asyncio primitives are not thread-safe, therefore they should not be used "
"for OS thread synchronization (use :mod:`threading` for that);"
"methods of these synchronization primitives do not accept the *timeout* "
"argument; use the :func:`asyncio.wait_for` function to perform operations "
"with timeouts."
msgid "asyncio has the following basic synchronization primitives:"
msgid ":class:`Lock`"
msgid ":class:`Event`"
msgid ":class:`Condition`"
msgid ":class:`Semaphore`"
msgid ":class:`BoundedSemaphore`"
msgid ":class:`Barrier`"
msgid "Lock"
msgid "Implements a mutex lock for asyncio tasks.  Not thread-safe."
"An asyncio lock can be used to guarantee exclusive access to a shared "
"resource."
msgid "The preferred way to use a Lock is an :keyword:`async with` statement::"
"lock = asyncio.Lock()\n"
"# ... later\n"
"async with lock:\n"
"    # access shared state"
msgid "which is equivalent to::"
"lock = asyncio.Lock()\n"
"# ... later\n"
"await lock.acquire()\n"
"    # access shared state\n"
"finally:\n"
"    lock.release()"
msgid "Removed the *loop* parameter."
msgid "Acquire the lock."
"This method waits until the lock is *unlocked*, sets it to *locked* and "
"returns ``True``."
"When more than one coroutine is blocked in :meth:`acquire` waiting for the "
"lock to be unlocked, only one coroutine eventually proceeds."
"Acquiring a lock is *fair*: the coroutine that proceeds will be the first "
"coroutine that started waiting on the lock."
msgid "Release the lock."
msgid "When the lock is *locked*, reset it to *unlocked* and return."
msgid "If the lock is *unlocked*, a :exc:`RuntimeError` is raised."
msgid "Return ``True`` if the lock is *locked*."
msgid "Event"
msgid "An event object.  Not thread-safe."
"An asyncio event can be used to notify multiple asyncio tasks that some "
"event has happened."
"An Event object manages an internal flag that can be set to *true* with the :"
"meth:`~Event.set` method and reset to *false* with the :meth:`clear` "
"method.  The :meth:`~Event.wait` method blocks until the flag is set to "
"*true*.  The flag is set to *false* initially."
msgid "Example::"
"async def waiter(event):\n"
"    print('waiting for it ...')\n"
"    await event.wait()\n"
"    print('... got it!')\n"
"async def main():\n"
"    # Create an Event object.\n"
"    event = asyncio.Event()\n"
"    # Spawn a Task to wait until 'event' is set.\n"
"    waiter_task = asyncio.create_task(waiter(event))\n"
"    # Sleep for 1 second and set the event.\n"
"    await asyncio.sleep(1)\n"
"    event.set()\n"
"    # Wait until the waiter task is finished.\n"
"    await waiter_task\n"
"asyncio.run(main())"
msgid "Wait until the event is set."
"If the event is set, return ``True`` immediately. Otherwise block until "
"another task calls :meth:`~Event.set`."
msgid "Set the event."
msgid "All tasks waiting for event to be set will be immediately awakened."
msgid "Clear (unset) the event."
"Subsequent tasks awaiting on :meth:`~Event.wait` will now block until the :"
"meth:`~Event.set` method is called again."
msgid "Return ``True`` if the event is set."
msgid "Condition"
msgid "A Condition object.  Not thread-safe."
"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."
"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."
"The optional *lock* argument must be a :class:`Lock` object or ``None``.  In "
"the latter case a new Lock object is created automatically."
"The preferred way to use a Condition is an :keyword:`async with` statement::"
"cond = asyncio.Condition()\n"
"# ... later\n"
"async with cond:\n"
"    await cond.wait()"
"cond = asyncio.Condition()\n"
"# ... later\n"
"await cond.acquire()\n"
"    await cond.wait()\n"
"finally:\n"
"    cond.release()"
msgid "Acquire the underlying lock."
"This method waits until the underlying lock is *unlocked*, sets it to "
"*locked* and returns ``True``."
"Wake up *n* tasks (1 by default) waiting on this condition.  If fewer than "
"*n* tasks are waiting they are all awakened."
"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 "
msgid "Return ``True`` if the underlying lock is acquired."
msgid "Wake up all tasks waiting on this condition."
msgid "This method acts like :meth:`notify`, but wakes up all waiting tasks."
msgid "Release the underlying lock."
msgid "When invoked on an unlocked lock, a :exc:`RuntimeError` is raised."
msgid "Wait until notified."
"If the calling task has not acquired the lock when this method is called, a :"
"exc:`RuntimeError` is raised."
"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``."
"Note that a task *may* return from this call spuriously, which is why the "
"caller should always re-check the state and be prepared to :meth:`~Condition."
"wait` again. For this reason, you may prefer to use :meth:`~Condition."
"wait_for` instead."
msgid "Wait until a predicate becomes *true*."
"The predicate must be a callable which result will be interpreted as a "
"boolean value.  The method will repeatedly :meth:`~Condition.wait` until the "
"predicate evaluates to *true*. The final value is the return value."
msgid "Semaphore"
msgid "A Semaphore object.  Not thread-safe."
"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`."
"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."
"The preferred way to use a Semaphore is an :keyword:`async with` statement::"
"sem = asyncio.Semaphore(10)\n"
"# ... later\n"
"async with sem:\n"
"    # work with shared resource"
"sem = asyncio.Semaphore(10)\n"
"# ... later\n"
"await sem.acquire()\n"
"    # work with shared resource\n"
"finally:\n"
"    sem.release()"
msgid "Acquire a semaphore."
"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``."
msgid "Returns ``True`` if semaphore can not be acquired immediately."
"Release a semaphore, incrementing the internal counter by one. Can wake up a "
"task waiting to acquire the semaphore."
"Unlike :class:`BoundedSemaphore`, :class:`Semaphore` allows making more "
"``release()`` calls than ``acquire()`` calls."
msgid "BoundedSemaphore"
msgid "A bounded semaphore object.  Not thread-safe."
"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*."
msgid "Barrier"
msgid "A barrier object.  Not thread-safe."
"A barrier is a simple synchronization primitive that allows to block until "
"*parties* number of tasks are waiting on it. Tasks can wait on the :meth:"
"`~Barrier.wait` method and would be blocked until the specified number of "
"tasks end up waiting on :meth:`~Barrier.wait`. At that point all of the "
"waiting tasks would unblock simultaneously."
":keyword:`async with` can be used as an alternative to awaiting on :meth:"
"`~Barrier.wait`."
msgid "The barrier can be reused any number of times."
"async def example_barrier():\n"
"   # barrier with 3 parties\n"
"   b = asyncio.Barrier(3)\n"
"   # create 2 new waiting tasks\n"
"   asyncio.create_task(b.wait())\n"
"   asyncio.create_task(b.wait())\n"
"   await asyncio.sleep(0)\n"
"   print(b)\n"
"   # The third .wait() call passes the barrier\n"
"   await b.wait()\n"
"   print(b)\n"
"   print(\"barrier passed\")\n"
"   await asyncio.sleep(0)\n"
"   print(b)\n"
"asyncio.run(example_barrier())"
msgid "Result of this example is::"
"<asyncio.locks.Barrier object at 0x... [filling, waiters:2/3]>\n"
"<asyncio.locks.Barrier object at 0x... [draining, waiters:0/3]>\n"
"barrier passed\n"
"<asyncio.locks.Barrier object at 0x... [filling, waiters:0/3]>"
"Pass the barrier. When all the tasks party to the barrier have called this "
"function, they are all unblocked simultaneously."
"When a waiting or blocked task in the barrier is cancelled, this task exits "
"the barrier which stays in the same state. If the state of the barrier is "
"\"filling\", the number of waiting task decreases by 1."
"The return value is an integer in the range of 0 to ``parties-1``, different "
"for each task. This can be used to select a task to do some special "
"housekeeping, e.g.::"
"async with barrier as position:\n"
"   if position == 0:\n"
"      # Only one task prints this\n"
"      print('End of *draining phase*')"
"This method may raise a :class:`BrokenBarrierError` exception if the barrier "
"is broken or reset while a task is waiting. It could raise a :exc:"
"`CancelledError` if a task is cancelled."
"Return the barrier to the default, empty state.  Any tasks waiting on it "
"will receive the :class:`BrokenBarrierError` exception."
"If a barrier is broken it may be better to just leave it and create a new "
"Put the barrier into a broken state.  This causes any active or future calls "
"to :meth:`~Barrier.wait` to fail with the :class:`BrokenBarrierError`. Use "
"this for example if one of the tasks needs to abort, to avoid infinite "
"waiting tasks."
msgid "The number of tasks required to pass the barrier."
msgid "The number of tasks currently waiting in the barrier while filling."
msgid "A boolean that is ``True`` if the barrier is in the broken state."
"This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:"
"`Barrier` object is reset or broken."
"Acquiring a lock using ``await lock`` or ``yield from lock`` and/or :keyword:"
"`with` statement (``with await lock``, ``with (yield from lock)``) was "
"removed.  Use ``async with lock`` instead."
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

asyncio-sync.po

Latest commit

History

asyncio-sync.po

File metadata and controls
