|
| 1 | +# SOME DESCRIPTIVE TITLE. |
| 2 | +# Copyright (C) 2001 Python Software Foundation |
| 3 | +# This file is distributed under the same license as the Python package. |
| 4 | +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. |
| 5 | +# |
| 6 | +# Translators: |
| 7 | +# Rafael Fontenelle <rffontenelle@gmail.com>, 2025 |
| 8 | +# |
| 9 | +#,fuzzy |
| 10 | +msgid "" |
| 11 | +msgstr "" |
| 12 | +"Project-Id-Version:Python 3.14\n" |
| 13 | +"Report-Msgid-Bugs-To:\n" |
| 14 | +"POT-Creation-Date:2025-07-11 14:21+0000\n" |
| 15 | +"PO-Revision-Date:2025-05-08 06:04+0000\n" |
| 16 | +"Last-Translator:Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n" |
| 17 | +"Language-Team:Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" |
| 18 | +"MIME-Version:1.0\n" |
| 19 | +"Content-Type:text/plain; charset=UTF-8\n" |
| 20 | +"Content-Transfer-Encoding:8bit\n" |
| 21 | +"Language:pl\n" |
| 22 | +"Plural-Forms:nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) &&" |
| 23 | +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 &&" |
| 24 | +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" |
| 25 | + |
| 26 | +msgid"Call Graph Introspection" |
| 27 | +msgstr"" |
| 28 | + |
| 29 | +msgid"**Source code:** :source:`Lib/asyncio/graph.py`" |
| 30 | +msgstr"" |
| 31 | + |
| 32 | +msgid"" |
| 33 | +"asyncio has powerful runtime call graph introspection utilities to trace the " |
| 34 | +"entire call graph of a running *coroutine* or *task*, or a suspended " |
| 35 | +"*future*. These utilities and the underlying machinery can be used from " |
| 36 | +"within a Python program or by external profilers and debuggers." |
| 37 | +msgstr"" |
| 38 | + |
| 39 | +msgid"" |
| 40 | +"Print the async call graph for the current task or the provided :class:" |
| 41 | +"`Task` or :class:`Future`." |
| 42 | +msgstr"" |
| 43 | + |
| 44 | +msgid"" |
| 45 | +"This function prints entries starting from the top frame and going down " |
| 46 | +"towards the invocation point." |
| 47 | +msgstr"" |
| 48 | + |
| 49 | +msgid"" |
| 50 | +"The function receives an optional *future* argument. If not passed, the " |
| 51 | +"current running task will be used." |
| 52 | +msgstr"" |
| 53 | + |
| 54 | +msgid"" |
| 55 | +"If the function is called on *the current task*, the optional keyword-only " |
| 56 | +"*depth* argument can be used to skip the specified number of frames from top " |
| 57 | +"of the stack." |
| 58 | +msgstr"" |
| 59 | + |
| 60 | +msgid"" |
| 61 | +"If the optional keyword-only *limit* argument is provided, each call stack " |
| 62 | +"in the resulting graph is truncated to include at most ``abs(limit)`` " |
| 63 | +"entries. If *limit* is positive, the entries left are the closest to the " |
| 64 | +"invocation point. If *limit* is negative, the topmost entries are left. If " |
| 65 | +"*limit* is omitted or ``None``, all entries are present. If *limit* is " |
| 66 | +"``0``, the call stack is not printed at all, only\"awaited by\" information " |
| 67 | +"is printed." |
| 68 | +msgstr"" |
| 69 | + |
| 70 | +msgid"" |
| 71 | +"If *file* is omitted or ``None``, the function will print to :data:`sys." |
| 72 | +"stdout`." |
| 73 | +msgstr"" |
| 74 | + |
| 75 | +msgid"**Example:**" |
| 76 | +msgstr"" |
| 77 | + |
| 78 | +msgid"The following Python code:" |
| 79 | +msgstr"" |
| 80 | + |
| 81 | +msgid"" |
| 82 | +"import asyncio\n" |
| 83 | +"\n" |
| 84 | +"async def test():\n" |
| 85 | +" asyncio.print_call_graph()\n" |
| 86 | +"\n" |
| 87 | +"async def main():\n" |
| 88 | +" async with asyncio.TaskGroup() as g:\n" |
| 89 | +" g.create_task(test(), name='test')\n" |
| 90 | +"\n" |
| 91 | +"asyncio.run(main())" |
| 92 | +msgstr"" |
| 93 | + |
| 94 | +msgid"will print::" |
| 95 | +msgstr"надрукую::" |
| 96 | + |
| 97 | +msgid"" |
| 98 | +"* Task(name='test', id=0x1039f0fe0)\n" |
| 99 | +"+ Call stack:\n" |
| 100 | +"| File 't2.py', line 4, in async test()\n" |
| 101 | +"+ Awaited by:\n" |
| 102 | +" * Task(name='Task-1', id=0x103a5e060)\n" |
| 103 | +" + Call stack:\n" |
| 104 | +" | File 'taskgroups.py', line 107, in async TaskGroup.__aexit__()\n" |
| 105 | +" | File 't2.py', line 7, in async main()" |
| 106 | +msgstr"" |
| 107 | + |
| 108 | +msgid"" |
| 109 | +"Like :func:`print_call_graph`, but returns a string. If *future* is ``None`` " |
| 110 | +"and there's no current task, the function returns an empty string." |
| 111 | +msgstr"" |
| 112 | + |
| 113 | +msgid"" |
| 114 | +"Capture the async call graph for the current task or the provided :class:" |
| 115 | +"`Task` or :class:`Future`." |
| 116 | +msgstr"" |
| 117 | + |
| 118 | +msgid"" |
| 119 | +"The function receives an optional *future* argument. If not passed, the " |
| 120 | +"current running task will be used. If there's no current task, the function " |
| 121 | +"returns ``None``." |
| 122 | +msgstr"" |
| 123 | + |
| 124 | +msgid"Returns a ``FutureCallGraph`` data class object:" |
| 125 | +msgstr"" |
| 126 | + |
| 127 | +msgid"``FutureCallGraph(future, call_stack, awaited_by)``" |
| 128 | +msgstr"" |
| 129 | + |
| 130 | +msgid"" |
| 131 | +"Where *future* is a reference to a :class:`Future` or a :class:`Task` (or " |
| 132 | +"their subclasses.)" |
| 133 | +msgstr"" |
| 134 | + |
| 135 | +msgid"``call_stack`` is a tuple of ``FrameCallGraphEntry`` objects." |
| 136 | +msgstr"" |
| 137 | + |
| 138 | +msgid"``awaited_by`` is a tuple of ``FutureCallGraph`` objects." |
| 139 | +msgstr"" |
| 140 | + |
| 141 | +msgid"``FrameCallGraphEntry(frame)``" |
| 142 | +msgstr"" |
| 143 | + |
| 144 | +msgid"" |
| 145 | +"Where *frame* is a frame object of a regular Python function in the call " |
| 146 | +"stack." |
| 147 | +msgstr"" |
| 148 | + |
| 149 | +msgid"Low level utility functions" |
| 150 | +msgstr"" |
| 151 | + |
| 152 | +msgid"" |
| 153 | +"To introspect an async call graph asyncio requires cooperation from control " |
| 154 | +"flow structures, such as :func:`shield` or :class:`TaskGroup`. Any time an " |
| 155 | +"intermediate :class:`Future` object with low-level APIs like :meth:`Future." |
| 156 | +"add_done_callback() <asyncio.Future.add_done_callback>` is involved, the " |
| 157 | +"following two functions should be used to inform asyncio about how exactly " |
| 158 | +"such intermediate future objects are connected with the tasks they wrap or " |
| 159 | +"control." |
| 160 | +msgstr"" |
| 161 | + |
| 162 | +msgid"Record that *future* is awaited on by *waiter*." |
| 163 | +msgstr"" |
| 164 | + |
| 165 | +msgid"" |
| 166 | +"Both *future* and *waiter* must be instances of :class:`Future` or :class:" |
| 167 | +"`Task` or their subclasses, otherwise the call would have no effect." |
| 168 | +msgstr"" |
| 169 | + |
| 170 | +msgid"" |
| 171 | +"A call to ``future_add_to_awaited_by()`` must be followed by an eventual " |
| 172 | +"call to the :func:`future_discard_from_awaited_by` function with the same " |
| 173 | +"arguments." |
| 174 | +msgstr"" |
| 175 | + |
| 176 | +msgid"Record that *future* is no longer awaited on by *waiter*." |
| 177 | +msgstr"" |
