Systematically extract class, method and function signatures in python

03-09-2025

• https://github.com/openai/openai-agents-python/blob/9e01cf749ddbfc130e9ac78f7ea3a8fd173ca5e0/src/agents/function_schema.py

• https://mkdocstrings.github.io/griffe/guide/users/loading/

• https://github.com/fastapi/fastapi/blob/master/fastapi/exceptions.py

• define object signatures (for classes, methods, and functions), including:

  • docstrings (summary and examples)
  • input parameters (names, type hints, defaults, descriptions, using annotated types)
  • return type (type hints, using annotated types)

• generate string representation of the object call / usage

• parse and execute the string representation using the ast module