What are __signature__ and __text_signature__ used for in Python 3.4

by

These attributes are there to enable introspection for Python objects defined in C code. The C-API Argument Clinic provides the data, to assist the inspect module when building Signature objects. Introspection of C-API functions was not supported before.

See the internal inspect._signature_fromstr() function on how the __text_signature__ value is used.

Currently, the __text_signature__ attribute is filled from the internal docstring set on objects in the C-API; a simple text search is done for objectname(...)\n--\n\n, where the \n--\n\n is typical of Attribute Clinic-generated documentation strings. Take a look at the type object slots if you wanted to find some examples. Or you could look at the audioop module source to see how the Argument Clinic is being used to define signatures; the Argument Clinic script is run on those when building to generate the docstrings (in the accompanying audioop.c.h file).

The __signature__ attribute, if present, would be a inspect.Signature() object; instead of providing a text version a C-API can provide a fully parsed Signature instance instead.

More Related Contents:

  1. Why is one class variable not defined in list comprehension but another is?
  2. Why is “1000000000000000 in range(1000000000000001)” so fast in Python 3?
  3. Why is the order in dictionaries and sets arbitrary?
  4. Usage of __slots__?
  5. Python string interning
  6. About the changing id of an immutable string
  7. How could I use requests in asyncio?
  8. What exactly is contained within a obj.__closure__?
  9. Python eval: is it still dangerous if I disable builtins and attribute access?
  10. What does “del” do exactly?
  11. Why is True returned when checking if an empty string is in another?
  12. How can I use functools.singledispatch with instance methods?
  13. Python 3.4.0 with MySQL database
  14. How to install PyGame on Python 3.4?
  15. How references to variables are resolved in Python [duplicate]
  16. Why is variable1 += variable2 much faster than variable1 = variable1 + variable2?
  17. Identifier normalization: Why is the micro sign converted into the Greek letter mu?
  18. Getting value of enum on string conversion
  19. Why is a class __dict__ a mappingproxy?
  20. urllib HTTPS request:
  21. Using a function defined in an exec’ed string in Python 3 [duplicate]
  22. How to install PyGame on Python?
  23. How is unicode represented internally in Python?
  24. Why do ints require three times as much memory in Python?
  25. Are list comprehensions syntactic sugar for `list(generator expression)` in Python 3?
  26. No module named ‘openpyxl’ – Python 3.4 – Ubuntu
  27. Python frozenset hashing algorithm / implementation
  28. Why does a set display in same order if sets are unordered?
  29. Python doesn’t find MagickWand Libraries (despite correct location?)
  30. Python3 project remove __pycache__ folders and .pyc files

Leave a Comment