]> granicus.if.org Git - python/commitdiff
Mention PEP 362: Function Signature Object in whatsnew.
authorAndrew Svetlov <andrew.svetlov@gmail.com>
Mon, 13 Aug 2012 18:27:56 +0000 (21:27 +0300)
committerAndrew Svetlov <andrew.svetlov@gmail.com>
Mon, 13 Aug 2012 18:27:56 +0000 (21:27 +0300)
Doc/whatsnew/3.3.rst

index 17f8fde3cf46276ccf0f34eaa0f7f84f30abf3f2..7cc439b99a85f9f020e7fa71f35a95b2989206e8 100644 (file)
@@ -501,6 +501,23 @@ which stores the keys and their respective hashes).  This reduces the memory
 consumption of programs creating many instances of non-builtin types.
 
 
+PEP 362: Function Signature Object
+==================================
+
+:pep:`362`: -  Function Signature Object
+ PEP written by Brett Cannon, Yury Selivanov, Larry Hastings, Jiwon Seo.
+ Implemented by Yury Selivanov.
+
+A new function :func:`inspect.signature` makes introspection of python
+callables easy and straightforward.  A broad range of callables is supported:
+python functions, decorated or not, classes, and :func:`functools.partial`
+objects.  New classes :class:`inspect.Signature`, :class:`inspect.Parameter`
+and :class:`inspect.BoundArguments` hold information about the call signatures,
+such as, annotations, default values, parameters kinds, and bound arguments,
+which considerably simplifies writing decorators and any code that validates
+or amends calling signatures or arguments.
+
+
 Using importlib as the Implementation of Import
 ===============================================
 :issue:`2377` - Replace __import__ w/ importlib.__import__