Should helputils._UsageStringFromFullArgSpec show PEP 484 Type Hints if Available? about python-fire HOT 4 OPEN

Good idea.

I agree that annotations should be shown in the help information, when available. We should consider the design of this in conjunction with larger changes to the usage strings. I expect we'll want to show the type annotations separately from the "Usage" section, in order to 1. Keep the usage section clean, and 2. support non-type annotations.

As an example of other changes to help information that we want: When showing the usage info for an object, we should probably separate its callable properties from its noncallable ones visually, possibly showing usage information for its callable members, and maybe the members' docstrings too.

from python-fire.

Yeah you're right, they shouldn't be in the usage section, in that case I think just printing inspect.signature(func) would be a pretty good solution, that would look like this. Is this what you're thinking? Or do you have better design in mind?

Type:        function
String form: <function greeting at 0x00235738>
File:        c:\users\admin\desktop\test.py
Line:        4
Signature:   (name:str, age:int) -> str

Usage:       test.py NAME AGE
             test.py --name NAME --age AGE

from python-fire.

That looks nice. Not sure how that will look with more complex annotations. I'll have to play around with it some once I'm at a computer.

If it gets messy, we could consider something like only showing the Signature a) if we're in verbose mode or b) if it doesn't have any non-type annotations.

from python-fire.

@keatinge I'm interested in exactly the case you described. Did you find a way to directly use annotations? (I see fire still doesn't support it, but are there other utilities that do?)

from python-fire.