NiklasRosenstein / python-docspec

Docspec is a JSON object specification for representing API documentation of programming languages.
https://niklasrosenstein.github.io/python-docspec/
Other
16 stars 6 forks source link

improvement: Explicitly do not support tuple-upackings as it is unclear how to assign the associated docstring and value. #87

Closed NiklasRosenstein closed 1 year ago

NiklasRosenstein commented 1 year ago

@nrser This is in response to your comment in the code. While this section isn't particularly pretty (is any of the docspec code, really? 💦), I think it unreasonable to try and handle the tuple-unpacking scenario in any way because any semantics we assign will be inaccurate in the current way Docspec represents variable assignments.

This change should clear up what names can be though.