@@ -13,7 +13,7 @@ msgid ""
1313msgstr ""
1414"Project-Id-Version : Python 3.12\n "
1515"Report-Msgid-Bugs-To : \n "
16- "POT-Creation-Date : 2023-07-28 14:13+0000\n "
16+ "POT-Creation-Date : 2023-08-04 14:13+0000\n "
1717"PO-Revision-Date : 2021-06-28 00:52+0000\n "
1818"Last-Translator : Maciej Olko <maciej.olko@gmail.com>, 2023\n "
1919"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -41,10 +41,11 @@ msgid "Abstract"
4141msgstr "Streszczenie"
4242
4343msgid ""
44- "Argument Clinic is a preprocessor for CPython C files. Its purpose is to "
45- "automate all the boilerplate involved with writing argument parsing code for "
46- "\" builtins\" , module level functions, and class methods. This document is "
47- "divided in four major sections:"
44+ "Argument Clinic is a preprocessor for CPython C files. It was introduced in "
45+ "Python 3.4 with :pep:`436`, in order to provide introspection signatures, "
46+ "and to generate performant and tailor-made boilerplate code for argument "
47+ "parsing in CPython builtins, module level functions, and class methods. This "
48+ "document is divided in four major sections:"
4849msgstr ""
4950
5051msgid ""
@@ -78,58 +79,6 @@ msgstr ""
7879msgid "Background"
7980msgstr ""
8081
81- msgid "The goals of Argument Clinic"
82- msgstr ""
83-
84- msgid ""
85- "Argument Clinic's primary goal is to take over responsibility for all "
86- "argument parsing code inside CPython. This means that, when you convert a "
87- "function to work with Argument Clinic, that function should no longer do any "
88- "of its own argument parsing—the code generated by Argument Clinic should be "
89- "a \" black box\" to you, where CPython calls in at the top, and your code "
90- "gets called at the bottom, with ``PyObject *args`` (and maybe ``PyObject "
91- "*kwargs``) magically converted into the C variables and types you need."
92- msgstr ""
93-
94- msgid ""
95- "In order for Argument Clinic to accomplish its primary goal, it must be easy "
96- "to use. Currently, working with CPython's argument parsing library is a "
97- "chore, requiring maintaining redundant information in a surprising number of "
98- "places. When you use Argument Clinic, you don't have to repeat yourself."
99- msgstr ""
100-
101- msgid ""
102- "Obviously, no one would want to use Argument Clinic unless it's solving "
103- "their problem—and without creating new problems of its own. So it's "
104- "paramount that Argument Clinic generate correct code. It'd be nice if the "
105- "code was faster, too, but at the very least it should not introduce a major "
106- "speed regression. (Eventually Argument Clinic *should* make a major speedup "
107- "possible—we could rewrite its code generator to produce tailor-made argument "
108- "parsing code, rather than calling the general-purpose CPython argument "
109- "parsing library. That would make for the fastest argument parsing possible!)"
110- msgstr ""
111-
112- msgid ""
113- "Additionally, Argument Clinic must be flexible enough to work with any "
114- "approach to argument parsing. Python has some functions with some very "
115- "strange parsing behaviors; Argument Clinic's goal is to support all of them."
116- msgstr ""
117-
118- msgid ""
119- "Finally, the original motivation for Argument Clinic was to provide "
120- "introspection \" signatures\" for CPython builtins. It used to be, the "
121- "introspection query functions would throw an exception if you passed in a "
122- "builtin. With Argument Clinic, that's a thing of the past!"
123- msgstr ""
124-
125- msgid ""
126- "One idea you should keep in mind, as you work with Argument Clinic: the more "
127- "information you give it, the better job it'll be able to do. Argument Clinic "
128- "is admittedly relatively simple right now. But as it evolves it will get "
129- "more sophisticated, and it should be able to do many interesting and smart "
130- "things with all the information you give it."
131- msgstr ""
132-
13382msgid "Basic concepts"
13483msgstr ""
13584
0 commit comments