<div dir="ltr"><br><br><div class="gmail_quote"><div dir="ltr">On Thu, 4 Aug 2016 at 09:14 Alexander Belopolsky <<a href="mailto:alexander.belopolsky@gmail.com">alexander.belopolsky@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">What is the current status of the Argument Clinic DSL?  The clinic<br>
preprocessor was released [1] with Python 3.4 with a promise [2] "that<br>
signature metadata for programmatic introspection will be added to<br>
additional callables implemented in C as part of Python 3.4<br>
maintenance releases."  We are now close to 3.6 beta and clinic<br>
coverage in stdlib is sparse at best.  For example, the math module<br>
makes no use of the clinic (but interestingly a few methods in cmath<br>
do).  The documentation is very sparse as well.  While one would<br>
expect PEP 436 to serve as *the* documentation while clinic is being<br>
developed, but the PEP has the "Draft" status and has not been updated<br>
since 2013.  Furthermore, the 3.4 release notes contain a warning<br>
saying "The Argument Clinic PEP is not fully up to date with the state<br>
of the implementation."  It does not look like this situation has<br>
improved since.<br></blockquote><div><br></div><div>I always read <a href="https://docs.python.org/3/howto/clinic.html">https://docs.python.org/3/howto/clinic.html</a> as the documentation and not the PEP.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
The practical question is: does it make sense to invest time in<br>
learning the clinic DSL and converting more modules (e.g. datetime) to<br>
it</blockquote><div><br></div><div>Yes. Part of the issue is there was a big push to convert modules for the 3.4 release and some of us helped convert however many we can, but then people stopped putting the time in to convert code a module at a time once 3.4 was released. Serhiy has actually been working on a patch to speed up keyword parsing which will automatically be applied to code using Argument Clinic: <a href="http://bugs.python.org/issue27574">http://bugs.python.org/issue27574</a> .</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> or it is likely that the whole approach will be revised in the<br>
future?<br>
<br></blockquote><div><br></div><div>I don't see it being revised, but maybe Larry has something to say on the matter.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
[1] <a href="http://bugs.python.org/issue16612" rel="noreferrer" target="_blank">http://bugs.python.org/issue16612</a><br>
[2] <a href="https://docs.python.org/3.6/whatsnew/3.4.html?highlight=clinic#pep-436-argument-clinic" rel="noreferrer" target="_blank">https://docs.python.org/3.6/whatsnew/3.4.html?highlight=clinic#pep-436-argument-clinic</a><br>
_______________________________________________<br>
Python-Dev mailing list<br>
<a href="mailto:Python-Dev@python.org" target="_blank">Python-Dev@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-dev" rel="noreferrer" target="_blank">https://mail.python.org/mailman/listinfo/python-dev</a><br>
Unsubscribe: <a href="https://mail.python.org/mailman/options/python-dev/brett%40python.org" rel="noreferrer" target="_blank">https://mail.python.org/mailman/options/python-dev/brett%40python.org</a><br>
</blockquote></div></div>