Dear python developpers,
First I'd like to thank you for your work, you're making the world simple !
Then I would like to share a very light suggestion for the improvement of python, I hope I am using the right way for this.
(I am using python 3.4.3)
I am from the science side, more precisely physics, and I often have to display or log formatted numbers during computations.
Usually I have numbers with many digits and it is necessary for me to use the right format for display (for setting the number of digits after coma, for using exponent notation, etc...) I was using the way of the "%" until I found the __builtins__.format function.
But I still cannot remember all the letters for the possible options, such as presented in the part named "7.1.3.1. Format Specification Mini-Language" of this page :
And each time I need to remind of the mini-language, I need to open a web-page or a file and it is breaking my workflow.
So I think it would be helpful that the "format.__doc__" string would contains a quick example showing the way to set the number of digits, the appearance conditions of the signs as well as a quick reminder of the "Mini-language" types.
I have made a template of the docstring to begin with, that I send as an attached file, but I am not familiar with docstring format.
Also, there is maybe more material to add to the docstring that will be likely to help other people the same way.
I hope you like the idea,
Yours sincerely,
Hugo Prod'homme.