python-docs-es/library/asyncio-task.po at tkinter.po · python/python-docs-es

958 lines (786 loc) · 27.7 KB
# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
# Maintained by the python-doc-es workteam.
# docs-es@python.org /
# https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to
# get the list of volunteers
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-05-05 12:54+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: python-doc-es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.8.0\n"
#: ../Doc/library/asyncio-task.rst:6
msgid "Coroutines and Tasks"
#: ../Doc/library/asyncio-task.rst:8
"This section outlines high-level asyncio APIs to work with coroutines and "
#: ../Doc/library/asyncio-task.rst:19 ../Doc/library/asyncio-task.rst:121
msgid "Coroutines"
#: ../Doc/library/asyncio-task.rst:21
":term:`Coroutines <coroutine>` declared with the async/await syntax is the "
"preferred way of writing asyncio applications.  For example, the following "
"snippet of code (requires Python 3.7+) prints \"hello\", waits 1 second, and "
"then prints \"world\"::"
#: ../Doc/library/asyncio-task.rst:37
"Note that simply calling a coroutine will not schedule it to be executed::"
#: ../Doc/library/asyncio-task.rst:43
msgid "To actually run a coroutine, asyncio provides three main mechanisms:"
#: ../Doc/library/asyncio-task.rst:45
"The :func:`asyncio.run` function to run the top-level entry point \"main()\" "
"function (see the above example.)"
#: ../Doc/library/asyncio-task.rst:48
"Awaiting on a coroutine.  The following snippet of code will print \"hello\" "
"after waiting for 1 second, and then print \"world\" after waiting for "
"*another* 2 seconds::"
#: ../Doc/library/asyncio-task.rst:69
msgid "Expected output::"
#: ../Doc/library/asyncio-task.rst:76
"The :func:`asyncio.create_task` function to run coroutines concurrently as "
"asyncio :class:`Tasks <Task>`."
#: ../Doc/library/asyncio-task.rst:79
"Let's modify the above example and run two ``say_after`` coroutines "
"*concurrently*::"
#: ../Doc/library/asyncio-task.rst:98
"Note that expected output now shows that the snippet runs 1 second faster "
"than before::"
#: ../Doc/library/asyncio-task.rst:110
msgid "Awaitables"
#: ../Doc/library/asyncio-task.rst:112
"We say that an object is an **awaitable** object if it can be used in an :"
"keyword:`await` expression.  Many asyncio APIs are designed to accept "
"awaitables."
#: ../Doc/library/asyncio-task.rst:116
"There are three main types of *awaitable* objects: **coroutines**, "
"**Tasks**, and **Futures**."
#: ../Doc/library/asyncio-task.rst:122
"Python coroutines are *awaitables* and therefore can be awaited from other "
"coroutines::"
#: ../Doc/library/asyncio-task.rst:143
"In this documentation the term \"coroutine\" can be used for two closely "
"related concepts:"
#: ../Doc/library/asyncio-task.rst:146
msgid "a *coroutine function*: an :keyword:`async def` function;"
#: ../Doc/library/asyncio-task.rst:148
"a *coroutine object*: an object returned by calling a *coroutine function*."
#: ../Doc/library/asyncio-task.rst:151
"asyncio also supports legacy :ref:`generator-based "
"<asyncio_generator_based_coro>` coroutines."
#: ../Doc/library/asyncio-task.rst:156
msgid "Tasks"
#: ../Doc/library/asyncio-task.rst:157
msgid "*Tasks* are used to schedule coroutines *concurrently*."
#: ../Doc/library/asyncio-task.rst:159
"When a coroutine is wrapped into a *Task* with functions like :func:`asyncio."
"create_task` the coroutine is automatically scheduled to run soon::"
#: ../Doc/library/asyncio-task.rst:181
msgid "Futures"
#: ../Doc/library/asyncio-task.rst:182
"A :class:`Future` is a special **low-level** awaitable object that "
"represents an **eventual result** of an asynchronous operation."
#: ../Doc/library/asyncio-task.rst:185
"When a Future object is *awaited* it means that the coroutine will wait "
"until the Future is resolved in some other place."
#: ../Doc/library/asyncio-task.rst:188
"Future objects in asyncio are needed to allow callback-based code to be used "
"with async/await."
#: ../Doc/library/asyncio-task.rst:191
"Normally **there is no need** to create Future objects at the application "
"level code."
#: ../Doc/library/asyncio-task.rst:194
"Future objects, sometimes exposed by libraries and some asyncio APIs, can be "
"awaited::"
#: ../Doc/library/asyncio-task.rst:206
"A good example of a low-level function that returns a Future object is :meth:"
"`loop.run_in_executor`."
#: ../Doc/library/asyncio-task.rst:211
msgid "Running an asyncio Program"
#: ../Doc/library/asyncio-task.rst:215
msgid "Execute the :term:`coroutine` *coro* and return the result."
#: ../Doc/library/asyncio-task.rst:217
"This function runs the passed coroutine, taking care of managing the asyncio "
"event loop and *finalizing asynchronous generators*."
#: ../Doc/library/asyncio-task.rst:221
"This function cannot be called when another asyncio event loop is running in "
"the same thread."
#: ../Doc/library/asyncio-task.rst:224
msgid "If *debug* is ``True``, the event loop will be run in debug mode."
#: ../Doc/library/asyncio-task.rst:226
"This function always creates a new event loop and closes it at the end.  It "
"should be used as a main entry point for asyncio programs, and should "
"ideally only be called once."
#: ../Doc/library/asyncio-task.rst:230 ../Doc/library/asyncio-task.rst:354
#: ../Doc/library/asyncio-task.rst:463 ../Doc/library/asyncio-task.rst:593
msgid "Example::"
#: ../Doc/library/asyncio-task.rst:242
"The source code for ``asyncio.run()`` can be found in :source:`Lib/asyncio/"
"runners.py`."
#: ../Doc/library/asyncio-task.rst:246
msgid "Creating Tasks"
#: ../Doc/library/asyncio-task.rst:250
"Wrap the *coro* :ref:`coroutine <coroutine>` into a :class:`Task` and "
"schedule its execution.  Return the Task object."
#: ../Doc/library/asyncio-task.rst:253
"If *name* is not ``None``, it is set as the name of the task using :meth:"
"`Task.set_name`."
#: ../Doc/library/asyncio-task.rst:256
"The task is executed in the loop returned by :func:`get_running_loop`, :exc:"
"`RuntimeError` is raised if there is no running loop in current thread."
#: ../Doc/library/asyncio-task.rst:260
"This function has been **added in Python 3.7**.  Prior to Python 3.7, the "
"low-level :func:`asyncio.ensure_future` function can be used instead::"
#: ../Doc/library/asyncio-task.rst:277 ../Doc/library/asyncio-task.rst:716
msgid "Added the ``name`` parameter."
#: ../Doc/library/asyncio-task.rst:282
msgid "Sleeping"
#: ../Doc/library/asyncio-task.rst:286
msgid "Block for *delay* seconds."
#: ../Doc/library/asyncio-task.rst:288
"If *result* is provided, it is returned to the caller when the coroutine "
"completes."
#: ../Doc/library/asyncio-task.rst:291
"``sleep()`` always suspends the current task, allowing other tasks to run."
#: ../Doc/library/asyncio-task.rst:296 ../Doc/library/asyncio-task.rst:351
#: ../Doc/library/asyncio-task.rst:430 ../Doc/library/asyncio-task.rst:460
#: ../Doc/library/asyncio-task.rst:545 ../Doc/library/asyncio-task.rst:592
#: ../Doc/library/asyncio-task.rst:721
msgid "The *loop* parameter."
#: ../Doc/library/asyncio-task.rst:299
"Example of coroutine displaying the current date every second for 5 seconds::"
#: ../Doc/library/asyncio-task.rst:318
msgid "Running Tasks Concurrently"
#: ../Doc/library/asyncio-task.rst:322
"Run :ref:`awaitable objects <asyncio-awaitables>` in the *aws* sequence "
"*concurrently*."
#: ../Doc/library/asyncio-task.rst:325
"If any awaitable in *aws* is a coroutine, it is automatically scheduled as a "
#: ../Doc/library/asyncio-task.rst:328
"If all awaitables are completed successfully, the result is an aggregate "
"list of returned values.  The order of result values corresponds to the "
"order of awaitables in *aws*."
#: ../Doc/library/asyncio-task.rst:332
"If *return_exceptions* is ``False`` (default), the first raised exception is "
"immediately propagated to the task that awaits on ``gather()``.  Other "
"awaitables in the *aws* sequence **won't be cancelled** and will continue to "
#: ../Doc/library/asyncio-task.rst:337
"If *return_exceptions* is ``True``, exceptions are treated the same as "
"successful results, and aggregated in the result list."
#: ../Doc/library/asyncio-task.rst:340
"If ``gather()`` is *cancelled*, all submitted awaitables (that have not "
"completed yet) are also *cancelled*."
#: ../Doc/library/asyncio-task.rst:343
"If any Task or Future from the *aws* sequence is *cancelled*, it is treated "
"as if it raised :exc:`CancelledError` -- the ``gather()`` call is **not** "
"cancelled in this case.  This is to prevent the cancellation of one "
"submitted Task/Future to cause other Tasks/Futures to be cancelled."
#: ../Doc/library/asyncio-task.rst:388
"If the *gather* itself is cancelled, the cancellation is propagated "
"regardless of *return_exceptions*."
#: ../Doc/library/asyncio-task.rst:394
msgid "Shielding From Cancellation"
#: ../Doc/library/asyncio-task.rst:398
"Protect an :ref:`awaitable object <asyncio-awaitables>` from being :meth:"
"`cancelled <Task.cancel>`."
#: ../Doc/library/asyncio-task.rst:401 ../Doc/library/asyncio-task.rst:441
msgid "If *aw* is a coroutine it is automatically scheduled as a Task."
#: ../Doc/library/asyncio-task.rst:403
msgid "The statement::"
#: ../Doc/library/asyncio-task.rst:407
msgid "is equivalent to::"
#: ../Doc/library/asyncio-task.rst:411
"*except* that if the coroutine containing it is cancelled, the Task running "
"in ``something()`` is not cancelled.  From the point of view of "
"``something()``, the cancellation did not happen. Although its caller is "
"still cancelled, so the \"await\" expression still raises a :exc:"
"`CancelledError`."
#: ../Doc/library/asyncio-task.rst:417
"If ``something()`` is cancelled by other means (i.e. from within itself) "
"that would also cancel ``shield()``."
#: ../Doc/library/asyncio-task.rst:420
"If it is desired to completely ignore cancellation (not recommended) the "
"``shield()`` function should be combined with a try/except clause, as "
"follows::"
#: ../Doc/library/asyncio-task.rst:434
msgid "Timeouts"
#: ../Doc/library/asyncio-task.rst:438
"Wait for the *aw* :ref:`awaitable <asyncio-awaitables>` to complete with a "
#: ../Doc/library/asyncio-task.rst:443
"*timeout* can either be ``None`` or a float or int number of seconds to wait "
"for.  If *timeout* is ``None``, block until the future completes."
#: ../Doc/library/asyncio-task.rst:447
"If a timeout occurs, it cancels the task and raises :exc:`asyncio."
"TimeoutError`."
#: ../Doc/library/asyncio-task.rst:450
"To avoid the task :meth:`cancellation <Task.cancel>`, wrap it in :func:"
"`shield`."
#: ../Doc/library/asyncio-task.rst:453
"The function will wait until the future is actually cancelled, so the total "
"wait time may exceed the *timeout*."
#: ../Doc/library/asyncio-task.rst:456
msgid "If the wait is cancelled, the future *aw* is also cancelled."
#: ../Doc/library/asyncio-task.rst:483
"When *aw* is cancelled due to a timeout, ``wait_for`` waits for *aw* to be "
"cancelled.  Previously, it raised :exc:`asyncio.TimeoutError` immediately."
#: ../Doc/library/asyncio-task.rst:490
msgid "Waiting Primitives"
#: ../Doc/library/asyncio-task.rst:495
"Run :ref:`awaitable objects <asyncio-awaitables>` in the *aws* set "
"concurrently and block until the condition specified by *return_when*."
#: ../Doc/library/asyncio-task.rst:499
msgid "Returns two sets of Tasks/Futures: ``(done, pending)``."
#: ../Doc/library/asyncio-task.rst:501
msgid "Usage::"
#: ../Doc/library/asyncio-task.rst:505
"*timeout* (a float or int), if specified, can be used to control the maximum "
"number of seconds to wait before returning."
#: ../Doc/library/asyncio-task.rst:508
"Note that this function does not raise :exc:`asyncio.TimeoutError`. Futures "
"or Tasks that aren't done when the timeout occurs are simply returned in the "
"second set."
#: ../Doc/library/asyncio-task.rst:512
"*return_when* indicates when this function should return.  It must be one of "
"the following constants:"
#: ../Doc/library/asyncio-task.rst:518
msgid "Constant"
#: ../Doc/library/asyncio-task.rst:518
msgid "Description"
#: ../Doc/library/asyncio-task.rst:520
msgid ":const:`FIRST_COMPLETED`"
#: ../Doc/library/asyncio-task.rst:520
msgid "The function will return when any future finishes or is cancelled."
#: ../Doc/library/asyncio-task.rst:523
msgid ":const:`FIRST_EXCEPTION`"
#: ../Doc/library/asyncio-task.rst:523
"The function will return when any future finishes by raising an exception.  "
"If no future raises an exception then it is equivalent to :const:"
"`ALL_COMPLETED`."
#: ../Doc/library/asyncio-task.rst:529
msgid ":const:`ALL_COMPLETED`"
#: ../Doc/library/asyncio-task.rst:529
msgid "The function will return when all futures finish or are cancelled."
#: ../Doc/library/asyncio-task.rst:533
"Unlike :func:`~asyncio.wait_for`, ``wait()`` does not cancel the futures "
"when a timeout occurs."
#: ../Doc/library/asyncio-task.rst:538
"If any awaitable in *aws* is a coroutine, it is automatically scheduled as a "
"Task.  Passing coroutines objects to ``wait()`` directly is deprecated as it "
"leads to :ref:`confusing behavior <asyncio_example_wait_coroutine>`."
#: ../Doc/library/asyncio-task.rst:550
"``wait()`` schedules coroutines as Tasks automatically and later returns "
"those implicitly created Task objects in ``(done, pending)`` sets.  "
"Therefore the following code won't work as expected::"
#: ../Doc/library/asyncio-task.rst:563
msgid "Here is how the above snippet can be fixed::"
#: ../Doc/library/asyncio-task.rst:576
msgid "Passing coroutine objects to ``wait()`` directly is deprecated."
#: ../Doc/library/asyncio-task.rst:582
"Run :ref:`awaitable objects <asyncio-awaitables>` in the *aws* set "
"concurrently.  Return an iterator of :class:`Future` objects. Each Future "
"object returned represents the earliest result from the set of the remaining "
"awaitables."
#: ../Doc/library/asyncio-task.rst:587
"Raises :exc:`asyncio.TimeoutError` if the timeout occurs before all Futures "
"are done."
#: ../Doc/library/asyncio-task.rst:601
msgid "Scheduling From Other Threads"
#: ../Doc/library/asyncio-task.rst:605
msgid "Submit a coroutine to the given event loop.  Thread-safe."
#: ../Doc/library/asyncio-task.rst:607
"Return a :class:`concurrent.futures.Future` to wait for the result from "
"another OS thread."
#: ../Doc/library/asyncio-task.rst:610
"This function is meant to be called from a different OS thread than the one "
"where the event loop is running.  Example::"
#: ../Doc/library/asyncio-task.rst:622
"If an exception is raised in the coroutine, the returned Future will be "
"notified.  It can also be used to cancel the task in the event loop::"
#: ../Doc/library/asyncio-task.rst:636
"See the :ref:`concurrency and multithreading <asyncio-multithreading>` "
"section of the documentation."
#: ../Doc/library/asyncio-task.rst:639
"Unlike other asyncio functions this function requires the *loop* argument to "
"be passed explicitly."
#: ../Doc/library/asyncio-task.rst:646
msgid "Introspection"
#: ../Doc/library/asyncio-task.rst:651
"Return the currently running :class:`Task` instance, or ``None`` if no task "
"is running."
#: ../Doc/library/asyncio-task.rst:654
"If *loop* is ``None`` :func:`get_running_loop` is used to get the current "
#: ../Doc/library/asyncio-task.rst:662
msgid "Return a set of not yet finished :class:`Task` objects run by the loop."
#: ../Doc/library/asyncio-task.rst:665
"If *loop* is ``None``, :func:`get_running_loop` is used for getting current "
#: ../Doc/library/asyncio-task.rst:672
msgid "Task Object"
#: ../Doc/library/asyncio-task.rst:676
"A :class:`Future-like <Future>` object that runs a Python :ref:`coroutine "
"<coroutine>`.  Not thread-safe."
#: ../Doc/library/asyncio-task.rst:679
"Tasks are used to run coroutines in event loops. If a coroutine awaits on a "
"Future, the Task suspends the execution of the coroutine and waits for the "
"completion of the Future.  When the Future is *done*, the execution of the "
"wrapped coroutine resumes."
#: ../Doc/library/asyncio-task.rst:685
"Event loops use cooperative scheduling: an event loop runs one Task at a "
"time.  While a Task awaits for the completion of a Future, the event loop "
"runs other Tasks, callbacks, or performs IO operations."
#: ../Doc/library/asyncio-task.rst:690
"Use the high-level :func:`asyncio.create_task` function to create Tasks, or "
"the low-level :meth:`loop.create_task` or :func:`ensure_future` functions.  "
"Manual instantiation of Tasks is discouraged."
#: ../Doc/library/asyncio-task.rst:695
"To cancel a running Task use the :meth:`cancel` method.  Calling it will "
"cause the Task to throw a :exc:`CancelledError` exception into the wrapped "
"coroutine.  If a coroutine is awaiting on a Future object during "
"cancellation, the Future object will be cancelled."
#: ../Doc/library/asyncio-task.rst:700
":meth:`cancelled` can be used to check if the Task was cancelled. The method "
"returns ``True`` if the wrapped coroutine did not suppress the :exc:"
"`CancelledError` exception and was actually cancelled."
#: ../Doc/library/asyncio-task.rst:705
":class:`asyncio.Task` inherits from :class:`Future` all of its APIs except :"
"meth:`Future.set_result` and :meth:`Future.set_exception`."
#: ../Doc/library/asyncio-task.rst:709
"Tasks support the :mod:`contextvars` module.  When a Task is created it "
"copies the current context and later runs its coroutine in the copied "
#: ../Doc/library/asyncio-task.rst:713
msgid "Added support for the :mod:`contextvars` module."
#: ../Doc/library/asyncio-task.rst:724
msgid "Request the Task to be cancelled."
#: ../Doc/library/asyncio-task.rst:726
"This arranges for a :exc:`CancelledError` exception to be thrown into the "
"wrapped coroutine on the next cycle of the event loop."
#: ../Doc/library/asyncio-task.rst:729
"The coroutine then has a chance to clean up or even deny the request by "
"suppressing the exception with a :keyword:`try` ... ... ``except "
"CancelledError`` ... :keyword:`finally` block. Therefore, unlike :meth:"
"`Future.cancel`, :meth:`Task.cancel` does not guarantee that the Task will "
"be cancelled, although suppressing cancellation completely is not common and "
"is actively discouraged."
#: ../Doc/library/asyncio-task.rst:739
"The following example illustrates how coroutines can intercept the "
"cancellation request::"
#: ../Doc/library/asyncio-task.rst:778
msgid "Return ``True`` if the Task is *cancelled*."
#: ../Doc/library/asyncio-task.rst:780
"The Task is *cancelled* when the cancellation was requested with :meth:"
"`cancel` and the wrapped coroutine propagated the :exc:`CancelledError` "
"exception thrown into it."
#: ../Doc/library/asyncio-task.rst:786
msgid "Return ``True`` if the Task is *done*."
#: ../Doc/library/asyncio-task.rst:788
"A Task is *done* when the wrapped coroutine either returned a value, raised "
"an exception, or the Task was cancelled."
#: ../Doc/library/asyncio-task.rst:793
msgid "Return the result of the Task."
#: ../Doc/library/asyncio-task.rst:795
"If the Task is *done*, the result of the wrapped coroutine is returned (or "
"if the coroutine raised an exception, that exception is re-raised.)"
#: ../Doc/library/asyncio-task.rst:799 ../Doc/library/asyncio-task.rst:813
"If the Task has been *cancelled*, this method raises a :exc:`CancelledError` "
"exception."
#: ../Doc/library/asyncio-task.rst:802
"If the Task's result isn't yet available, this method raises a :exc:"
"`InvalidStateError` exception."
#: ../Doc/library/asyncio-task.rst:807
msgid "Return the exception of the Task."
#: ../Doc/library/asyncio-task.rst:809
"If the wrapped coroutine raised an exception that exception is returned.  If "
"the wrapped coroutine returned normally this method returns ``None``."
#: ../Doc/library/asyncio-task.rst:816
"If the Task isn't *done* yet, this method raises an :exc:`InvalidStateError` "
"exception."
#: ../Doc/library/asyncio-task.rst:821
msgid "Add a callback to be run when the Task is *done*."
#: ../Doc/library/asyncio-task.rst:823 ../Doc/library/asyncio-task.rst:832
msgid "This method should only be used in low-level callback-based code."
#: ../Doc/library/asyncio-task.rst:825
"See the documentation of :meth:`Future.add_done_callback` for more details."
#: ../Doc/library/asyncio-task.rst:830
msgid "Remove *callback* from the callbacks list."
#: ../Doc/library/asyncio-task.rst:834
"See the documentation of :meth:`Future.remove_done_callback` for more "
#: ../Doc/library/asyncio-task.rst:839
msgid "Return the list of stack frames for this Task."
#: ../Doc/library/asyncio-task.rst:841
"If the wrapped coroutine is not done, this returns the stack where it is "
"suspended.  If the coroutine has completed successfully or was cancelled, "
"this returns an empty list. If the coroutine was terminated by an exception, "
"this returns the list of traceback frames."
#: ../Doc/library/asyncio-task.rst:847
msgid "The frames are always ordered from oldest to newest."
#: ../Doc/library/asyncio-task.rst:849
msgid "Only one stack frame is returned for a suspended coroutine."
#: ../Doc/library/asyncio-task.rst:851
"The optional *limit* argument sets the maximum number of frames to return; "
"by default all available frames are returned. The ordering of the returned "
"list differs depending on whether a stack or a traceback is returned: the "
"newest frames of a stack are returned, but the oldest frames of a traceback "
"are returned.  (This matches the behavior of the traceback module.)"
#: ../Doc/library/asyncio-task.rst:860
msgid "Print the stack or traceback for this Task."
#: ../Doc/library/asyncio-task.rst:862
"This produces output similar to that of the traceback module for the frames "
"retrieved by :meth:`get_stack`."
#: ../Doc/library/asyncio-task.rst:865
msgid "The *limit* argument is passed to :meth:`get_stack` directly."
#: ../Doc/library/asyncio-task.rst:867
"The *file* argument is an I/O stream to which the output is written; by "
"default output is written to :data:`sys.stderr`."
#: ../Doc/library/asyncio-task.rst:872
msgid "Return the coroutine object wrapped by the :class:`Task`."
#: ../Doc/library/asyncio-task.rst:878
msgid "Return the name of the Task."
#: ../Doc/library/asyncio-task.rst:880
"If no name has been explicitly assigned to the Task, the default asyncio "
"Task implementation generates a default name during instantiation."
#: ../Doc/library/asyncio-task.rst:888
msgid "Set the name of the Task."
#: ../Doc/library/asyncio-task.rst:890
"The *value* argument can be any object, which is then converted to a string."
#: ../Doc/library/asyncio-task.rst:893
"In the default Task implementation, the name will be visible in the :func:"
"`repr` output of a task object."
#: ../Doc/library/asyncio-task.rst:900
msgid "Return a set of all tasks for an event loop."
#: ../Doc/library/asyncio-task.rst:902
"By default all tasks for the current event loop are returned. If *loop* is "
"``None``, the :func:`get_event_loop` function is used to get the current "
#: ../Doc/library/asyncio-task.rst:908
"Do not call this as a task method. Use the :func:`asyncio.all_tasks` "
"function instead."
#: ../Doc/library/asyncio-task.rst:913
msgid "Return the currently running task or ``None``."
#: ../Doc/library/asyncio-task.rst:915
"If *loop* is ``None``, the :func:`get_event_loop` function is used to get "
"the current loop."
#: ../Doc/library/asyncio-task.rst:920
"Do not call this as a task method.  Use the :func:`asyncio.current_task` "
"function instead."
#: ../Doc/library/asyncio-task.rst:927
msgid "Generator-based Coroutines"
#: ../Doc/library/asyncio-task.rst:931
"Support for generator-based coroutines is **deprecated** and is scheduled "
"for removal in Python 3.10."
#: ../Doc/library/asyncio-task.rst:934
"Generator-based coroutines predate async/await syntax.  They are Python "
"generators that use ``yield from`` expressions to await on Futures and other "
"coroutines."
#: ../Doc/library/asyncio-task.rst:938
"Generator-based coroutines should be decorated with :func:`@asyncio."
"coroutine <asyncio.coroutine>`, although this is not enforced."
#: ../Doc/library/asyncio-task.rst:945
msgid "Decorator to mark generator-based coroutines."
#: ../Doc/library/asyncio-task.rst:947
"This decorator enables legacy generator-based coroutines to be compatible "
"with async/await code::"
#: ../Doc/library/asyncio-task.rst:957
msgid "This decorator should not be used for :keyword:`async def` coroutines."
#: ../Doc/library/asyncio-task.rst:962
msgid "Use :keyword:`async def` instead."
#: ../Doc/library/asyncio-task.rst:966
msgid "Return ``True`` if *obj* is a :ref:`coroutine object <coroutine>`."
#: ../Doc/library/asyncio-task.rst:968
"This method is different from :func:`inspect.iscoroutine` because it returns "
"``True`` for generator-based coroutines."
#: ../Doc/library/asyncio-task.rst:973
msgid "Return ``True`` if *func* is a :ref:`coroutine function <coroutine>`."
#: ../Doc/library/asyncio-task.rst:976
"This method is different from :func:`inspect.iscoroutinefunction` because it "
"returns ``True`` for generator-based coroutine functions decorated with :"
"func:`@coroutine <coroutine>`."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

asyncio-task.po

Latest commit

History

asyncio-task.po

File metadata and controls
